ziko-ahmed/saheli
0
🛡️ Saheli
WhatsApp-first AI triage system for rural healthcare, powered by Gemma 4.
Saheli lets any patient describe their symptoms via WhatsApp — in text, voice, or photo — and receives an intelligent triage response in their language. Behind the scenes, Saheli silently aggregates anonymous symptom data across thousands of conversations to detect disease outbreaks 48–72 hours before official surveillance.
Kaggle Gemma 4 Good Hackathon 2026 Tracks: Health & Sciences · Digital Equity & Inclusivity
✨ Features
- 🗣 Multilingual triage — Hindi, English, Bengali, Tamil (Gemma 4 supports 140+ languages)
- 📱 WhatsApp-first — Zero learning curve, works on basic phones
- 🎤 Multimodal input — Text, voice notes (Whisper), photos of rashes/wounds
- 🧠 Gemma 4 intelligence — Fine-tuned 26B MoE model for medical symptom analysis
- ⚡ 3-tier severity scoring — Mild → self-care, Moderate → ASHA alert, Emergency → all hands
- 🔬 Outbreak detection — DBSCAN geo-temporal clustering for epidemic early warning
- 📊 Live dashboard — Heatmap, alert feed, symptom trends, severity distribution
- 🔒 Privacy-first — No PII stored, 6-hour time bucketing, k-anonymity
🏗 Architecture
Patient (WhatsApp)
↓
Meta Cloud API webhook
↓
FastAPI Backend
↓
Gemma 4 (26B A4B MoE, fine-tuned)
→ Language detection → Symptom extraction
→ Severity scoring → Differential diagnosis
→ Explainable reasoning (XAI)
↓
┌─────────────┬─────────────┐
│ Mild (1-4) │ Mod (5-7) │ Emergency (8-10)
│ Self-care │ + ASHA alert│ + All services alerted
└─────────────┴─────────────┘
↓
Anonymous telemetry → DBSCAN clustering → Outbreak alerts🚀 Quick Start
Prerequisites
- Python 3.11+
- Docker & Docker Compose (for PostgreSQL + TimescaleDB)
- NVIDIA GPU with 16GB+ VRAM (for Gemma 4; or use mock mode)
Setup
# Clone and enter project
cd saheli
# Copy environment file
cp .env.example .env
# Edit .env with your WhatsApp API credentials
# Start database
docker compose up -d db
# Install Python dependencies
pip install -r requirements.txt
# Run the server
uvicorn app.main:app --reloadEndpoints
📁 Project Structure
saheli/
├── app/ # FastAPI backend
│ ├── main.py # Application entry point
│ ├── config.py # Settings (Pydantic)
│ ├── models/ # Pydantic schemas
│ ├── routers/ # API endpoints
│ ├── services/ # Business logic
│ ├── db/ # Database layer
│ └── prompts/ # Gemma 4 system prompts
├── dashboard/ # Outbreak web dashboard
├── diagrams/ # Architecture SVG diagrams
├── notebooks/ # Kaggle notebooks
├── data/ # Datasets
├── docs/ # Competition deliverables
└── tests/ # Test suite🧬 Tech Stack
📜 License
Apache 2.0 — same as Gemma 4.