AMilto110/cdhc

Community Digital Health Companion AI-powered health assistant for the Bukedi Sub-region, Uganda # CDHC Virtual Doctor ## Community Digital Health Companion — Bukedi Sub-region, Uganda An AI-powered health assistant serving rural communities in Tororo, Busia, and Butaleja districts. Supports English, Luganda, Lusamia, and Ateso. --- ## Quick Start ### Prerequisites - Python 3.10+ (python.org) - Node.js 18+ (nodejs.org) - MySQL 8.0 (or Docker) - Anthropic API key — get free at console.anthropic.com ### Option A: Docker (Recommended) ```bash cp backend/.env.example backend/.env # Edit backend/.env — add your ANTHROPIC_API_KEY docker-compose up --build # Open localhost ``` ### Option B: Manual ```bash # Terminal 1 — Backend cd backend python -m venv venv source venv/bin/activate # Windows: venv\Scripts\activate pip install -r requirements.txt cp .env.example .env # Edit .env with your API key python app.py # Terminal 2 — Frontend cd frontend npm install npm start ``` --- ## Features - AI-powered symptom checker (Daktari) via Claude Sonnet - User registration & login with JWT authentication - 4-language support: English, Luganda, Lusamia, Ateso - GREEN / YELLOW / RED urgency triage system - Consultation history with full session replay - Community outbreak alerts (Bukedi region) - Admin analytics dashboard - Referrals to Tororo, Busia & Butaleja health facilities ## Pages | Route | Page | |-------|------| | / | Landing page | | /register | Register | | /login | Login | | /dashboard | User dashboard | | /consult | New consultation | | /history | Consultation history | | /profile | User profile | | /alerts | Community alerts | | /how-it-works | How It Works | ## Cloud Deployment 1. Get a VPS (DigitalOcean Droplet, AWS EC2, or Render) 2. Install Docker: curl -fsSL get.docker.com | sh 3. Upload your project: scp -r cdhc user@server:/opt/cdhc 4. Add your .env file with production values 5. Run: docker-compose up -d ## Tech Stack - Frontend: React 18, React Router, Axios - Backend: Flask, SQLAlchemy, Flask-JWT-Extende …