SpaceTrackOps

SpaceTrackOps is a real-time satellite situational awareness platform that:

• ingests CelesTrak TLE feeds,
• propagates orbital positions with SGP4,
• detects close approaches (conjunctions),
• and provides optional AI-assisted risk insights.

🏆 Recognition

SpaceTrack-Ops was featured by the IIMCIP TIC on their official LinkedIn channel for its approach to identifying close-approach satellite events. Check out the feature here.

Requirements

• Python 3.11+
• Node.js 18+
• npm

Repository Structure

SpaceTrack-Ops/
├── backend/     # FastAPI backend, ingestion, propagation, detection, AI layer
├── frontend/    # Next.js dashboard with 3D globe UI
├── docs/        # Detailed project documentation
└── .env.example # Shared environment variable template

Quick Start

1) Configure environment

From repository root:

cp .env.example .env

Update .env values as needed (especially OPENROUTER_API_KEY for AI endpoints).

2) Run backend

cd backend
python -m venv venv
source venv/bin/activate   # Windows: venv\Scripts\activate
pip install fastapi "uvicorn[standard]" sgp4 numpy scipy requests apscheduler python-dotenv
uvicorn main:app --reload

Backend: http://127.0.0.1:8000

3) Run frontend

In a second terminal:

cd frontend
npm install
npm run dev

Frontend: http://localhost:3000

If needed, create frontend/.env.local manually with:

NEXT_PUBLIC_API_URL=http://127.0.0.1:8000

Key Features

• Parallel TLE ingestion from multiple CelesTrak groups
• SQLite-backed satellite and conjunction storage
• KD-tree optimized conjunction detection
• Cached batch position and proximity APIs
• Optional AI analysis and summaries via OpenRouter

API Overview

Method	Endpoint	Purpose
GET	/status	Service and scheduler status
POST	/fetch	Fetch/refresh satellite TLE data
GET	/satellites	Paginated satellite list with filters
GET	/positions/all	Current positions (cached)
POST	/detect	Run conjunction detection
GET	/conjunctions	Retrieve stored conjunction events
GET	/proximity	Nearest current satellite pairs
POST	/ai/analyze-conjunction	AI analysis for a single event
GET	/ai/summary	AI summary for top events

For the full reference, see:

• /home/runner/work/SpaceTrack-Ops/SpaceTrack-Ops/docs/API.md
• /home/runner/work/SpaceTrack-Ops/SpaceTrack-Ops/docs/ARCHITECTURE.md
• /home/runner/work/SpaceTrack-Ops/SpaceTrack-Ops/docs/SETUP.md

License

Private repository — all rights reserved.