# AMINA — Healthcare AI for The Gambia
> **📦 Demo copy.** This is a public, portfolio/demo mirror of the AMINA project. All real secrets (`.env` files, TLS keys, service-account credentials) and runtime database state have been **scrubbed from the entire git history** — only `.env.example` / `.env.defaults` templates remain, which is all you need to run the demo locally. No production credentials are present. Configure your own keys before any non-demo use.
AMINA is an open-source clinical assistant tailored for non-communicable disease (NCD) care in Gambian primary-health workflows. Built on the GENIE.AI / Haystack stack, it speaks English and Mandinka, adapts to three literacy levels, and is designed to work in low-connectivity environments — putting trustworthy health guidance in the hands of patients, caregivers, and clinicians across The Gambia.
> AMINA is the Gambian healthcare reference implementation of GENIE.AI, governed under the ITU AI for Good track as an open-source Digital Public Good.
---
## What AMINA does
- 🗣️ **Multilingual voice interaction** — English and Mandinka, fully CPU-local (no cloud round-trips)
- 📋 **NCD-focused clinical guidance** — grounded in MoH/WHO sources via RAG pipeline
- 👨‍👩‍👧 **Caregiver Mode** — family members stay connected to patient progress
- 📊 **Clinician & government dashboards** — anonymized population insights via Superset + DHIS2
- 🔒 **Privacy-first** — HIPAA-aligned, GDPR-informed, Gambian Data Protection Act 2025 compliant
- 📶 **Offline-friendly** — local voice/translation models, deferred sync
---
## Literacy modes
Three modes selectable at signup, stored in ArcadeDB:
| Mode | Experience |
|---|---|
| **Beginner** | Large-tile shell, audio-first |
| **Basic** | Simplified interface |
| **Advanced** | Full UI |
Demo logins (password: `Demo2026`): `beginner@demo.aminacare` · `basic@demo.aminacare` · `advanced@demo.aminacare`
---
## How to run
```powershell
# Windows
git clone
github.com …