# AI Atlas

**www.ai-atlas.co — Explore the entire AI ecosystem.**

AI Atlas is a continuously updated, historically versioned, machine-readable map of the global artificial intelligence ecosystem: models,
companies, research, providers and prices, benchmarks, hardware, frameworks, datasets, tools — connected in one temporal knowledge graph,
with provenance on every fact.

- **First-party connectors** read official pages, docs, feeds, model cards and public files directly. No commercial data API is required.
- **Raw historical archive**: every changed page is stored (content-addressed, compressed) and can be reprocessed when parsers improve.
- **Temporal knowledge graph**: claims carry `valid_from`/`valid_to`, prices and benchmark results are append-only, every change is an event.
- **Local LLM factory**: large-scale extraction runs on MacLustr's own inference servers through an engine-agnostic gateway.
- **Interfaces**: the website, the public API (`/api/v1`), and — later — datasets and alerts.

## Layout

```
registry/            curated YAML (sources, organizations, providers, benchmarks, hardware) — every entry cites its source
src/aiatlas/         Python platform: sdk/ (connector SDK), connectors/, services/ (jobs, scheduler, LLM gateway, search, quality), api/, cli.py
migrations/          forward-only SQL migrations
apps/web/            Next.js 16 website
tests/               pytest with saved fixtures
deploy/              MacLustr (mld) manifest and scripts
docs/                ARCHITECTURE.md · CONNECTORS.md · API.md · FRONTEND.md · DEPLOY.md
```

## Quick start

```bash
uv venv --python 3.12 .venv && uv pip install --python .venv/bin/python -e ".[dev]"
cp .env.example .env && createdb -O aiatlas aiatlas
.venv/bin/aia migrate && .venv/bin/aia seed
.venv/bin/aia crawl --priority 0            # initial corpus: labs, Hugging Face, arXiv, providers, benchmarks…
.venv/bin/aia api                           # http://127.0.0.1:8321/api/v1/docs
pnpm install && pnpm dev:web                # http://localhost:8320
```

© 2026 Simon-Pierre Boucher · contact@spboucher.ai · hosted on [MacLustr](https://www.maclustr.io). AI Atlas links to original sources and
never republishes documents in full; extracted facts are provided as-is with their provenance.