raeeynega/HHR_chatbot

🏥 HHR Multilingual Health Chatbot - Afaan Oromo + Amharic + English. FAISS RAG for HHR data + DuckDuckGo fallback. 100% free, no API keys, CPU-only, self-hosted. Built for Hararghe Health Research, Ethiopia. # 🏥 HHR Multilingual Health Chatbot **Hararghe Health Research - Afaan Oromo + Amharic + English** A production-ready, **100% free** multilingual chatbot for Hararghe Health Research (HHR) that answers questions in **English, Afaan Oromo, and Amharic** - using HHR's own data for local questions and DuckDuckGo for live web search. --- ## ✨ Features ✅ **Truly Multilingual** - Ask in Afaan Oromo, get reply in Afaan Oromo! ✅ **HHR Knowledge Base** - Scraped HHR website + FAISS vector search ✅ **Live Web Search** - DuckDuckGo fallback (FREE, no API key) ✅ **Instant FAQs** - Pre-loaded question buttons ✅ **No API Costs** - All tools open-source or free tier ✅ **CPU Only** - Runs on 8GB RAM, no GPU needed ✅ **Data Sovereignty** - Self-hosted, no cloud dependency --- ## 🛠️ Tech Stack | Component | Technology | |----------|------------| | **Backend** | FastAPI + Uvicorn | | **Embeddings** | intfloat/multilingual-e5-small | | **Vector DB** | FAISS (Facebook AI Similarity Search) | | **Translation** | Helsinki-NLP OPUS-MT (Oromo↔English, Amharic→English) | | **Language Detection** | LangDetect + Oromo keyword fallback | | **Web Search** | DuckDuckGo Instant Answer API (FREE) | | **Frontend** | HTML/CSS/JavaScript (no frameworks) | --- ## 📁 Project Structure hhr-chatbot/ ├── app.py # Main FastAPI application ├── translator.py # Oromo/Amharic translation ├── duckduckgo_search.py # FREE web search fallback ├── faq_data.py # Pre-loaded FAQ database ├── requirements.txt # Python dependencies ├── .gitignore # Files to exclude from git ├── README.md # This file │ ├── scripts/ │ ├── scrape_champs.py # Website scraper │ ├── clean_data.py # Data cleaning │ └── build_index.py # FAISS index builder │ ├── models/ # FAISS index (gitignored) ├── data/ # Scraped data (gitignored) ├── venv/ # Virtual environment (gitignored) └── chat.html # Web interface