iraelie251006/mbwira

Ubuzima bwawe, ibanga ryawe. A confidential Kinyarwanda health companion for young Rwandans — accessible via USSD, WhatsApp, and web. covering sexual and reproductive health and mental health, with safe escalation to licensed counselors. # Mbwira **Ubuzima bwawe, ibanga ryawe.** A confidential Kinyarwanda health companion for young Rwandans — accessible via USSD, WhatsApp, and web — covering sexual and reproductive health and mental health, with safe escalation to licensed counselors. Built for the iAccelerator 2026 competition (Imbuto Foundation · MINIYOUTH · UNFPA). --- ## What's in the box ``` mbwira/ ├── backend/ │ └── app/ │ ├── main.py # FastAPI entry point │ ├── config.py # env-based settings │ ├── routers/ │ │ ├── ussd.py # Africa's Talking USSD webhook │ │ ├── whatsapp.py # Meta WhatsApp webhook │ │ ├── chat.py # web chat API │ │ └── counselor.py # counselor dashboard API │ ├── services/ │ │ ├── llm.py # Claude API wrapper │ │ ├── safety.py # crisis keyword + escalation detection │ │ └── handoff.py # creates Escalation records │ ├── content/ │ │ ├── ussd_tree.py # bilingual menu tree (Kinyarwanda/English) │ │ └── system_prompt.py # Claude instructions for WhatsApp/web │ └── models/db.py # SQLAlchemy models (Session, Message, Escalation) ├── frontend/ │ ├── index.html # public landing page │ ├── chat.html # web chat demo │ ├── ussd_simulator.html # browser-based USSD phone simulator │ └── counselor.html # counselor dashboard └── docs/ ├── ARCHITECTURE.md ├── PITCH.md └── SETUP.md ``` --- ## Quickstart (local, ~5 minutes) ```bash cd backend python -m venv .venv && source .venv/bin/activate pip install -r requirements.txt cp .env.example .env # edit .env — at minimum set ANTHROPIC_API_KEY uvicorn app.main:app --reload --port 8000 ``` Then open: - **http://localhost:8000** — landing page - **localhost — USSD simulator (best demo for judges) - **local …