How umesh-369/skygaurd-ai works
SkyGuard AI monitors automatic weather-station telemetry, detects sensor faults and communications failures, estimates corrections, and assesses regional hazards. Its main workflow runs through a React dashboard and FastAPI backend: simulated or station readings are evaluated, anomalies may be imputed and recorded, and risk context is broadcast to the interface. The README also documents historical-data replay, spatial consensus, degradation monitoring, reports, and operational recommendations. Several of those subsystems are present in the tree but were not sampled, so their links are shown as unverified rather than inferred calls.
Main entry points: main.py FastAPI Application · App.tsx Web App · useSkyGuardStore.ts UI State and API · simulator.py Simulator Routes
Components 27
Dashboard
- Web App
frontend/src/App.tsx - UI State and API
frontend/src/store/useSkyGuardStore.ts - Dashboard and Analytics
frontend/src/pages/DashboardPage.tsx - Anomaly Views
frontend/src/pages/AnomaliesPage.tsx - Fault Simulator UI
frontend/src/components/SimulatorStudio.tsx
Telemetry Runtime
- FastAPI Application
backend/main.py - Simulator Routes
backend/api/routers/simulator.py - AWS Simulator Service
backend/simulator/simulator_service.py - Virtual Station Mesh
simulator/aws_simulator.py - Communications Monitor
backend/telemetry/comm_monitor.py - WebSocket Broadcast
backend/api/websocket/ws_manager.py
Sensor Diagnostics
- Tier 1 Detector
backend/anomaly_detection/detector_service.py - Isolation Forest
ml/anomaly_detector.py - Feature Extraction
ml/feature_extractor.py - SHAP Explanations
backend/explainability/shap_service.py - Value Imputation
backend/explainability/imputer_service.py - Spatial Consensus
backend/risk_engine/spatial_consensus.py - Degradation Watchdog
backend/explainability/degradation_service.py
Hazards and Response
- Incident Lifecycle
backend/incidents/incident_service.py - Tier 2 Hazard Risk
backend/risk_engine/tier2_risk.py - Weather Context
backend/integrations/weather/weather_service.py - Response Recommendations
backend/recommendations/recommendation_service.py - Incident Reports
backend/reports/report_service.py
State and Integrations
- MongoDB Repositories
backend/database/repositories - Historical Climate Data
ml/data_loader.py - Climate Replay Adapter
backend/integrations/datasets/data_loader_adapter.py
Other components
- Operator
Connections 26
- Operator → Web App: uses
- Web App → UI State and API: loads and connects
frontend/src/App.tsx - Web App → Dashboard and Analytics: renders
frontend/src/App.tsx - Web App → Anomaly Views: renders
frontend/src/App.tsx - Web App → Fault Simulator UI: renders
- UI State and API → FastAPI Application: requests data
frontend/src/store/useSkyGuardStore.ts - FastAPI Application → Simulator Routes: mounts routers
backend/main.py - Simulator Routes → AWS Simulator Service: dispatches
backend/api/routers/simulator.py - AWS Simulator Service → Virtual Station Mesh: delegates simulation
backend/simulator/simulator_service.py - FastAPI Application → Tier 1 Detector: evaluates readings
backend/main.py - Tier 1 Detector → Isolation Forest: delegates inference
backend/anomaly_detection/detector_service.py - Isolation Forest → Feature Extraction: uses features
ml/anomaly_detector.py - FastAPI Application → Value Imputation: requests correction
backend/main.py - FastAPI Application → Incident Lifecycle: records anomalies
backend/main.py - FastAPI Application → Tier 2 Hazard Risk: calculates risk
backend/main.py - FastAPI Application → Weather Context: fetches context
backend/main.py - FastAPI Application → WebSocket Broadcast: broadcasts updates
- FastAPI Application → Communications Monitor: monitors telemetry
backend/main.py - FastAPI Application → SHAP Explanations: explains detections
backend/main.py - FastAPI Application → Spatial Consensus: checks neighbors
- FastAPI Application → Degradation Watchdog: monitors sensor health
- Incident Lifecycle → MongoDB Repositories: persists anomalies
backend/incidents/incident_service.py - FastAPI Application → Response Recommendations: creates response actions
- FastAPI Application → Incident Reports: serves reports
- Historical Climate Data → Climate Replay Adapter: supplies climate records
- UI State and API → WebSocket Broadcast: receives live events