Byron94odhiambo/afyaguide

AfyaGuide: Offline Maternal Health AI for Rural Kenya's Community Health Workers # AfyaGuide: Maternal Health Assistant **An AI-powered clinical decision support tool for Community Health Workers in rural Kenya, specialized in maternal health and risk stratification.** ## 🌍 Overview AfyaGuide is a comprehensive maternal health assistant designed specifically for Community Health Workers (CHWs) operating in rural Kenya. The application provides AI-powered clinical decision support, risk assessment tools, and emergency protocols to improve maternal health outcomes in underserved communities. ### Key Features - 🏥 **Patient Management System** - Comprehensive patient records with visit history tracking - 🧠 **AI-Powered Clinical Assistant** - Gemini AI integration for clinical guidance and recommendations - 📊 **Risk Assessment Tools** - Automated risk stratification for maternal health cases - 🚨 **Emergency Protocols** - Quick access to emergency procedures and contact information - 📱 **Responsive Design** - Mobile-optimized interface for field use - 🌐 **Bilingual Support** - English and Swahili language options - 🔒 **Secure Data Storage** - Local storage with encryption for patient privacy - 📈 **Analytics Dashboard** - Visual insights into patient populations and trends ## 🚀 Quick Start ### Prerequisites - **Node.js** (version 18+ recommended) - **NPM** package manager - **Gemini API Key** (for AI features) ### Installation 1. **Clone the repository:** ```bash git clone cd afyaguide_-maternal-health-assistant ``` 2. **Install dependencies:** ```bash npm install ``` 3. **Configure environment:** - Create a `.env.local` file in the root directory - Add your Gemini API key: ``` GEMINI_API_KEY=your_api_key_here ``` 4. **Start the development server:** ```bash npm run dev ``` 5. **Open your browser:** Navigate to `localhost` to access the application ## 🏗️ Architecture ### Technology Stack - **Frontend Framework:** React 19.2.3 with TypeScript - **Build Tool:** Vite 6.2.0 - **UI Components:** Custom components with L …