AI-powered multi-agent system for infrastructure issue reporting and response coordination in Nigeria.
InfraAlert transforms citizen reports into coordinated responses:
- Receives reports through web, mobile, and voice channels
- Analyzes using Vision API, Speech-to-Text, NLP, and Gemini AI
- Prioritizes based on severity, urgency, and impact
- Dispatches optimal repair teams with equipment
- Notifies citizens via SMS (Africa's Talking)
| Service | URL |
|---|---|
| Web App | https://infraalert-webapp-wuqtulo2va-uc.a.run.app |
| Orchestrator | https://orchestrator-agent-wuqtulo2va-uc.a.run.app |
| Issue Detection | https://issue-detection-agent-wuqtulo2va-uc.a.run.app |
| Priority Analysis | https://priority-analysis-agent-wuqtulo2va-uc.a.run.app |
| Resource Coordination | https://resource-coordination-agent-wuqtulo2va-uc.a.run.app |
| Platform Integration | https://platform-integration-agent-wuqtulo2va-uc.a.run.app |
| MCP Server | https://mcp-server-wuqtulo2va-uc.a.run.app |
Pipeline: Detection → Priority → Coordination → Platform Integration
ADK SequentialAgent orchestrates sub-agents in-process with shared session state.
Key protocols: MCP (tool integration via FastMCP).
- Python 3.12+ and uv package manager
- gcloud CLI
- Docker Desktop (for local dev)
# Install tools
./scripts/setup-uv.sh
./scripts/setup-gcloud.sh
# Or: make setup-tools# 1. Clone and install
git clone <repository-url> && cd InfraAlert
make install-dev
# 2. Configure environment
./scripts/setup-env.sh
# Edit .env with your GEMINI_API_KEY and PROJECT_ID
# 3. Verify
make check
# 4. Run locally
docker-compose up
# Or run individual agents: cd agents/issue_detection && python app.pymake help # All commands
make check # Lint + test (run before committing)
make docker-up # Start all services locally
make build-all # Build Docker images
make deploy-all # Deploy to Cloud Run
make deploy-service SERVICE=issue-detection # Deploy single serviceDeploy order: MCP Server → Platform Integration → Issue Detection → Priority Analysis → Resource Coordination → Orchestrator
- Platform: Google Cloud (Cloud Run, Firestore, BigQuery, Pub/Sub, Cloud Storage)
- AI/ML: Gemini, Vision API, Speech-to-Text, NLP API
- Framework: Google ADK (Agent Development Kit)
- MCP: FastMCP SDK for tool integration
- SMS: Africa's Talking (optional, cost-effective Nigerian coverage)
- Frontend: React/Vite with Tailwind CSS
- Backend: Flask (agents), FastAPI (webapp)
- Tools: uv, Ruff, MyPy, Pytest
See LICENSE file.
