majaliwatani-pro/afyaintel-agent-capstone

Research-grounded, local-first AI agent for health-facility operations in low-resource settings: stock monitoring, expiry alerts, bilingual reports, safety guardrails, and offline-ready deployment. # AfyaIntel Agent — Professional Kaggle AI Agents Capstone **Project:** AfyaIntel Agent: Bilingual, Local-First Health-Facility Operations Support for Low-Resource Settings **Course:** Kaggle 5-Day AI Agents: Intensive Vibe Coding Course With Google **Builder:** Majaliwa Tani Mabirika **Version:** 1.1.0 Research-Integrated Edition **Status:** Working local prototype; professional capstone package; external codelab evidence still to be captured ## Executive Summary AfyaIntel helps authorized health-facility staff understand medicine and supply stock, identify expiry risk, and draft English or Swahili operations reports. It is designed around a simple principle: factual and safety-critical behavior should remain deterministic, testable, and available even when a model, network, or free-tier quota is unavailable. The project demonstrates agentic engineering through explicit context, structured tools, clinical guardrails, privacy-preserving audit metadata, human approval, Agent Skills, interoperability artifacts, automated evaluation, and deployment readiness. ## Why It Matters Small facilities may use paper registers or disconnected spreadsheets, while staff manually prepare shortage and expiry reports. A useful agent for this context must be: - **Local-first:** essential workflows continue without model access. - **Bilingual:** English and Swahili operational support. - **Grounded:** stock values come from validated structured data. - **Safety-governed:** no diagnosis, prescription, dosage, or treatment. - **Human-supervised:** no autonomous procurement, payment, redistribution, or communication. - **Evaluated:** claims are backed by repeatable local and unit tests. ## Working Capabilities - Validates a single-facility inventory CSV. - Detects stock below minimum thresholds. - Detects items expiring within 30 days. - Looks up specific inventory items. - Generates English and Swahili summaries. - Generates a management-ready weekly report. - Routes clinical an …