karaalv/mwalika-agent

Agentic AI system powering semantic service discovery and structured interaction for Kenya’s eCitizen platform 🤖 # Mwalika: Agentic AI System for eCitizen Platform **Resource Version**: `1.0.0` This repository contains the core agent engine for **Mwalika**, an AI-powered interface designed to enhance Kenya’s eCitizen platform. Mwalika enables citizens to interact with government services through a conversational, intent-driven system rather than manually navigating complex service flows. ## Context This project forms part of a national government hackathon organised by the **National Intelligence and Research University (NIRU)**. The wider Mwalika system spans multiple repositories: - `mwalika-agent`: Agent logic, retrieval, orchestration, streaming - `mwalika-frontend`: Frontend interface (React) - `mwalika-documentation`: Centralised design, specifications, and technical documentation The documentation repository acts as the single source of truth for architecture decisions, methodology, and system design. ## Purpose of This Repository This repository specifically focuses on: - Retrieval-Augmented Generation (RAG) pipeline - Government service discovery logic - Agent orchestration and reasoning - Event-based streaming architecture - Integration with vector database (Qdrant) - Structured response formatting for frontend rendering It does **not** contain UI implementation or full backend service integrations. Those are handled in their respective repositories. ## Overview Mwalika operates as a general support agent for the eCitizen ecosystem. It assists users by: - Identifying relevant government services based on user intent - Explaining which agency and ministry are responsible for a service - Providing official links to live eCitizen service pages - Structuring responses in a way that supports rich UI rendering (markdown, images, links, etc.) ## Key Features (v1.0.0) ### 1. Semantic Service Discovery - Performs semantic search over the structured government services corpus. - Redirects users to the most relevant official eCitizen service pages. - Provides …