stmarkadebayo/WonderCare-Africa

# WonderCare Africa - PHC Navigator **AI-Powered Decision Support and Predictive Analytics for Primary Health Care in Nigeria** ## 🌟 Overview WonderCare Africa (PHC Navigator) is an innovative AI-driven platform addressing critical gaps in Primary Health Care (PHC) delivery across Nigeria. Built for the Datafest Africa Hackathon, this solution empowers health workers with real-time decision support while providing managers with predictive insights to prevent health crises. The platform leverages comprehensive health data from actual sources including facility master data, daily metrics, equipment inventories, medicine stock levels, and service capabilities to provide accurate, context-aware recommendations. ## 🎯 Key Features - **Multilingual Health Chat**: Conversational AI clinical assistant in English/Pidgin/Hausa/Yoruba - **Real Healthcare Database**: Live connection to PostgreSQL with Nigerian facility data - **Clinical Decision Support**: WHO IMCI guidelines with LLM explanations - **Managerial Analytics Dashboard**: Stock-out forecasts and facility monitoring - **Geospatial Intelligence**: Facility matching with real Nigerian locations ## 🚀 Quick Start ### Prerequisites - Python 3.9+ - Docker & Docker Compose - PostgreSQL (or use Aiven cloud instance) - OpenAI API key (for LangChain features) ### Installation **Option 1: Docker Deployment (Recommended for Hackathon Demo)** ```bash # Clone repository git clone cd wondercare-africa # Start complete system with one command make demo # Or: docker-compose up -d ``` **Option 2: Local Development** ```bash # Clone and setup git clone cd wondercare-africa # Create virtual environment python -m venv venv source venv/bin/activate # or `venv\Scripts\activate` on Windows # Install dependencies pip install -r requirements.txt # Set up environment variables cp .env.example .env # Edit .env with your database credentials and OpenAI API key # Run development servers make dev ``` ### Data Setup The platfo …