Real-time flu activity forecasting across all 50 US states + DC with AI-powered health guidance
# Start both backend and frontend
./scripts/start.shThat's it! Open http://localhost:3000 in your browser.
- 🗺️ Interactive US Map - Click any state for detailed forecast
- 🎯 96.4% Accuracy - XGBoost ML model (R² 0.964, MAE 0.20)
- 🌡️ 7-Day Weather - Temperature context for health guidance
- 🏥 20 Hospitals - Nearby medical facilities with ratings
- 🤖 AI Guidance - OpenAI GPT-4 powered recommendations
- 📊 Real-time Insights - Seasonal trends, national statistics
- 🔴 Risk Levels - Low (<2%), Medium (2-4%), High (≥4%)
./scripts/start.sh # Start everything
./scripts/stop.sh # Stop everything
./scripts/test_e2e.sh # Run tests (11/11 passing)
./scripts/check-production.sh # Verify readinessdocker-compose up -d # Start with Docker
docker-compose logs -f # View logs
docker-compose down # Stop✅ 11/11 Tests Passing
✅ Backend API: 6/6
✅ Frontend: 2/2
✅ Data Integrity: 3/3
| Endpoint | Method | Description |
|---|---|---|
/api/health |
GET | Health check |
/api/metadata |
GET | Model info |
/api/forecast |
POST | Single state |
/api/batch_forecast |
POST | All 51 states |
/api/hospitals |
GET | Nearby facilities |
/api/ai/guidance |
POST | AI recommendations |
Flu_cast/
├── scripts/start.sh ⭐ One-command startup
├── fastapi_app.py Backend API (6 endpoints)
├── web/ Next.js frontend
├── artifacts/prod/ Model + 51 state forecasts
└── logs/ backend.log, frontend.log
See PRODUCTION_GUIDE.md for:
- Vercel + Railway (~$10/month)
- DigitalOcean (~$12/month)
- AWS ECS (~$20/month)
- DEPLOYMENT_SUCCESS.md - ✅ Test results & verification
- PRODUCTION_GUIDE.md - Complete deployment guide
- ✅ Zero critical bugs
- ✅ 11/11 tests passing
- ✅ 96.4% model accuracy
- ✅ Sub-second load times
- ✅ 51 state coverage
- ✅ Single-command deployment
Built with: FastAPI • Next.js • XGBoost • OpenAI GPT-4 • Google Maps API
Status: ✅ Ready for 1-week public launch