GridWatch is a comprehensive city management system that monitors and displays real-time incidents across 5 different categories using AI agents. Built for the DevFestDC 25 Agentic AI Hackathon.

• Frontend: https://gridwatch.dev/
• Backend API: https://gridwatch-backend-554454627121.us-east1.run.app
• Status: ✅ Production Ready

# Health check
curl https://gridwatch-backend-554454627121.us-east1.run.app/health

# View current incidents
curl https://gridwatch-backend-554454627121.us-east1.run.app/incidents

# Run once (testing)
python3.11 run_agents_live.py

# Run continuously (production)
python3.11 integration/enhanced_agent_runner.py

# Easy startup
./start_all_agents.sh

┌─────────────────────────────────────────────────────────┐
│                    GridWatch System                     │
├─────────────────────────────────────────────────────────┤
│  Frontend (Web App)                                     │
│  ├─ Real-time incident display                          │
│  ├─ Interactive map with filtering                     │
│  └─ Live updates from backend                          │
├─────────────────────────────────────────────────────────┤
│  Live Firebase Backend                                  │
│  ├─ FastAPI server                                      │
│  ├─ Firestore database                                 │
│  └─ REST API endpoints                                  │
├─────────────────────────────────────────────────────────┤
│  AI Agent System (5 Agents)                            │
│  ├─ 🚗 Traffic Agent    (congestion, accidents)        │
│  ├─ ⚡ Outage Agent     (power failures)              │
│  ├─ 🚔 Crime Agent      (public safety)               │
│  ├─ 🌍 Environment Agent (weather, air quality)       │
│  └─ 🚨 Emergency Agent  (road closures, alerts)       │
└─────────────────────────────────────────────────────────┘

• run_agents_live.py - Run all agents once
• integration/enhanced_agent_runner.py - Run agents continuously
• start_all_agents.sh - Easy startup script

• backend/ - FastAPI server with Firestore integration
• frontend/webapp/ - Web application with real-time updates

• agents/vendor/namma/traffic/ - Traffic monitoring
• agents/vendor/namma/energy/ - Power outage monitoring
• agents/vendor/namma/crime/ - Crime monitoring
• agents/vendor/namma/environment/ - Environmental monitoring
• agents/vendor/namma/emergency/ - Emergency monitoring

✅ Real-time Data - Incidents automatically saved to Firestore
✅ REST API - /health and /incidents endpoints
✅ CORS Enabled - Frontend can access the backend
✅ All 5 Incident Types - Traffic, Outage, Crime, Environment, Emergency
✅ Secure - Environment variables stored in cloud

Your live backend is already working with:

• 12+ incidents currently stored
• All 5 incident types supported
• Real-time updates from agents
• Frontend integration with proper styling

• ✅ No API keys in code - All sensitive data in cloud environment
• ✅ Secure cloud storage - Environment variables encrypted
• ✅ Production ready - Same environment as deployed backend

• AGENTS_SUMMARY.md - Complete agent documentation
• COMPLETE_ARCHITECTURE.md - System architecture details
• CLOUD_SETUP.md - Cloud environment setup guide

# Run agents locally (posts to cloud backend)
python3.11 run_agents_live.py

# Run agents continuously
python3.11 integration/enhanced_agent_runner.py

• Backend Health: https://gridwatch-backend-554454627121.us-east1.run.app/health
• Incidents API: https://gridwatch-backend-554454627121.us-east1.run.app/incidents
• Frontend: https://gridwatch.dev/

✅ Live Firebase Backend - All 5 incident types supported
✅ Real-time Agent System - Runs locally, posts to cloud
✅ Frontend Integration - Automatic connection to live backend
✅ Production Ready - Secure, clean, and efficient
✅ Clean Codebase - Only essential scripts, no redundancy

• Backend Issues: Check health endpoint and logs
• Agent Issues: Check individual agent logs
• Frontend Issues: Check browser console and network tab
• General: Review documentation files

GridWatch - Comprehensive Multi-Incident Monitoring System 🚀

Built for DevFestDC 25 Agentic AI Hackathon