CherutoCharlize/mamacare-ai

AI-Powered Maternal Health Triage System for Rural Kenya # MamaCare AI 🩺 **AI-Powered Maternal Health Triage and Early-Warning System for Rural Kenya** A three-agent AI ecosystem supporting Community Health Workers (CHWs) in Kisumu County with real-time risk triage, intelligent escalation, and structured clinical briefings. ## SDG Alignment - SDG 3 – Good Health and Well-being - SDG 5 – Gender Equality - SDG 10 – Reduced Inequalities ## Agent Architecture | Agent | Role | |-------|------| | Intake Scout | USSD-based structured danger sign assessment coach | | Triage Guardian | Maternal risk stratification (Low / Medium / High) | | Coordinator Hunter | Clinician matching + briefing packet generation | ## Tech Stack - **Backend:** Python 3.11, FastAPI - **AI Agents:** n8n (workflow orchestration) - **Database:** SQLite (local dev), PostgreSQL (production) - **Infrastructure:** AWS af-south-1 (Cape Town) — Kenya DPA 2022 compliant - **Channels:** USSD / SMS simulation via webhook ## Project Structure ``` mamacare/ ├── backend/ │ ├── main.py # FastAPI app entry point │ ├── agents/ │ │ ├── scout.py # Intake Scout Agent logic │ │ ├── guardian.py # Triage Guardian Agent logic │ │ └── coordinator.py # Coordinator Hunter Agent logic │ ├── models/ │ │ ├── patient.py # Patient data models │ │ └── risk.py # Risk scoring models │ ├── data/ │ │ └── mock_patients.json # Mock CHW intake data │ └── requirements.txt ├── n8n/ │ └── mamacare_workflow.json # Importable n8n workflow ├── .env.example ├── .gitignore └── README.md ``` ## Quick Start See the full setup guide in SETUP.md or follow the README steps below. ```bash # 1. Clone the repo git clone github.com cd mamacare-ai # 2. Create virtual environment python -m venv venv venv\Scripts\activate # Windows # 3. Install dependencies pip install -r backend/requirements.txt # 4. Copy and configure environment copy .env.example .env # 5. Run the backend uvicorn …