The system in 30 minutes

This is the whole system on one page — every top-level part of the monorepo, how big it is, and where its documentation lives. Read it in order and you have the shape of the platform in a few minutes; follow any link to drop straight into that part's canonical home.

Start here#

New to the repo? Pick the role lens that fits and follow its curated path, or open the global search (press /) from any page.

Products (10)#

The ten product lines (V1–V10). Each is a full product space — overview, decomposed features and architecture, journeys, and (where it has a tracked V*/ue tree) an Unreal engine reference — that composes the shared domains below rather than re-documenting them.

Capability, engine & substrate domains (54 areas · 2,984 projects)#

The heart of the system: the libs/<domain> libraries that products are built from — real-time engine, rendering, worldbuilding, the AI/agent and content substrates, governance, and the platform domains. Each is a capability used across products (§5), with one canonical systems/ home.

• neith library598The libs/neith/ area: 312 Nx projects that make up Neith, Oshun's from-scratch ("sovereign") creative-technology stack — a runtime kernel, a professional DAW…
• iris library262The libs/iris/ area: ~262 Nx libraries that make up Iris, Oshun's AI-assistant domain — the conversation engine, agent runtime, knowledge/RAG, four-tier…
• kalika library194The libs/kalika/ area: ~96 Nx projects making up Oshun's scientific-research platform — a symbolic-algebra core, two Rust compute kernels, a Python/Jupyter…
• aphrodite library187The libs/aphrodite/ area: 184 Nx libraries that make up Aphrodite, the intimate live-performance / adult creator-economy domain — streaming, tipping, haptic…
• maya library163The libs/maya/ area: ~100 Nx projects that make up Maya, the metaverse / world-building domain — a large Rust engine workspace plus a constellation of…
• psyche library134The libs/psyche/ area: ~133 Nx projects that make up the Psyche hyper-realistic AI virtual-assistant platform — a Python service foundation plus a large fleet…
• aglaea library94The libs/aglaea/ area: 93 Nx libraries that make up Aglaea, the AI-powered fashion, beauty, skincare, haircare and personal-styling domain — a TypeScript…
• isis library78The libs/isis/ area: ~75 Nx libraries that make up Isis, the generative factory — the AI/LLM provider plane, the ComfyUI/job orchestration plumbing, and a…
• nyx library75The libs/nyx/ area: ~75 Nx libraries that make up Nyx, Oshun's cosmic observatory domain — astronomical constants, coordinate/time math, real survey catalogs,…
• themis library71The libs/themis/ area: ~71 Nx libraries that split into two systems under one name — a digital-governance platform (DAOs, voting, constitutions, deliberation,…
• veritas library65The libs/veritas/ area: ~64 Nx libraries that build Veritas, an AI-native news agency for Ghana and pan-Africa — from RSS ingestion and Ghanaian-language NLP…
• oshun library59The libs/oshun/ area: ~49 Nx libraries that make up the Oshun product platform — the cross-domain app shell, the canonical domain/substrate adapters, and the…
• yemaya library59The libs/yemaya/ area: 57 Nx libraries that make up Yemaya, Oshun's end-to-end AI movie- and game-production platform — from the agent/orchestration runtime…
• nous library52The libs/nous/ area: ~21 Nx libraries that make up Oshun's in-house AI/ML platform layer — inference runtime, training stack, LLM orchestration, vision, audio…
• euterpe library51The libs/euterpe/ area: ~49 Nx libraries that make up Oshun's music-and-audio domain — everything from music-theory primitives and a pure-Rust DSP engine to…
• athena library42The libs/athena/ area: forty Nx libraries that implement Athena, the maker / workshop-manufacturing domain — parametric CAD, CAM/CNC, materials and craft…
• aja library41The libs/aja/ area: forty Nx libraries that make up the motion-capture → 3D-pose → retargeting → avatar-animation pipeline behind Lilith's embodied…
• bellona library41The libs/bellona/ area: ~40 Nx libraries that make up Bellona, Oshun's engine-bridge / DCC-automation / remote-creative-control-plane domain — the code that…
• aje library39The libs/aje/ area: ~39 Nx libraries that make up Oshun's multi-chain blockchain / Web3 infrastructure stack — from low-level cryptographic primitives and RPC…
• galatea library37The libs/galatea/ area: a humanoid-robotics software stack for fashion-retail and entertainment robots — kinematics, whole-body control, locomotion, embedded…
• calliope library30The libs/calliope/ area: thirty Nx libraries that build and operate autonomous fictional music artists — birthing a persona, giving it a voice, face,…
• phoebe library30The libs/phoebe/ area: four Nx libraries implementing the typed, standards-grounded core of the Phoebe domain — the science and medicine of the brain and mind…
• sophia library29The libs/sophia/ area: ~27 Nx libraries that make up Sophia, the Oshun Knowledge Engine — the research, ingestion, indexing, retrieval, knowledge-graph,…
• asase library28The libs/asase/ area: 28 Nx libraries implementing food & agriculture operations intelligence for Ghana's value chain — a shared domain core plus a dozen…
• metis library28The libs/metis/ area: ~25 Nx libraries that make up Metis, Oshun's AI-powered educational-content platform — the agents, LLM orchestration, assessment…
• shakti library28The libs/shakti/ area: 28 Nx libraries that make up Shakti, a physical-discipline and movement-intelligence platform — yoga, strength, martial arts, combat…
• demeter library27The libs/demeter/ area: twenty-seven Nx libraries that make up the domain logic of Demeter, the home-gardening platform — from the Drizzle/Zod data core and a…
• freya library26The libs/freya/ area: 26 Nx libraries implementing the Freya luxury-goods & fashion intelligence domain — an Africa/Ghana-centred luxury conglomerate model…
• brigid library24The libs/brigid/ area: 24 Nx libraries implementing Brigid, the industrial-automation intelligence domain — deterministic engineering computation packages…
• lakshmi library24The libs/lakshmi/ area: 24 Nx libraries that implement the personal finance intelligence platform — every financial engine (budgeting, tax, investments,…
• nisaba library24The libs/nisaba/ area: ~23 Nx libraries implementing a full digital-philology platform — ancient-script processing, canonical reference systems, textual…
• saraswati library24The libs/saraswati/ area: twenty-four Nx libraries that implement Oshun's advanced-technology / industrial deep-tech domain — manufacturing, energy, mobility,…
• uzume library22The libs/uzume/ area: a live-event / show-control platform built as one core foundation library, a protocol-bridging library, a Rust low-latency protocol…
• annapurna library21The libs/annapurna/ area: twenty-one Nx libraries implementing the autonomous restaurant and culinary operations domain — a @annapurna/core foundation of…
• hathor library21The libs/hathor/ area: twenty Nx libraries that make up Hathor, the "World Builder" domain — engine-agnostic worldbuilding, narrative, and simulation tooling…
• airmid library19The libs/airmid/ area: nineteen Nx libraries that together form an evidence-based phytotherapy and botanical-intelligence platform — from a shared domain core…
• cybele library19The libs/cybele/ area: nineteen Nx libraries implementing the Ghana real estate, construction, and proptech domain — from geodesy and pro-forma math through…
• mnemosyne library19The libs/mnemosyne/ area: nineteen Nx domain libraries that together form a humanistic-learning and cultural-intelligence platform — spaced-repetition memory…
• v3 library19The libs/v3/ area: eighteen Nx libraries that make up V3, the embodied / 3D-metaverse generation of the Oshun platform — the Lilith Commons social-3D shell…
• v6 library19The libs/v6/ area: eighteen Nx libraries that hold the TypeScript + Rust cognition substrate for the Egbe / Orun world — a persistent realm of autonomous AI…
• maat library18The libs/maat/ area: eighteen Nx libraries that make up Maat, the business-intelligence and operating-system layer for a Ghana/Africa-focused industrial…
• oya library18The libs/oya/ area: eighteen Nx projects that make up the platform-side of Oya, the embodied-robotics "hive" domain — a large legacy TypeScript drone core, a…
• kuanyin library17The libs/kuanyin/ area: sixteen Nx libraries implementing Kuan Yin, the compassionate-guardianship moderation domain — intent precognition, mindful friction,…
• v10 library15
• hestia library14The libs/hestia/ area: fourteen Nx libraries that implement Hestia, the culinary-intelligence platform — from a shared domain core through ingredient science,…
• arete library12The libs/arete/ area: twelve Nx libraries that implement the personal-development / life-mastery domain — habits, goals, journaling, time, vision, balance,…
• v9 library12The libs/v9/ area: twelve Nx libraries that build Metis, the "ask a wonder → get a grounded, gated, explorable lesson" learning product — a solve-first lesson…
• seshat library11The libs/seshat/ area: eleven Nx libraries implementing the dwelling arts & craftsmanship domain — spatial harmony, interior design, woodworking, digital…
• gaia library9
• lilith library9The libs/lilith/ area: nine Nx libraries that are the shared building blocks — infra spine, client SDKs, event-bus integration, a cross-domain bridge, and a…
• tara library9The libs/tara/ area: eight Nx libraries that make up the full vertical slice of Tara, the app-store-safe meditation / mindfulness product — from the Prisma…
• meditation library8The libs/meditation/ area: eight content-agnostic Nx libraries that provide the shared meditation engine primitives — timer, breathing, audio player, session…
• v7 library5The libs/v7/ area: the foundation libraries for V7 (Mawu) — a typed contract surface plus three Rust crates (roleplay-character primitives, the realm netcode…
• v8 library4The libs/v8/ area: three Nx libraries that turn a generated detective case into a machine-proven, gated, and provenance-stamped content bundle — V8…

Applications (38 areas · 439 projects)#

Deployable applications under apps/ — the web clients, admin and tenant surfaces, bots, mini-apps, and BFFs that put the domains in front of a user.

• v2 app95
• lilith app75The apps/lilith/ area: ~75 Nx projects that make up Lilith, the consciousness / AI-wisdom product — its clients (web, mobile, desktop, CLI), its BFF edge, ~70…
• nyx app22The apps/nyx/ area: the deliverable surface of the Nyx astronomy domain — one REST/WebSocket backend, four browser front-ends, a data-pipeline worker set, and…
• v5 app19
• aphrodite app17The apps/aphrodite/ area: seventeen Nx applications that make up a live creator-streaming platform — ingest/broadcast, viewing, chat, interactive devices,…
• psyche app17The apps/psyche/ area: a single Next.js 14 admin application — branded Serwaa in its UI — for managing the Psyche AI virtual-assistant / personalization…
• oya app15The apps/oya/ area: fifteen Fastify microservices that make up the control plane of Oya, a multi-embodiment household-robotics "hive" (drones, floor-care…
• veritas app13The apps/veritas/ area: thirteen Nx applications that together form a Ghana-focused, AI-assisted news and media platform — ingestion, NLP, an agent newsroom,…
• bellona app12The apps/bellona/ area: twelve Nx applications that make up Bellona's game-development control plane — engine bridges, a build/export/render pipeline, a…
• oshun app12The apps/oshun/ area: the nine deployable V1 application surfaces of the Oshun platform — one backend-for-frontend, plus the web, admin, tenant, mobile, and…
• maat app10The apps/maat/ area: ten Nx application projects making up Maat, the Ghana-focused conglomerate / business-operations domain — five real Next.js operator…
• iris app9The apps/iris/ area: the Iris AI-assistant product surface — one Hono API service plus the client and developer-facing apps and shared libraries (desktop,…
• v6 app9The apps/v6/ area: the runnable edge of Egbe (the Districts-of-Orun agent society) — a seven-crate Rust backend of authoritative world, cognition, transport,…
• v7 app9The apps/v7/ area: the nine deployable services and tools of the V7 "Mawu" UGC-realm platform — a server-authoritative creator-world runtime, its…
• v4 app8
• hathor app7The apps/hathor/ area: the runnable applications of the Hathor worldbuilding-and-narrative domain — REST APIs for the world model and narrative graph, a…
• v3 app7The apps/v3/ area: the seven deployable applications behind the V3 "Lilith / Saraswati" real-time 3D experience — five Rust control/data-plane services plus…
• isis app6The apps/isis/ area: the deployable surface of the Isis "Generative Factory" — three Hono API services, a BullMQ GPU worker, a Commander CLI, and a Vite/React…
• kalika app6The apps/kalika/ area: the deployable surface of Kalika, a computational mathematics/physics research-notebook workbench — a web client, a CLI, an…
• lakshmi app6The apps/lakshmi/ area: six Nx applications that make up the service tier of the Lakshmi personal-finance-intelligence platform — an HTTP/WebSocket gateway, a…
• yemaya app6The apps/yemaya/ area: the five deployable surfaces of the Yemaya creative production platform — the HTTP API gateway, the BullMQ worker fleet, the CLI, and…
• asase app5The apps/asase/ area: five Nx "application" projects that implement the in-process domain logic for Asase, a Ghana-focused agricultural value-chain platform…
• brigid app5The apps/brigid/ area: five Nx projects that make up Brigid, the Factory Intelligence / industrial-operations app domain — an HTTP API surface plus four…
• cybele app5The apps/cybele/ area: five self-contained Hono application modules that make up the Cybele real-estate / built-environment domain — a construction-projects…
• freya app5The apps/freya/ area: five Nx application projects that implement the customer- and operations-facing application surfaces of the Freya luxury-goods domain —…
• metis app5The apps/metis/ area: the TypeScript/Expo client-and-edge tier for Metis, the Oshun learning platform — a learner web PWA, an operator admin console, a mobile…
• neith app4
• sophia app4The apps/sophia/ area: four runnable Nx applications that turn raw source documents into a searchable, curated research knowledge base — an ingestion service,…
• v10 app4
• aja app3The apps/aja/ area: the deployable surface of Aja, the video-to-animation motion domain — a commander CLI, a Hono motion-AI service, and a Fastify…
• arete app3The apps/arete/ area: three deployable applications — a Fastify REST API, a Vite/React web dashboard, and an Expo/React Native mobile app — that together ship…
• demeter app3The apps/demeter/ area: the three deployable client/server applications of Demeter, a home-gardening platform — a Fastify REST API plus an Expo mobile app and…
• hestia app3The apps/hestia/ area: the three client/server applications — a Fastify REST + GraphQL API, a Next.js web app, and an Expo/React Native mobile app — that make…
• tara app3The apps/tara/ area: the three deployable applications — a Hono REST API, an Expo/React-Native mobile app, and a Next.js PWA — that together ship Tara, the…
• v8 app3The apps/v8/ area: three deployable Nx applications that expose the V8 Ariadne self-authoring detective engine — a case-compiler CLI, the Loom orchestrator…
• infra app2The apps/infra/ area: two deployable Nx applications that operate Oshun's RunPod Serverless GPU plane — one that dispatches GPU jobs and one that monitors the…
• concordia app1
• euterpe app1

Services (0 areas · 0 projects)#

Standalone backend services under services/ — long-running workers and substrates that run outside a single app's request path.

Platform foundations (71 projects)#

The shared foundations every product and domain builds on — libs/shared, libs/oshun, libs/contracts, the BFF, persistence, and auth — documented once and referenced everywhere (§5).

Tooling (10 projects)#

Repo tooling under tools/ — including this documentation center's own generator and freshness/coverage gates.

• tools tooling7
• testing area3