NinoMandelaB/UwenzAi-Public

Public and curated source code of Uwenzai.com — the AI companion app for East Africa. # UwenzAi — East African AI Companion **Sehiya na marafiki wa AI wanaokujua — English & Kiswahili** 🇰🇪🇹🇿🇺🇬 English | Kiswahili (Readme is AI-Generated and might be wrong) --- ## English ### About **East African AI Companion** (UwenzAi) is a full-stack AI companion platform built for East African users. It lets people create, customize, and chat with persistent AI characters that remember past conversations, speak multiple languages, and can proactively reach out — all backed by a real-time, credit-based ("Sparks") usage model designed for East African markets. The platform is built and maintained by **UwenzAi Limited**, based in Nairobi, Kenya. ### Key Features - **Deep character customization** — create fully custom AI companions: gender, age, occupation, personality traits, hobbies, tone of voice, relationship style, clothing style, and detailed appearance (skin tone, eye color, hairstyle/length/color, body type, beard style, and more) across **realistic, anime, and cartoon** visual styles. - **Persistent memory** — conversations are summarized and stored per character using a `pgvector`-backed semantic memory layer, so companions recall context across sessions instead of starting from zero every time. - **Proactive chat** — companions can be configured to send a follow-up message after a period of inactivity, keeping the conversation alive. - **Multi-provider AI backend** — both chat generation and memory embeddings are routed through Cortecs first, with automatic fallback to Mistral, keeping the platform resilient to any single provider's downtime. - **Bilingual UI** — the frontend is fully localized in **English** and **Kiswahili**, with automatic language detection for incoming messages. - **Guest mode** — visitors can chat immediately without creating an account, using a limited free allowance of Sparks credits tied to a local session ID. - **Sparks credits** — a simple, transparent usage-based credit system covers message pairs, character generatio …