README.md

---
title: Panacea Satellite Collision Avoidance API
colorFrom: indigo
colorTo: blue
sdk: docker
app_port: 7860
pinned: false
license: mit
---

# Panacea -- Satellite Collision Avoidance API

FastAPI backend for the Panacea satellite collision avoidance system.

## Endpoints

- `GET /api/health` -- Health check, lists loaded models
- `POST /api/predict-conjunction` -- Run inference on a CDM sequence
- `GET /api/model-comparison` -- Pre-computed model comparison results
- `GET /api/experiment-results` -- Staleness experiment results
- `POST /api/bulk-screen` -- Screen TLE pairs for potential conjunctions

## Models

Three models are loaded at startup from [DTanzillo/panacea-models](https://huggingface.co/DTanzillo/panacea-models):

1. **Baseline** -- Orbital shell density prior (AUC-PR: 0.061)
2. **XGBoost** -- Classical ML on engineered CDM features (AUC-PR: 0.988)
3. **PI-TFT** -- Physics-Informed Temporal Fusion Transformer (AUC-PR: 0.511)

Built for AIPI 540 (Duke University).