yasxai/aimazigh-ai

AiMazigh AI is an intelligent chatbot dedicated to the Amazigh community, featuring multilingual support (Tamazight, French, English, Arabic), PDF document analysis, voice interaction, and a curated vocabulary knowledge base — all powered by the Gemini API. # AiMazigh AI 🌍 > **Empowering the Amazigh community with a culturally-aware AI assistant that speaks their language.** ## ✨ Features - **🗣️ Multilingual Chat** — Communicates in Tamazight (Tifinagh/Latin), French, English, and Arabic - **📄 Document Intelligence** — Upload PDFs and get AI-powered answers - **🎙️ Voice Interaction** — Text-to-speech and speech-to-text support - **💬 Conversation Memory** — Persistent chat history with multiple threads - **⚡ Streaming Responses** — Real-time, animated text responses - **📱 Mobile-First** — Responsive design for all devices ## 🌟 Why AiMazigh AI? The Amazigh (Berber) people are one of North Africa's oldest indigenous communities. Yet Tamazight language and culture remain vastly underrepresented in AI technologies. AiMazigh AI bridges this gap with: - A **curated vocabulary knowledge base** (60+ Amazigh terms) - **Tifinagh script support** (ⵜⴰⵎⴰⵣⵉⵖⵜ) - Culturally authentic design inspired by Amazigh art ## 🛠️ Tech Stack | Component | Technology | |-----------|------------| | Frontend | Next.js 14, TypeScript, React, Tailwind CSS | | AI Backend | Gemini API via n8n workflows | | Document Processing | PDF.js | | Voice | Web Speech API | | Deployment | Vercel | ## 🚀 Getting Started ### Prerequisites - Node.js 18+ - n8n instance (self-hosted or cloud) - Gemini API key ### Installation ```bash # Clone the repository git clone github.com cd aimazigh-ai # Install dependencies npm install # Configure environment cp env.example .env.local # Edit .env.local with your n8n webhook URL # Run development server npm run dev ``` Open localhost to see the app. ### n8n Workflow Setup 1. Import the workflow from `n8n-workflows/chat-streaming-workflow.json` 2. Configure your Gemini API credentials 3. Update webhook URL in `.env.local` ## 📁 Project Structure ``` src/ ├── app/ │ ├── api/chat/ # API route for AI integration │ ├── page.tsx # Main chat interfac …