Odyssey

An unofficial Cosmos client. Two things:

• API — a simple Cosmos API for any profile or cluster, plus global search. Live at odyssey-hq.vercel.app. See apps/web.
• Mac app — a native macOS app to browse Cosmos from your desktop. It runs on the API. See apps/mac.

No auth, so public elements only.

Grab the Mac app from the latest release — open the DMG, drag to Applications, done. It's signed and notarized so it just opens. Needs macOS 26+.

odyssey/
├── apps/
│   ├── web/   # Next.js — the API + web frontend
│   └── mac/   # SwiftUI Mac app (runs on the API)
└── package.json   # npm workspaces

# All images from a profile
GET https://odyssey-hq.vercel.app/api/{username}

# Images from a cluster
GET https://odyssey-hq.vercel.app/api/{username}/{cluster}

# Search all of Cosmos
GET https://odyssey-hq.vercel.app/api/search?q={query}

curl https://odyssey-hq.vercel.app/api/traf/systems
# { "images": ["https://cdn.cosmos.so/...", ...], "count": 75 }

Full docs in apps/web.

Users don't need any of this — just download the app above. To hack on it:

npm install       # install web deps (workspaces)
npm run dev       # run the web app

cd apps/mac && swift run   # run the mac app

See each app's README for details.

An unofficial client for Cosmos. Not affiliated with or endorsed by Cosmos. All content and trademarks belong to their respective owners.