Olluwatosin/cultural-chatbot

nigeria cultura chatbot # 🇳🇬 Nigerian Culture RAG System **A Multilingual Multimodal Cultural Knowledge Base powered by N-ATLaS Local AI** ## 🚀 Features - **🤖 N-ATLaS Integration**: Local multilingual multimodal AI processing - **🌍 Multi-language Support**: English, Hausa, Yoruba, Igbo, Fulfulde - **📊 Smart Scraping**: Automated cultural data collection - **💬 Cultural Q&A**: Ask questions in any supported language - **🎨 Multimodal Analysis**: Text, image, and audio processing - **📱 Web Interface**: Beautiful Streamlit app ## 🛠️ Quick Start 1. **Setup Environment** ```bash pip install -r requirements.txt cp .env.example .env # Edit .env if needed (GPU settings) ``` 2. **Build Knowledge Base** ```python # Run in Jupyter notebook from cultural_processor import CulturalProcessor processor = CulturalProcessor() kb = processor.create_cultural_knowledge_base() ``` 3. **Launch Web App** ```bash streamlit run app.py ``` ## 🏗️ Architecture ``` Nigerian Culture RAG System ├── 🧠 Natlas AI (Multilingual/Multimodal) ├── 🔍 Cultural Data Scraper ├── 📊 Knowledge Base Builder ├── 💬 Q&A Interface └── 🌐 Web Application ``` ## 📁 Project Structure ``` nigeria culture/ ├── app.py # Streamlit web app ├── cultural_processor.py # Main data processor ├── natlas_client.py # Natlas API client ├── config.py # Configuration ├── ngdata.ipynb # Jupyter notebook ├── ngdata/ # Data directory │ ├── raw/ # Raw scraped data │ ├── processed/ # Natlas-enhanced data │ └── media/ # Images, audio files └── requirements.txt # Dependencies ``` ## 🎯 Usage Examples ### Ask Cultural Questions ```python from natlas_client import NatlasClient natlas = NatlasClient() # Loads NCAIR1/N-ATLaS locally # Ask in English response = natlas.cultural_qa("What are Nigerian festivals?", context, "en") # Ask in Hausa response = natlas.cultural_qa("Menene bukukuwan Najeriya?", context, "ha") ``` ### Process Cultural Media ```python # Analyze …