Abd453/afaan-oromoo-llm

wait for it # Afaan Oromoo Conversational AI System A production-ready conversational AI system specialized in **Afaan Oromoo** (Oromo language) with English code-switching support, built using Google's Gemini 2.5 Flash model. This system provides culturally-aware responses, persistent conversation history, comprehensive evaluation metrics, and robust error handling. --- ## 📋 Table of Contents - Overview - Main Functionalities - Language & LLM Details - System Architecture - Key Features - Installation - Usage - Limitations - Evaluation & Testing - API Documentation - Project Structure - Contributing - License --- ## 🌍 Overview The **Afaan Oromoo Conversational AI System** is designed to bridge the technological gap for Oromo language speakers by providing an intelligent, context-aware chatbot that understands and responds in Afaan Oromoo. The system is culturally sensitive, handles technical queries, educational content, and daily conversations while maintaining linguistic accuracy. ### Why Afaan Oromoo? - **Speakers**: ~40 million native speakers (Ethiopia, Kenya) - **Language Family**: Cushitic branch of Afro-Asiatic languages - **Digital Gap**: Limited AI/NLP resources available - **Cultural Importance**: Official language of Oromia Region, Ethiopia --- ## 🚀 Main Functionalities ### 1. **Conversational AI** - Natural language understanding in Afaan Oromoo - Context-aware responses maintaining conversation history - Support for greetings, questions, technical discussions, and educational queries - Code-switching between Afaan Oromoo and English ### 2. **Session Management** - Persistent conversation history across page refreshes - Multiple conversation sessions with titles - Session creation, retrieval, update, and deletion - Automatic session recovery on page load ### 3. **Database Persistence** - SQLite-based storage for conversations - Message history preservation - Analytics tracking (response times, error rates) - Session metadata management ### 4. * …