OpenAst/yorubaai

yoruba conversational AI # Yoruba AI Chatbot A text-based AI chatbot that responds fluently in the Yoruba language. Built with Next.js, FastAPI, and fine-tuned transformer models. **Status:** ✅ Production Ready - Using real fine-tuned models (no mock data) ## 🚀 Quick Start ### One-Command Setup (Recommended) ```bash cd /home/alien/yorubaai bash train_and_deploy.sh all ``` This automatically: 1. Sets up Python environment 2. Collects Yoruba training data from public sources 3. Fine-tunes a model on Yoruba text 4. Tests the complete system 5. Starts backend & frontend servers ### Manual Setup **Terminal 1 - Backend:** ```bash cd backend source env/bin/activate pip install -r requirements.txt python main.py ``` **Terminal 2 - Frontend:** ```bash cd frontend npm install npm run dev ``` Then open **http://localhost:3000** ## 📋 Features ✅ **Real Yoruba AI** - Fine-tuned on actual Yoruba text (not mock) ✅ **Text Chat Interface** - Beautiful, responsive UI ✅ **Conversation History** - Maintains context ✅ **GPU Support** - Auto-detects CUDA ✅ **Production Ready** - Fully tested and documented ✅ **Easy Deployment** - Multiple hosting options ## 🏗️ Architecture ``` ┌─────────────────────────────────────────┐ │ Next.js Frontend (React) │ localhost:3000 │ - Chat interface │ │ - Real-time messaging │ │ - Error handling │ └────────────────┬────────────────────────┘ │ HTTP/REST ▼ ┌─────────────────────────────────────────┐ │ FastAPI Backend │ localhost:8000 │ - /chat endpoint │ │ - /health check │ │ - CORS enabled │ └────────────────┬────────────────────────┘ │ ▼ ┌─────────────────────────────────────────┐ │ Fine-Tuned Yoruba Model (GPT-2) │ │ - Trained on real Yoruba texts │ │ - Bio: Collects from multiple sources │ │ - Uses LoRA for efficiency │ └───────────────────────────────────────── …