README.md

---
title: Flood Vulnerability API
emoji: 🌊
colorFrom: blue
colorTo: green
sdk: docker
pinned: false
---

# Flood Vulnerability Assessment API

Global, real-time flood risk analysis powered by:
- Google Earth Engine (terrain)
- OpenStreetMap (water proximity)
- SHAP (explanations)
- Multi-hazard modeling (fluvial, coastal, pluvial)

## Features
- Batch CSV upload
- 95% CI + uncertainty
- Multi Hazard detection (Fluvial, Coastal Surge and Pluvial)

## Try It
1. Visit `/docs` for interactive API documentation
2. Example coordinates:
   - `29.17, -95.31` → **MODERATE**
   - `27.7, 86.7` → **LOW**

## Tech Stack
- FastAPI + Hugging Face Spaces
- GEE + OSM + Natural Earth
- ONNX models for predictions
- `@lru_cache` for 100x batch speed