zonecrest/chatbot

Ghana tax chatbot # Ask GRA - Taxpayer Chatbot Prototype An AI-powered chatbot that helps Ghanaian citizens understand tax law using RAG (Retrieval-Augmented Generation) with verifiable citations. ## Overview "Ask GRA" is a friendly tax assistant named Kofi that answers questions about Ghana's tax laws. Every answer includes citations to the actual legislation, building trust by proving the AI isn't making things up. **Key Features:** - Natural language Q&A about Ghana taxes - Citations from official tax documents (VAT Act, Income Tax Act, E-Levy Act) - Multi-language support (English, Pidgin, Twi, Ga, Ewe) - Mobile-first WhatsApp-style interface - Admin dashboard for monitoring ## Quick Start ### Option 1: Local Demo (No Backend Required) 1. Open `frontend/index.html` in a web browser 2. The chatbot runs in demo mode with sample Q&A 3. Try asking: "What is the VAT rate in Ghana?" ### Option 2: Deploy to Netlify 1. Push this repo to GitHub 2. Connect to Netlify 3. Deploy the `frontend/` directory 4. Access your live URL ### Option 3: Full Setup with n8n + AI See n8n/README.md for backend setup with: - OpenAI/Anthropic for AI responses - Vector store for document retrieval - Real Ghana tax PDFs ## Project Structure ``` ghana-chatbot-prototype/ ├── frontend/ │ ├── index.html # Main chat interface │ ├── admin.html # Admin dashboard │ ├── css/styles.css # GRA-branded styling │ ├── js/ │ │ ├── config.js # Configuration │ │ ├── storage.js # LocalStorage handling │ │ ├── api.js # Backend API + demo mode │ │ ├── chat.js # Chat functionality │ │ └── app.js # Main application │ ├── assets/ # Icons and images │ └── manifest.json # PWA manifest ├── n8n/ │ └── chat-workflow.json # n8n AI workflow ├── knowledge-base/ │ ├── sample-vat-qa.json # Sample VAT Q&A │ └── sample-e-levy-qa.json └── README.md ``` ## Demo Scenarios ### 1. Basic Tax Question > "What is the VAT r …