AIAtlas

The open, real-time map of the AI ecosystem.

A community-maintained directory of every AI model, tool, API, and GitHub repo — with live pricing, benchmarks, and community reviews.

Live Demo · Report a Bug · Request a Feature

---

What is AIAtlas?

AIAtlas is an open-source, community-driven directory that tracks the AI ecosystem in real time. Anyone can sign in with GitHub and contribute — add a new model, update pricing, or leave a review. Changes are reflected live across all connected clients via Supabase Realtime.

Why it exists: The AI landscape moves faster than any single team can track. AIAtlas is built on the premise that the community, collectively, is always faster.

---

Features

Feature	Status
Model leaderboard — sortable by benchmark, price, speed, context	✅ Live
Model detail pages — specs, benchmarks, pricing, modalities	✅ Live
Table & card view toggle	✅ Live
Filter by provider, modality, license, open-source	✅ Live
Live activity feed — Supabase Realtime	✅ Live
Dark / light mode with persistence	✅ Live
GitHub OAuth sign-in	✅ Live
Community contribution form	✅ Live
Community reviews with star ratings	✅ Live
Mobile-responsive navbar	✅ Live
Tools directory	🔜 v2
Repos directory with GitHub sync	🔜 v2
⌘K search command palette	🔜 v2
User profile pages	🔜 v2

---

Tech Stack

Layer	Technology
Framework	Next.js 14 (App Router)
Language	TypeScript 5
Styling	Tailwind CSS + custom design system
Database	Supabase (PostgreSQL)
Realtime	Supabase Realtime (postgres_changes)
ORM	Prisma
Auth	NextAuth.js + GitHub OAuth
Fonts	Geist (Sans + Mono)
Deployment	Vercel

---

Getting Started

Prerequisites

• Node.js 18+
• A Supabase project (free tier works)
• A GitHub OAuth App

1. Clone and install

git clone https://github.com/your-org/aiatlas.git
cd aiatlas
npm install

2. Configure environment variables

cp .env.example .env

Open .env and fill in your credentials:

# Supabase — from your project's API settings
NEXT_PUBLIC_SUPABASE_URL=https://your-project.supabase.co
NEXT_PUBLIC_SUPABASE_ANON_KEY=your_anon_key
SUPABASE_SERVICE_ROLE_KEY=your_service_role_key

# Database — from Supabase → Settings → Database → Connection string
# Use the transaction-mode pooler URL for DATABASE_URL
DATABASE_URL=postgresql://postgres.[ref]:[password]@[host]:6543/postgres?pgbouncer=true
# Use the session-mode pooler URL for DIRECT_URL (migrations)
DIRECT_URL=postgresql://postgres.[ref]:[password]@[host]:5432/postgres

# GitHub OAuth — from github.com/settings/developers
GITHUB_CLIENT_ID=your_client_id
GITHUB_CLIENT_SECRET=your_client_secret

# NextAuth
NEXTAUTH_SECRET=run: openssl rand -base64 32
NEXTAUTH_URL=http://localhost:3000

3. Set up the database

# Generate Prisma client
npx prisma generate

# Run migrations (creates all tables)
npx prisma migrate dev --name init

# Seed with initial model data
npx prisma db seed

4. Enable Supabase Realtime

In your Supabase dashboard:

1. Go to Database → Replication
2. Enable replication for the feed_events table
3. Enable replication for the models table

5. Configure GitHub OAuth callback

In your GitHub OAuth App settings, set:

Authorization callback URL: http://localhost:3000/api/auth/callback/github

6. Run the dev server

npm run dev

Open http://localhost:3000.

Note: The app runs fully on mock data without any credentials configured. Set up .env to enable database persistence, auth, and realtime features.

---

Project Structure

aiatlas/
├── prisma/
│   ├── schema.prisma        # Database schema (11 models)
│   └── seed.ts              # Initial data (16 models, 8 providers)
├── src/
│   ├── app/
│   │   ├── api/             # API routes (models, feed, reviews, auth)
│   │   ├── auth/signin/     # GitHub OAuth sign-in page
│   │   ├── contribute/      # Contribution form page
│   │   ├── feed/            # Live activity feed page
│   │   ├── models/          # Models directory + detail pages
│   │   ├── repos/           # Repos directory (v2)
│   │   └── tools/           # Tools directory (v2)
│   ├── components/
│   │   ├── contribute/      # ContributeForm
│   │   ├── feed/            # FeedTicker
│   │   ├── layout/          # Navbar, Footer
│   │   ├── models/          # ModelTable, ModelCard, ModelFilters, ReviewSection
│   │   └── providers/       # SessionProvider, ThemeProvider
│   ├── hooks/
│   │   └── useLiveFeed.ts   # Realtime feed hook
│   ├── lib/
│   │   ├── mock-data.ts     # Fallback data (used when DB not connected)
│   │   ├── prisma.ts        # Prisma client singleton
│   │   ├── realtime.ts      # Supabase Realtime subscriptions
│   │   ├── supabase.ts      # Supabase client (browser + server)
│   │   └── utils.ts         # Formatters, helpers
│   └── types/
│       └── index.ts         # TypeScript interfaces
└── .env.example             # Environment variable template

---

API Reference

Method	Endpoint	Description
GET	/api/models	List models. Supports ?search, ?provider, ?license, ?modality, ?sort, ?limit, ?offset
GET	/api/models/[slug]	Get a single model by slug
POST	/api/models	Submit a new model (auth required)
GET	/api/feed	Get recent feed events. Supports ?limit
POST	/api/reviews	Submit a review (auth required)

---

Deployment

Deploy to Vercel

1. Connect your GitHub repo to Vercel
2. Add all environment variables from .env.example in the Vercel dashboard
3. Update NEXTAUTH_URL to your production domain
4. Update your GitHub OAuth App callback URL to https://yourdomain.com/api/auth/callback/github
5. Deploy

Vercel automatically runs prisma generate via the build command. Make sure your package.json build script includes it, or add a postinstall script:

"scripts": {
  "postinstall": "prisma generate",
  "build": "next build"
}

---

Contributing

We welcome contributions of all kinds — new models, bug fixes, features, and documentation improvements.

See CONTRIBUTING.md for the full guide.

Quick start:

git checkout -b feat/your-feature
# make changes
npm run build   # must pass
git push origin feat/your-feature
# open a pull request

---

License

MIT — free to use, modify, and distribute.

---

Built with ❤️ by the community · Star us on GitHub