Giwa-ibrahim/nigeria_tax_chatbot
Domain:
digital infrastructureRecord type:
software
Creator:
Giw
Host:
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 --> …