DavidBugger/Hausamaster_ai

is a cutting-edge language learning platform aimed at bridging the gap for NYSC Corp members, tourists, and workers moving to Northern Nigeria. # 🦅 HausaMaster AI > **Master the Hausa language naturally with the power of Gemini 2.5/1.5 AI.** **HausaMaster AI** is a cutting-edge language learning platform aimed at bridging the gap for NYSC Corp members, tourists, and workers moving to Northern Nigeria. Unlike generic language apps, HausaMaster focuses on cultural context, street-smart vocabulary, and real-time pronunciation coaching using advanced multimodal AI. ## ✨ Key Features * **🤖 Malam Musa (AI Tutor)**: An intelligent, culturally aware conversational partner powered by Google's Gemini AI. Musa teaches you not just *what* to say, but *how* to say it with respect to Northern etiquette. * **🗣️ Real-time Pronunciation Evaluator**: Record your voice and get instant, phoneme-level feedback. The AI analyzes your tone and accent to help you sound more like a native speaker. * **🎙️ Voice Assistant**: Navigate the app and control playback completely hands-free using voice commands (e.g., "Ask Musa...", "Go to lessons"). * **📝 Dynamic Quiz Generator**: Automatically generates quizzes based on the lessons you've just taken, testing both vocabulary and cultural knowledge. * **🌍 Cultural Context First**: Lessons include tips on religious awareness, market bargaining strategies, and regional etiquette. * **🎨 Premium UI**: A polished, "glassmorphism" aesthetic with smooth animations and dark mode support. ## 🛠️ Tech Stack * **Frontend**: React 19, Vite, TypeScript * **Styling**: Tailwind CSS v4, Framer Motion (animations) * **AI & Backend**: * Google GenAI SDK (`@google/genai`) * Gemini 1.5 Flash (Chat & Multimodal) * Supabase (Auth & Database) ## 🚀 Getting Started ### Prerequisites * Node.js (v18 or higher) * npm or yarn * A Google Gemini API Key ### Installation 1. **Clone the repository**: ```bash git clone github.com cd hausamaster-ai ``` 2. **Install dependencies**: ```bash npm install ``` 3. **Configure Environment Variables* …