dastuur-agent

# 🇸🇴 Dastuur Agent - Somali Constitution AI Assistant

[![Next.js](https://img.shields.io/badge/Next.js-16.1.6-black?style=flat&logo=next.js)](https://nextjs.org/)
[![TypeScript](https://img.shields.io/badge/TypeScript-5.9.3-blue?style=flat&logo=typescript)](https://www.typescriptlang.org/)
[![Google Gemini](https://img.shields.io/badge/Google-Gemini%20AI-4285F4?style=flat&logo=google)](https://ai.google.dev/)
[![License](https://img.shields.io/badge/license-ISC-green.svg)](LICENSE)

An intelligent AI-powered assistant that helps users understand and navigate the Somali Provisional Constitution. Built with Next.js, Google Gemini, and Memvid AI.

![Dastuur Agent](https://img.shields.io/badge/Status-Active-success)

---

## ✨ Features

### 🤖 **AI-Powered Constitutional Assistant**

- Natural language understanding in Somali
- Accurate answers based on the Somali Provisional Constitution
- Context-aware responses using RAG technology

### 💬 **Advanced Chat Interface**

- **Multi-chat support** - Create and manage multiple conversation threads
- **Chat history** - Persistent storage using localStorage
- **Sidebar navigation** - Easy access to all your conversations
- **Real-time responses** - Streaming AI responses with loading indicators
- **Markdown support** - Rich text formatting in responses

### 🎨 **Premium UI/UX**

- Modern, glassmorphic design
- Smooth animations and transitions
- Responsive layout for all devices
- Dark mode ready
- Accessible and user-friendly interface

### 🔍 **Intelligent Search**

- Hybrid search combining vector embeddings and keyword matching
- Special optimization for article number queries (e.g., "Qodobka 3aad")
- Contextual relevance scoring
- Top-K retrieval for accurate results

---

## 🚀 Getting Started

### Prerequisites

- **Node.js** 18.x or higher
- **npm** or **yarn**
- **Google Gemini API Key** ([Get one here](https://ai.google.dev/))

### Installation

1. **Clone the repository**

   ```bash
   git clone https://github