# 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

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.