How shanu6224/vayunet works
VayuNet turns a device location into localized pollution-risk intelligence: satellite and weather observations inform risk scoring, possible downwind exposure, and priority verification. The PWA and Android clients present the result; Android also supports a periodic widget and push-triggered alerts. The README documents sensitive-site checks and Gemini explanations, while the sampled excerpts do not show every integration call, so those links are identified as documented or left unverified.
Main entry points: analysis.py Analysis Pipeline · main.py FastAPI · VayuFirebaseMessagingService.kt Push Handler · MainActivity.kt Android Companion
Components 19
User Clients
- PWA Dashboard
frontend/src/main.js - Android Companion
android/app/src/main/java/com/vayunet/app/MainActivity.kt
Risk Analysis
- FastAPI
backend/app/main.py - Analysis Pipeline
backend/app/services/analysis.py - Risk & Corridor
backend/app/services/risk_engine.py - Citizen Evidence
backend/app/services/citizen_service.py - Gemini Explanation
backend/app/services/gemini_service.py
Data Sources
- Sentinel-5P Data
backend/app/services/gee_service.py - Weather Data
backend/app/services/weather_service.py - Sensitive Sites
backend/app/services/places_service.py
Android Alerts
- Widget Provider
android/app/src/main/java/com/vayunet/app/VayuWidgetProvider.kt - Widget Worker
android/app/src/main/java/com/vayunet/app/VayuWidgetWorker.kt - Notification Helper
android/app/src/main/java/com/vayunet/app/NotificationHelper.kt - Push Handler
android/app/src/main/java/com/vayunet/app/VayuFirebaseMessagingService.kt
Other components
- Device User
- Google Earth Engine
- Open-Meteo
- OpenStreetMap
- Firebase Cloud Messaging
Connections 21
- Device User → PWA Dashboard: opens
README.md - Device User → Android Companion: uses
README.md - PWA Dashboard → FastAPI: requests analysis
frontend/src/main.js - Android Companion → FastAPI: requests analysis
android/app/src/main/java/com/vayunet/app/MainActivity.kt - FastAPI → Analysis Pipeline: dispatches analysis
backend/app/main.py - FastAPI → Citizen Evidence: records reports
backend/app/main.py - Analysis Pipeline → Sentinel-5P Data: fetches satellite data
backend/app/services/analysis.py - Analysis Pipeline → Weather Data: fetches weather
backend/app/services/analysis.py - Analysis Pipeline → Risk & Corridor: calculates risk
backend/app/services/analysis.py - Analysis Pipeline → Sensitive Sites: checks nearby sites
backend/app/services/analysis.py - Sentinel-5P Data → Google Earth Engine: queries imagery
README.md - Weather Data → Open-Meteo: fetches conditions
README.md - Sensitive Sites → OpenStreetMap: identifies sites
README.md - Analysis Pipeline → Gemini Explanation: requests explanation
README.md - Citizen Evidence → Gemini Explanation: assesses photos
- Widget Provider → Widget Worker: schedules refresh
android/app/src/main/java/com/vayunet/app/VayuWidgetProvider.kt - Widget Worker → FastAPI: requests analysis
android/app/src/main/java/com/vayunet/app/VayuWidgetWorker.kt - Push Handler → Firebase Cloud Messaging: receives push
android/app/src/main/java/com/vayunet/app/VayuFirebaseMessagingService.kt - Push Handler → Notification Helper: shows alert
android/app/src/main/java/com/vayunet/app/VayuFirebaseMessagingService.kt - Push Handler → Widget Worker: queues refresh
android/app/src/main/java/com/vayunet/app/VayuFirebaseMessagingService.kt - Notification Helper → Android Companion: opens activity
android/app/src/main/java/com/vayunet/app/NotificationHelper.kt