SAMSONAMINGA/FLOOD-GUARD-KE
Domain:
climategeospatialRecord type:
project
Creator:
SAM
Host:
AI-powered flood early warning platform for Kenya’s 47 counties using citizen barometers, satellite rainfall & multi-channel alerts
# FloodGuard KE - Complete System Documentation
**Production-grade Early Warning System for Kenya Flood Disasters**
Comprehensive 60-minute early warning platform integrating citizen barometer sensors, satellite rainfall data, hydrological modeling, and multi-channel alert dispatch to Kenya's 47 counties.
---
## Quick Start (5 Minutes)
### Prerequisites
- Docker Desktop ✓
- Node.js 18+
- ~15 GB disk space
### Run Everything Locally
```bash
# 1. Start backend (PostgreSQL, Redis, FastAPI, Celery)
cd backend
docker-compose up -d
# 2. Start frontend (Next.js)
cd frontend
npm install
npm run dev
# Open localhost
# 3. (Optional) Start Android emulator
cd android
./gradlew installDebug
```
**System online in ~30 seconds** ✓
Full setup guide: LOCAL-LAPTOP-SETUP.md
---
## System Overview
### What is FloodGuard KE?
FloodGuard KE is a **citizen science + AI hybrid platform** that provides **60-minute flood early warnings** by combining:
1. **Citizen Barometer Network**: 100k+ Android app users submit pressure readings every 5 minutes
2. **Satellite Rainfall**: IMERG precipitation data every 30 minutes
3. **Hydrological AI**: GATv2 graph neural network + Extended Kalman Filter fusion
4. **Multi-Channel Alerts**: SMS/USSD to 90%+ of Kenya's population
**The Result**: Communities know 60 minutes in advance that flooding is coming.
### Key Statistics
| Metric | Value |
|--------|-------|
| **Coverage** | All 47 Kenya counties |
| **Early Warning Lead Time** | 60 minutes |
| **Population Reached** | 4.2M via SMS/USSD |
| **Barometer Sensors** | 100k+ volunteer app users |
| **Alert Delivery Rate** | >90% (Africa's Talking SLA) |
| **Processing Latency** | 100k users)
```
### AWS Deployment ($5k/month)
```bash
terraform apply # Provision VPC, RDS, ElastiCache, ECS
docker push aws... # Push image to ECR
# Auto-scales 3-20 tasks based on load
```
### GCP Deployment ($4k/month)
```bash
gcloud run deploy …