DaymondMartin/AfyaPack

AfyaPack is a full-stack AI health assistant that works entirely offline, using local language models to provide grounded, citation-backed clinical decision support to health workers in low-resource settings. It supports English and Swahili, runs on both desktop and mobile, and exposes its intelligence through a conversational AI chat interface # AfyaPack — Offline-First AI Health Decision Support > **Protocol-grounded clinical guidance for frontline health workers. No internet required. Runs on any device.** AfyaPack is a full-stack AI health assistant that works entirely offline, using local language models to provide grounded, citation-backed clinical decision support to health workers in low-resource settings. It supports English and Swahili, runs on both desktop and mobile, and exposes its intelligence through a conversational AI chat interface backed by an agentic routing layer. --- ## Table of Contents 1. The Problem 2. What AfyaPack Does 3. Live Demo Walkthrough 4. Architecture Overview 5. How the AI Works 6. Foundry Local — The Core Advantage 7. Ollama as Fallback 8. How We Used AI Toolkit and Foundry Local 9. The MCP Server 10. Step-by-Step Setup Guide 11. Environment Configuration 12. API Reference 13. Agentic Chat Routing 14. Multilingual Support (Swahili) 15. Red Flag Screening Engine 16. Retrieval Pipeline (TF-IDF RAG) 17. Scalability and Deployment 18. Containerization Strategy 19. Mobile Strategy 20. How We Built AfyaPack with AI 21. Prompts and Prompt Engineering 22. Responsible AI Design 23. Project Structure 24. Tech Stack --- ## The Problem Frontline health workers in remote and rural areas manage complex patient presentations without access to specialist consultation, reference libraries, or stable internet. They make life-or-death decisions under pressure, often alone. When a child arrives with fever, convulsions, and signs of dehydration — the worker must instantly recall multi-step clinical protocols while managing the patient. **AfyaPack solves this.** It puts an AI clinical assistant in their pocket that: - Works with no internet connection - Speaks their language (English and Swahili) - Gives grounded, cited guidance from real clinical protocols - Screens for danger signs automatically - Generates referral documents when needed - Tracks medicine stock levels --- ## Wha …