sHabakkuk/diabetesiq-kenya

# 🩺 DiabetesIQ Kenya **An AI-powered public health intelligence tool for Kenya's diabetes and NCD landscape.** DiabetesIQ Kenya lets NGO program officers, health advocates, government officials, and researchers ask questions about Kenya's diabetes burden in plain English — and get instant, data-grounded answers with visualizations. Built to support advocacy, program design, and evidence-based decision-making for organizations working on NCDs in East Africa. > **🔴 Live demo:** diabetesiq-kenya.streamlit.app --- ## What it does | Feature | Description | |---|---| | **Data Explorer** | Interactive county-level charts filtered by region, prevalence, insulin availability, and diagnosis gap | | **AI Analyst** | Ask plain-English questions about the data. Powered by GPT-4o via the OpenAI API | | **Advocacy Brief Generator** | One-click 1-page evidence briefs tailored to donors, government, NGOs, or media | | **Anomaly Alerts** | Auto-flagged patterns — underdiagnosis hotspots, supply chain gaps, pediatric blind spots | | **Health Advisor** | Personalised diabetes risk assessment chatbot grounded in Kenya MOH Clinical Guidelines 2022 | --- ## Screenshots ## Screenshots ### Data Explorer ### AI Analyst ### Advocacy Brief Generator ### Health Advisor --- ## Quickstart ### 1. Clone the repo ```bash git clone github.com cd diabetesiq-kenya ``` ### 2. Set up your environment ```bash python -m venv venv source venv/bin/activate # Windows: venv\Scripts\activate pip install -r requirements.txt ``` ### 3. Add your OpenAI API key ```bash cp .env.example .env ``` Open `.env` and replace `your_api_key_here` with your key from platform.openai.com. ### 4. Run the app ```bash streamlit run app.py ``` The app opens at `localhost`. --- ## Deploy to Streamlit Cloud (free) 1. Push this repo to GitHub 2. Go to share.streamlit.io → New app 3. Select your repo and `app.py` as the entry point 4 …