Puritymoraa/-Ghana-Government-Chatbot

A RAG-based AI chatbot that makes Ghana government information easily accessible by answering questions from official government documents with accurate source citations. It has a voice feature and a browser extension. # 🇬🇭 Ghana Government Chatbot A RAG-based AI chatbot that makes Ghana government information easily accessible by answering questions from official government documents with accurate source citations. ## Problem Statement Finding information from Ghana government agencies is difficult because: - Documents are scattered across multiple websites - PDFs are long, complex, and hard to search - No unified way to query government information ## Solution An intelligent chatbot that: - Answers questions using real government documents - Provides source citations for transparency - Supports voice interaction - Makes adding new sources effortless via browser extension ## Key Features - **RAG Architecture**: Retrieval Augmented Generation prevents hallucination - **Voice Chat**: Ask questions with your voice, get spoken answers - **Browser Extension**: Add any webpage to the knowledge base with one click - **Climate Filtering**: Automatic detection and filtering of climate-related content - **Source Citations**: Every answer shows which documents were used - **Easy Extensibility**: Upload PDFs, provide URLs, or use the extension ## Technology Stack - **LLM**: Llama 3.1 (8B) via Ollama and Phi 3 - **Vector DB**: ChromaDB with sentence-transformers embeddings - **Backend**: FastAPI (Python) - **Frontend**: HTML/CSS/JavaScript (Vanilla) - **Document Processing**: PyMuPDF, BeautifulSoup, Selenium - **Voice**: Web Speech API + Google Text-to-Speech - **Extension**: Chrome Extension (Manifest V3) ## Architecture ``` User Interface (Web + Extension) ↓ FastAPI Backend ↓ ┌────┴────┐ ↓ ↓ Retrieval Generation (ChromaDB) (Llama 3.1 + Phi 3) ↓ ↓ └────┬────┘ ↓ Document Store ``` ## Installation ### Prerequisites - Python 3.8+ - Ollama installed - Chrome browser (for extension) ### Backend Setup ```bash # Clone repository git clone github.com cd ghana-gov-chatbot # Install dependencies pip install -r requireme …