yusufAbdulrasheed/TambayaIQ

Hausa Culture AI Assistant - Sokoto Heritage Explorer Discover the rich traditions and heritage of Hausa culture in Sokoto State, Northern Nigeria, through an intelligent AI-powered companion. This specialized chatbot serves as your personal guide to understanding the deep-rooted customs, history, and values of the Hausa people. # Hausa Culture AI Assistant 🕌 An intelligent chatbot specializing in Hausa culture, traditions, and history in Sokoto State, Northern Nigeria. Built with Next.js, Convex, and powered by advanced AI models. ## 🌟 Features - **AI-Powered Conversations** - Specialized knowledge about Hausa culture in Sokoto State - **User Authentication** - Secure authentication powered by Clerk - **Chat History** - Save and retrieve conversations with Convex database - **Real-time Updates** - Live chat synchronization - **Responsive Design** - ChatGPT-style interface that works on all devices - **Cultural Expertise** - Deep knowledge of: - Traditional ceremonies and festivals - Sokoto Caliphate history - Islamic influences and values - Traditional clothing and attire - Hausa language and proverbs - Family structures and social systems - Arts, crafts, and music - Traditional architecture - Culinary traditions ## 🚀 Tech Stack - **Frontend**: Next.js 15.5.4 (App Router), React, TypeScript - **Styling**: Tailwind CSS, shadcn/ui components - **Authentication**: Clerk - **Database**: Convex (real-time database) - **AI Model**: Groq API with Llama 3.1 70B (free tier) - **Icons**: Lucide React ## 📋 Prerequisites Before you begin, ensure you have: - Node.js 18+ installed - npm or yarn package manager - A Clerk account (free tier available) - A Convex account (free tier available) - A Groq API key (free tier available) ## 🛠️ Installation ### 1. Clone the repository ```bash git clone github.com cd hausa-culture-ai ``` ### 2. Install dependencies ```bash npm install # or yarn install ``` ### 3. Set up environment variables Create a `.env.local` file in the root directory: ```env # Clerk Authentication NEXT_PUBLIC_CLERK_PUBLISHABLE_KEY=pk_test_xxxxxxxxxxxxx CLERK_SECRET_KEY=sk_test_xxxxxxxxxxxxx # Convex Database NEXT_PUBLIC_CONVEX_URL=xxxxxxxxxxxxx.convex.cloud # Groq AI API NEXT_PUBLIC_GROQ_API_KEY=gsk_xxxxxxxxxxxxx ``` ### …