SPB Git forge
3commits 1branches 0releases
417.0 KBsize
maindefault branch
10 days agolast push
TypeScript 66.5% Python 30.9% JavaScript 1.4% CSS 0.7%
2.2 KB · 36 lines markdown
Rendered Raw Blame History
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