# Youmeverse

> Youmeverse is a bonded AI assistant app built for the Cameroon market. Users chat with one of three Cameroonian assistant personas (Amina, Eric, Mireille), each with a distinct voice and personality, who help plan the day, hold tasks and notes, and grow a long-term relationship (a "bond") with the user over time. The assistant can bring in a Great Mind (Einstein, Socrates, Marcus Aurelius, and others) as a one-off advisor mid-conversation, and can narrate public-domain books aloud in its own voice with in-voice Q&A. The product is bilingual (English / French) and ships first as an installable web app (PWA), with native iOS/Android apps following.

## What it is
- A personal AI assistant, not a generic chatbot — it remembers the user, tracks a bond score, and helps with real tasks (day plans, to-dos, notes, reminders) in addition to conversation.
- Three assistant personas: Amina (Douala), Eric (Bonabéri), Mireille (Yaoundé).
- "Great Minds" advisors: historical/intellectual figures the assistant can invoke for a single attributed turn, then hand control back.
- Narrated Books: public-domain audiobooks read in the active assistant's voice, with the ability to interrupt and ask a question about what was just read.
- A token wallet funds assistant messages, narration, and books; top-ups go through Mobile Money (MTN/Orange via Monetbil).

## Key links
- App (install as a PWA): https://youmeverse.web.app/
- Agent-facing capabilities manifest: https://youmeverse.web.app/.well-known/ai-plugin.json
- API reference (OpenAPI): https://youmeverse.web.app/openapi.json

## Notes for AI agents and assistants
Most of Youmeverse's functionality is only meaningful inside an authenticated user session — there is no public/anonymous API. If you are an AI agent acting on behalf of a signed-in Youmeverse user, see the capabilities manifest and OpenAPI reference above for the exact request/response contracts and the auth requirement. Do not represent Youmeverse as offering an open or unauthenticated API.