smartjef/crisislens

AI-powered flood intelligence platform for Kenya's Lake Victoria basin — real-time risk prediction, role-based dashboards, and actionable early alerts for Kisumu, Siaya & Homa Bay. # CrisisLens CrisisLens is an AI-driven early warning and intelligence platform designed to detect, analyze, and anticipate humanitarian and climate-related crises such as drought and food insecurity. The system integrates multiple data sources, transforms them into meaningful indicators, and applies machine learning models to support timely, data-informed decisions. --- ## What Problem CrisisLens Solves Across many regions, especially in climate-vulnerable areas, early signals of drought and food stress exist but are scattered across datasets, institutions, and formats. By the time impacts are visible, response is often late and costly. CrisisLens addresses this gap by: * Aggregating environmental and economic signals (rainfall, vegetation health, food prices) * Converting raw data into interpretable drought risk features * Enabling predictive modeling and downstream integrations via an API --- ## Core Capabilities * **Data Ingestion**: Automated collection of rainfall, NDVI, and food price data * **Data Processing**: Cleaning, normalization, and feature engineering * **Modeling**: Machine learning models for drought risk estimation * **API Layer**: Programmatic access to predictions and indicators * **Research-Ready**: Notebook-based exploration and experimentation --- ## Project Structure The repository is organized into clear, modular components that reflect the full data-to-decision pipeline. ### Backend (Django) backend/ * crisislens/: Django project settings and routing * api/: REST API endpoints and scoring logic ### Frontend (React) frontend/ * src/: React UI for drought and flood risk scoring * src/data/kenyaCounties.json: Placeholder GeoJSON grid for 47 counties (swap with official boundaries) * index.html: Vite entry point ### Root Files * requirements.txt: Python dependencies * README.md: Project documentation --- ## Getting Started ### Prerequisites * Python 3.9+ * Node.js 18+ ### Installation ```bash pip install -r requiremen …