How f1ni/oxhack2026 works
Rescue AI is a search-and-rescue mission simulator with a browser UI and FastAPI backend. The main workflow is to configure an area and search scenario, create a mission and probability heatmap, then advance drone scans while inspecting the map and mission status. Backend stages include geography and walking-route data, movement/route priors, mission orchestration, and optional camera detection. The tree also contains a separate dataset-reference implementation. Some links reflect documented capabilities; unsampled modules are not treated as inspected.
Main entry points: engine.py Mission engine · routes.py Route prior · MissionDemo.tsx Mission workflow · SearchMap.tsx Search map
Components 22
Mission UI
- Mission workflow
frontend/src/features/mission/MissionDemo.tsx - Scenario setup
frontend/src/features/mission/ScenarioForm.tsx - API client
frontend/src/api/client.ts - Search grid
frontend/src/components/SearchGrid.tsx - Search map
frontend/src/components/SearchMap.tsx - Cell inspector
frontend/src/components/CellInspector.tsx - Drone overlays
frontend/src/maps/fleet.ts
Simulation Backend
- Mission API
backend/app/api/routes.py - Mission engine
backend/app/simulation/engine.py - API contracts
backend/app/schemas/models.py - Search planning
backend/app/planning/adaptive.py - YOLO detector
backend/app/vision/yolo.py
Geography and Priors
- Geography providers
backend/app/geography/interfaces.py - Grid coordinates
backend/app/geography/coordinates.py - Walking router
backend/app/geography/routing.py - Route prior
backend/app/probability/routes.py - Movement prior
backend/app/probability/movement.py
Dataset Reference
- Reference API
backend/dataset_reference/api/__init__.py - Reference simulator
backend/dataset_reference/simulation/__init__.py - Historical priors
backend/dataset_reference/probability/priors.py - Reference terrain
backend/dataset_reference/geography/terrain.py
Other components
- Rescue operator
Connections 22
- Rescue operator → Mission workflow: configures mission
README.md - Mission workflow → Scenario setup: collects settings
- Mission workflow → API client: requests mission
- API client → Mission API: calls API
README.md - Mission API → Mission engine: creates mission
backend/app/api/routes.py - Mission API → Mission engine: advances mission
backend/app/api/routes.py - Mission engine → API contracts: uses contracts
backend/app/simulation/engine.py - Mission engine → Geography providers: loads geography
backend/app/simulation/engine.py - Mission engine → Search planning: requests plans
- Mission engine → YOLO detector: uses detection
backend/app/simulation/engine.py - Mission engine → Route prior: generates prior
- Route prior → Movement prior: uses baseline
backend/app/probability/routes.py - Route prior → Walking router: routes paths
backend/app/probability/routes.py - Route prior → Grid coordinates: resolves cells
backend/app/probability/routes.py - Walking router → Grid coordinates: maps cells
backend/app/geography/routing.py - Search grid → Search map: renders map
frontend/src/components/SearchGrid.tsx - Search grid → Cell inspector: renders inspector
frontend/src/components/SearchGrid.tsx - Search map → Cell inspector: renders inspector
frontend/src/components/SearchMap.tsx - Search map → Drone overlays: renders overlays
frontend/src/components/SearchMap.tsx - Reference API → Reference simulator: creates router
backend/dataset_reference/api/__init__.py - Reference simulator → Historical priors: uses priors
- Reference simulator → Reference terrain: loads terrain