https://github.com/mizcausevic-dev/orbitforge
Governance and provenance control plane for satellite and orbital-agent swarms handling debris, comms, and autonomous space operations.
https://github.com/mizcausevic-dev/orbitforge
aerospace autonomous-systems conjunction-risk control-plane fastapi orbital-agents provenance python satellite-governance space-operations swarm-governance
Last synced: 11 days ago
JSON representation
Governance and provenance control plane for satellite and orbital-agent swarms handling debris, comms, and autonomous space operations.
- Host: GitHub
- URL: https://github.com/mizcausevic-dev/orbitforge
- Owner: mizcausevic-dev
- Created: 2026-05-12T18:57:24.000Z (about 1 month ago)
- Default Branch: main
- Last Pushed: 2026-05-12T21:41:13.000Z (about 1 month ago)
- Last Synced: 2026-05-12T23:13:51.951Z (about 1 month ago)
- Topics: aerospace, autonomous-systems, conjunction-risk, control-plane, fastapi, orbital-agents, provenance, python, satellite-governance, space-operations, swarm-governance
- Language: HTML
- Homepage: https://kineticgain.com/
- Size: 633 KB
- Stars: 0
- Watchers: 0
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
Awesome Lists containing this project
README
# OrbitForge
OrbitForge is a governance and provenance control plane for satellite and orbital-agent swarms managing debris, comms, and autonomous space operations.
## Why this repo is good
- It tackles a very real future problem: autonomous orbital systems need governance, replayable provenance, and maneuver accountability.
- It keeps the story concrete with conjunction alerts, maneuver authority, crosslink health, and handoff chains.
- It gives you another flagship that feels ambitious but still operationally believable.
## What it does
- Scores orbital assets for governance risk using conjunction distance, fuel margin, crosslink health, override readiness, and event history.
- Tracks orbital events with policy triggers, handoff chains, maneuver authority, and provenance scores.
- Separates clear, watch, and contain states for mission supervision.
- Exposes a clean API plus operator-facing proof surfaces for orbital command, event replay, and incident review.
## Proof
## Local run
```powershell
cd orbitforge
py -3.11 -m venv .venv
.\.venv\Scripts\pip.exe install -r requirements.txt
.\.venv\Scripts\python.exe -m app.main
```
Open:
- `http://127.0.0.1:4846/`
- `http://127.0.0.1:4846/event-replay`
- `http://127.0.0.1:4846/incident-board`
- `http://127.0.0.1:4846/docs`
## Validation
```powershell
.\.venv\Scripts\python.exe -m unittest discover -s tests
.\.venv\Scripts\python.exe scripts\run_demo.py
.\.venv\Scripts\python.exe scripts\smoke_check.py
.\.venv\Scripts\python.exe scripts\render_readme_assets.py
```
## API shape
Endpoints:
- `/api/dashboard/summary`
- `/api/assets`
- `/api/events`
- `/api/assets/{asset_id}`
- `/api/events/{event_id}`
- `/api/sample`
## Repo layout
```text
app/
data/
services/
docs/
scripts/
screenshots/
tests/
```