Giwa-ibrahim/nigeria_tax_chatbot

Intelligent Nigeria Tax Advisory Chatbot # Nigerian Smart AI Tax Assistant 🇳🇬 An intelligent, multi-agent tax advisory chatbot leveraging RAG (Retrieval-Augmented Generation) and LangGraph to provide accurate information about Nigerian tax policies, PAYE calculations, and personalized financial advice. ## 📋 Table of Contents - Features - Architecture - Workflow - Tech Stack - Prerequisites - Installation - Configuration - Usage - Project Structure - API Endpoints - Docker Deployment - Contributing ## ✨ Features - **🤖 Multi-Agent System**: Intelligent routing between specialized agents (Tax Policy, PAYE, Financial Advice) - **📚 RAG-Powered Responses**: Vector database retrieval for accurate, context-aware answers - **💰 PAYE Calculator**: Interactive salary tax calculation with detailed breakdowns - **🔍 Web Search Integration**: Real-time tax information via Tavily API - **💾 Conversation Memory**: PostgreSQL-backed chat history with thread persistence - **🎯 Personalized Advice**: Tailored financial recommendations based on user context - **🌐 Dual Interface**: Chainlit UI and FastAPI REST endpoints - **🐳 Docker Ready**: Containerized deployment with docker-compose ## 🏗️ Architecture ```mermaid graph TB subgraph "Client Layer" UI[Chainlit UI] API[FastAPI REST API] end subgraph "Agent Orchestration" MainAgent[Main Agent] Router[Intelligent Router] subgraph "Specialized Agents" TaxAgent[Tax Policy Agent] PayeAgent[PAYE Calculator Agent] FinAgent[Financial Advice Agent] CombAgent[Combined Agent] end ResponseGen[Response Generator] end subgraph "Tools & Services" RAG[RAG Tool] WebSearch[Web Search Tool] LLM[LLM Manager Groq/Gemini/Cohere] end subgraph "Data Layer" VectorDB[(ChromaDB Vector Store)] PostgreSQL[(PostgreSQL Chat History)] Embeddings[HuggingFace Embeddings] end UI --> MainAgent API --> MainAgent MainAgent --> Router Router --> TaxAgent Router --> PayeAgent Router --> FinAgent Router --> CombAgent TaxAgent --> RAG PayeAgent --> RAG FinAgent --> WebSearch CombAgent --> RAG TaxAgent --> …