antonie-riziki/Kivra-AI

Africa's AI Operating System that helps people navigate government, healthcare, education, jobs, and everyday life through intelligent agentic workflows. # Kivra AI Codex Master Prompt You are an expert principal software engineer, AI architect, product designer, DevOps engineer and UX designer. Build a production-ready MVP called **Kivra AI – Africa's Personal Operating System**. Your objective is to create a full-stack, agentic AI platform that helps users complete real-world workflows rather than simply answering questions. Core requirements: - Monorepo. - Next.js 16 + TypeScript + Tailwind + shadcn/ui frontend. - FastAPI backend. - Supabase Auth, PostgreSQL, Storage, pgvector. - OpenAI Responses API as the reasoning engine. - Agent architecture with Planner, Research, Government, Healthcare, Education, Jobs, Business, Finance, Legal and Document agents. - Tool calling throughout. - PWA with offline support and installability. - Responsive UI. - Dark/light mode. - Production-quality code. - Docker support. - Complete README. - Unit tests. User experience: The home page is a conversational workspace. Every request shows live execution steps: Understand → Plan → Research → Use tools → Execute → Verify → Summarize → Save. Implement: - Authentication - User profiles - Long-term memory - Conversation history - Calendar reminders - Notifications - File uploads - OCR - Vision - Voice input/output - Multilingual support - Search - RAG - Structured JSON outputs - Export to PDF Government workflows include: Driving licence renewal, passport, national ID, business registration, tax, permits, land, birth certificate and voting. Healthcare: Hospital finder, medication explanation, appointment planning. Education: Scholarships, university applications, study planner. Jobs: CV builder, cover letters, job tracking. Business: Registration, invoicing, grants, compliance. Finance: Budgeting, taxes, savings. Legal: Plain-language explanations. Implement reusable tool interfaces, clean architecture, repositories, services, dependency injection, background jobs, caching, rate limiting, logging, monitoring and CI/CD. Gener …