Empowering Ghana's 100k+ CHWs with mobile-friendly visual AI to accurately triage clinical cases without internet or doctors.
# π₯ CHW Triage Assistant
> Powered by Gemma 4 Β· Build with Gemma: Ghana Hackathon Β· July 2026
A lightweight AI-powered triage tool for Community Health Workers (CHWs) in Ghana and West Africa. Upload an image of a wound, rash, eye condition, or drug label β get a structured triage note instantly.
---
## The Problem
Ghana has over 100,000 community health workers covering rural and peri-urban areas. Most operate without reliable internet, without physicians on call, and with limited medical training beyond basic first aid. Every triage decision relies on memory, paper forms, and experience alone.
## The Solution
A Gemma 4-powered vision app that:
- Analyzes clinical images (wounds, rashes, eye conditions, drug labels)
- Produces a structured triage note with urgency level
- Suggests immediate CHW actions
- Generates a referral note for the receiving clinic
- Works on any device with a browser β no app install required
---
## Setup (Local)
### 1. Get a free Gemini API key
Go to
aistudio.google.com β free, no credit card.
### 2. Clone and install
```bash
git clone
github.com /chw-triage-assistant
cd chw-triage-assistant
pip install -r requirements.txt
```
### 3. Set your API key
```bash
export GEMINI_API_KEY=your_key_here
```
### 4. Run
```bash
python app.py
```
Gradio will print a local URL (`
127.0.0.1`) and a **public share URL** β use the share URL as your live demo link.
---
## Setup (Kaggle Notebook β Recommended for Submission)
1. Create a new Kaggle Notebook
2. Add your API key: **Add-ons β Secrets β Add New Secret**
- Name: `GEMINI_API_KEY`
- Value: your key from AI Studio
3. Copy `kaggle_notebook.py` content into the notebook cells
4. Run all cells
5. Copy the `share=True` public URL from the Gradio output β this is your **Live Demo link**
---
## Architecture
```
User (CHW) uploads image
β
Gradio UI (browser-based, no install)
β
PIL image β base64 encode
β
Gemma 4 (gemma-4-it) via Google AI Studio API
βββ System β¦