sHabakkuk/diabetesiq-kenya
Domain:
healthcarenatural language processingRecord type:
softwaretools
Creator:
sHa
Host:
# 🩺 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 …