IsaakAlemu/amharic-agri-advisor

# Amharic Agricultural Advisory Assistant 🌾🚜 *(የአማርኛ የግብርና አማካሪ ረዳት)* A production-grade, bilingual (Amharic & English) Retrieval-Augmented Generation (RAG) system providing actionable, evidence-based agricultural advice for Ethiopian smallholder farmers and agricultural extension agents (DAs). Covering 9 key agricultural domains in Ethiopia: **Teff, Maize, Coffee, Enset, Wheat, Pulses (Faba Bean & Chickpea), Soil Fertility & Acidity Management, Crop Calendars, and Horticulture (Potato & Tomato Late Blight)**. Positioned as an intelligent, conversational evolution to Ethiopia's traditional 8028 Farmer Advisory Hotline. --- ## 🏛️ High-Level System Architecture ```text [ Smallholder Farmer Query in Amharic or English ] │ ▼ [ 1. Query Rewriter & Context Expander ] <-- Multi-turn Conversational Memory │ ▼ [ 2. Prompt-Injection & Safety Guard ] <-- Bilingual (Amharic + English) Adversarial Filter │ ▼ [ 3. Crop-Entity Scope & Refusal Guard ] <-- 100% Boundary Safety on Out-of-Scope Crops/Livestock │ ▼ [ 4. Hybrid Retrieval Engine (RRF) ] ├── Dense: multilingual-e5-small (ChromaDB Vector Store) ├── Lexical: BM25 with Ethiopic Normalization & Stemming └── Reciprocal Rank Fusion (RRF) with Dynamic Crop-Entity Boosting │ ▼ [ 5. Topic Coverage Verification Guard ] <-- Selective Polite DA Refusal on Uncovered Subtopics │ ▼ [ 6. Grounded Generator (Groq LLM) ] <-- Human-Friendly Citations & Direct-Answer Structure │ ▼ [ 7. Streamlit Multi-Turn Mobile Web UI ] <-- Ethiopic Typography & Collapsible Provenance Cards ``` --- ## 📊 Benchmark & Evaluation Scorecard Tested across a held-out naturalistic benchmark representing realistic Ethiopian smallholder farmer phrasing: | Evaluation Metric | Score | Status | | :--- | :--- | :--- | | **Top-1 Retrieval Accuracy** | **88.9%** (24/27 in-scope queries) | ✅ Production Grade | | **Top-3 Retrieval Accuracy** | **96.3%** (26/27 in-scope queries) | ✅ Exceeds 90% Target | | **Answer Faithfulness Rate** | **85.2%** (Grounded …