How siddeshkhandekar/praleye-ai-powered-disaster-intelligence-anticipate.-coordinate.-rescue. works
Praleye is a disaster-intelligence and tactical command platform. Operators use the map-first HUD and dashboards to retrieve hazard grids, OSINT reports, hospital and shelter data, then invoke response actions such as bed assignment, CAP alerts, force dispatch and SITREP generation. Its backend separates telemetry ingestion, hazard/OSINT analysis, and response services, with SQLite-backed state and a local AI integration. README capabilities include dam-cascade simulation, evacuation routing and multilingual alerts. Arrows follow shown calls, imports, API requests or README-described relationships; some unsampled subsystems are linked only where documented.
Main entry points: main.py FastAPI entry · App.tsx HUD application · apiClient.ts API client · router.py Hazard predictions
Components 34
Command interface
- HUD application
frontend/src/App.tsx - Tactical map
frontend/src/components/map/TacticalMapCanvas.tsx - HUD controls
frontend/src/components/hud/TopFilterSearchBar.tsx - Depth inspector
frontend/src/components/hud/RightDepthInspector.tsx - Role dashboards
frontend/src/components/dashboards - Response modals
frontend/src/components/modals - UI state
frontend/src/store/usePraleyeStore.ts - API client
frontend/src/services/apiClient.ts
Intelligence inputs
- Weather ingestion
backend/modules/weather_ingestion/router.py - Open-Meteo client
backend/modules/weather_ingestion/open_meteo_client.py - Other telemetry feeds
backend/modules/weather_ingestion - OSINT harvesting
backend/modules/osint_scraper/social_harvester.py
Analysis services
- Geo-NER locator
backend/modules/osint_scraper/geo_ner_locator.py - SOS classifier
backend/modules/osint_scraper/sos_classifier.py - Claim verifier
backend/modules/osint_scraper/telemetry_verifier.py - Hazard predictions
backend/modules/prediction_engine/router.py - Hazard models
backend/modules/prediction_engine/hazard_calculator.py - Dam simulation
backend/modules/prediction_engine/dam_cascade_simulator.py - Safe-zone routing
backend/modules/prediction_engine/safe_zone_locator.py
Response operations
- Hospital triage
backend/modules/medical_triage/router.py - Bed allocator
backend/modules/medical_triage/auto_bed_allocator.py - Alert communications
backend/modules/alert_comms/router.py - Alert translations
backend/modules/alert_comms/multilingual_engine.py - CAP generation
backend/modules/alert_comms/cap_xml_generator.py - Offline beacon
backend/modules/alert_comms/offline_beacon.py - SITREP service
backend/modules/local_llm/router.py - Local LLM client
backend/modules/local_llm/ollama_client.py - Command data APIs
backend/modules/command_dashboards/router.py
Platform services
- FastAPI entry
backend/main.py - SQLite database
backend/core/database.py - TTL cache
backend/core/cache.py - Telemetry WebSocket
backend/core/websocket_manager.py
Other components
- Command operators
- Telemetry providers
Connections 48
- Command operators → HUD application: uses
- HUD application → Tactical map: renders
frontend/src/App.tsx - HUD application → HUD controls: renders
frontend/src/App.tsx - HUD application → Depth inspector: renders
frontend/src/App.tsx - HUD application → Role dashboards: renders
frontend/src/App.tsx - HUD application → Response modals: renders
frontend/src/App.tsx - HUD application → API client: loads data
frontend/src/App.tsx - HUD application → UI state: updates state
frontend/src/App.tsx - Tactical map → UI state: reads state
frontend/src/components/map/TacticalMapCanvas.tsx - HUD controls → UI state: updates state
frontend/src/components/hud/TopFilterSearchBar.tsx - Depth inspector → API client: requests actions
frontend/src/components/hud/RightDepthInspector.tsx - API client → Hazard predictions: fetches grid
frontend/src/services/apiClient.ts - API client → OSINT harvesting: fetches feed
frontend/src/services/apiClient.ts - API client → Hospital triage: assigns beds
frontend/src/services/apiClient.ts - API client → SITREP service: requests SITREP
frontend/src/services/apiClient.ts - API client → Alert communications: broadcasts CAP
frontend/src/services/apiClient.ts - API client → Command data APIs: requests dispatch
frontend/src/services/apiClient.ts - FastAPI entry → Weather ingestion: mounts router
backend/main.py - FastAPI entry → Hazard predictions: mounts router
backend/main.py - FastAPI entry → OSINT harvesting: mounts router
backend/main.py - FastAPI entry → Hospital triage: mounts router
backend/main.py - FastAPI entry → Alert communications: mounts router
backend/main.py - FastAPI entry → Command data APIs: mounts router
backend/main.py - FastAPI entry → SITREP service: mounts router
backend/main.py - FastAPI entry → SQLite database: initializes
backend/main.py - FastAPI entry → Telemetry WebSocket: handles socket
backend/main.py - Weather ingestion → Open-Meteo client: calls
backend/modules/weather_ingestion/router.py - Weather ingestion → Other telemetry feeds: calls
backend/modules/weather_ingestion/router.py - Open-Meteo client → Telemetry providers: fetches weather
backend/modules/weather_ingestion/open_meteo_client.py - Open-Meteo client → TTL cache: uses cache
backend/modules/weather_ingestion/open_meteo_client.py - Hazard predictions → SQLite database: reads districts
backend/modules/prediction_engine/router.py - Hazard predictions → Open-Meteo client: fetches telemetry
backend/modules/prediction_engine/router.py - Hazard predictions → Hazard models: calculates risk
backend/modules/prediction_engine/router.py - Hazard predictions → Dam simulation: simulates cascade
backend/modules/prediction_engine/router.py - Hazard predictions → Safe-zone routing: routes evacuation
backend/modules/prediction_engine/router.py - OSINT harvesting → Geo-NER locator: extracts location
backend/modules/osint_scraper/social_harvester.py - OSINT harvesting → SOS classifier: scores urgency
backend/modules/osint_scraper/social_harvester.py - OSINT harvesting → Claim verifier: verifies claims
backend/modules/osint_scraper/social_harvester.py - Hospital triage → SQLite database: reads hospitals
backend/modules/medical_triage/router.py - Hospital triage → Bed allocator: allocates beds
backend/modules/medical_triage/router.py - Bed allocator → Safe-zone routing: uses routing
backend/modules/medical_triage/auto_bed_allocator.py - Alert communications → Alert translations: translates alert
backend/modules/alert_comms/router.py - Alert communications → CAP generation: generates CAP
backend/modules/alert_comms/router.py - Alert communications → Offline beacon: signals offline
backend/modules/alert_comms/router.py - SITREP service → SQLite database: reads context
backend/modules/local_llm/router.py - SITREP service → Local LLM client: generates report
backend/modules/local_llm/router.py - Local LLM client → Telemetry providers: calls Ollama
- Command data APIs → SQLite database: reads command data
backend/modules/command_dashboards/router.py