# SatelliteIndex.io

**The world's orbital infrastructure, mapped and indexed.** A public intelligence layer for everything in Earth orbit: satellites,
constellations, operators, countries, launches, debris and reentries — with live SGP4 positions, orbital history, derived analytics
and transparent sources. Live at https://www.satelliteindex.io.

- **Backend** (`src/satelliteindex`): Python 3.12 · FastAPI · PostgreSQL 17 · Redis · python-sgp4 · APScheduler. Connector framework with
  raw-snapshot preservation, content hashing, circuit breakers, entity resolution (prefixed ULIDs; NORAD/COSPAR are source ids),
  append-only orbital history, field provenance, derived analytics (materialized views, stats snapshots, search index, events).
- **Frontend** (`apps/web`): Next 16 · React 19 · Tailwind v4 · React Three Fiber globe (GPU point cloud, 16 k+ objects) · SVG charts & maps.
- **Sources (v0.1)**: CelesTrak GP element sets (OMM JSON, every 2 h), CelesTrak thematic groups, CelesTrak SATCAT (daily).
  Planned: Space-Track, GCAT, UNOOSA, ESA DISCOS, regulators (FCC/ITU/ISED/Ofcom/ARCEP), company monitoring.

## Quick start

```bash
uv venv --python 3.12 .venv && uv pip install --python .venv/bin/python -e ".[dev]"
cp .env.example .env                       # DATABASE_URL=postgresql+asyncpg://localhost:5432/satelliteindex, REDIS_URL=redis://127.0.0.1:6379/4
createdb satelliteindex
.venv/bin/si migrate && .venv/bin/si seed
make ingest                                # SATCAT (~70 k objects) → GP (~16 k element sets) → groups → analytics
.venv/bin/si api                           # http://127.0.0.1:8311/api/v1/docs
pnpm install && pnpm dev:web               # http://localhost:8310
pytest -q
```

Docs: `CLAUDE.md` (project rules), `docs/FRONTEND-GUIDE.md`, `docs/DEPLOY.md`, `docs/API.md`, `/methodology` on the site.

## Attribution & disclaimer

Orbital data courtesy of CelesTrak (Dr. T.S. Kelso). SatelliteIndex.io is an informational platform: positions, predictions and
derived metrics may contain delays or uncertainty and must not be used as the sole source for safety-critical, navigation,
mission-control, military or operational decisions.

© 2026 Simon-Pierre Boucher · contact@spboucher.ai · hosted on [MacLustr](https://www.maclustr.io).