Documentation

Everything you need to run and contribute to Atlas.

Quick start

git clone https://github.com/pantha704/atlas.git

cd atlas

bun install

cp .env.example .env # fill in GROQ_API_KEY

bun dev

Environment variables

GROQ_API_KEY — Primary AI (free tier: 14k req/day)

GEMINI_API_KEY — AI fallback (free tier: 1.5k req/day)

GITHUB_CLIENT_ID / GITHUB_CLIENT_SECRET — OAuth

TURSO_DATABASE_URL / TURSO_AUTH_TOKEN — Database

BETTER_AUTH_SECRET — JWT signing (generate: openssl rand -base64 32)

RESEND_API_KEY — Email delivery (optional, free tier: 100/day)

Self-host guide

  1. Create a Turso database — sign up at turso.tech, create a database, copy the URL and auth token.
  2. Create a GitHub OAuth app — go to github.com/settings/developers, set callback URL to https://your-domain.com/api/auth/callback.
  3. Get a Groq API key — sign up at console.groq.com, create an API key (free tier: 14k req/day).
  4. Deploy to Cloudflare Workers — install wrangler: bun add -g wrangler, then wrangler deploy in apps/api.
  5. Set environment variables — use wrangler secret put for each secret.
  6. Run migrations — cd packages/db && bun run migrate.
  7. Deploy web — deploy apps/web to Cloudflare Pages, set PUBLIC_ATLAS_API_URL to your API Worker URL.

Total time: ~15 minutes. Total cost: $0 (all free tiers).

Source configuration

See Source Market for pre-configured sources, or configure custom sources in your sources page.

API reference

GET /health — Health check

GET /digest — Public global digest

POST /trigger — Trigger global pipeline

GET /my-digest — Per-user digest (auth)

GET /market — Source market listing

GET /rss/:token.xml — Per-user RSS feed

GET /share/:slug — Shared digest