spb/satelliteindex
Public
TypeScript 66.5%
Python 30.9%
JavaScript 1.4%
CSS 0.7%
1# SatelliteIndex.io23**The world's orbital infrastructure, mapped and indexed.** A public intelligence layer for everything in Earth orbit: satellites,4constellations, operators, countries, launches, debris and reentries — with live SGP4 positions, orbital history, derived analytics5and transparent sources. Live at https://www.satelliteindex.io.67- **Backend** (`src/satelliteindex`): Python 3.12 · FastAPI · PostgreSQL 17 · Redis · python-sgp4 · APScheduler. Connector framework with8 raw-snapshot preservation, content hashing, circuit breakers, entity resolution (prefixed ULIDs; NORAD/COSPAR are source ids),9 append-only orbital history, field provenance, derived analytics (materialized views, stats snapshots, search index, events).10- **Frontend** (`apps/web`): Next 16 · React 19 · Tailwind v4 · React Three Fiber globe (GPU point cloud, 16 k+ objects) · SVG charts & maps.11- **Sources (v0.1)**: CelesTrak GP element sets (OMM JSON, every 2 h), CelesTrak thematic groups, CelesTrak SATCAT (daily).12 Planned: Space-Track, GCAT, UNOOSA, ESA DISCOS, regulators (FCC/ITU/ISED/Ofcom/ARCEP), company monitoring.1314## Quick start1516```bash17uv venv --python 3.12 .venv && uv pip install --python .venv/bin/python -e ".[dev]"18cp .env.example .env # DATABASE_URL=postgresql+asyncpg://localhost:5432/satelliteindex, REDIS_URL=redis://127.0.0.1:6379/419createdb satelliteindex20.venv/bin/si migrate && .venv/bin/si seed21make ingest # SATCAT (~70 k objects) → GP (~16 k element sets) → groups → analytics22.venv/bin/si api # http://127.0.0.1:8311/api/v1/docs23pnpm install && pnpm dev:web # http://localhost:831024pytest -q25```2627Docs: `CLAUDE.md` (project rules), `docs/FRONTEND-GUIDE.md`, `docs/DEPLOY.md`, `docs/API.md`, `/methodology` on the site.2829## Attribution & disclaimer3031Orbital data courtesy of CelesTrak (Dr. T.S. Kelso). SatelliteIndex.io is an informational platform: positions, predictions and32derived metrics may contain delays or uncertainty and must not be used as the sole source for safety-critical, navigation,33mission-control, military or operational decisions.3435© 2026 Simon-Pierre Boucher · contact@spboucher.ai · hosted on [MacLustr](https://www.maclustr.io).36