# Oshun Domains > **Canonical machine registry: [`domains.json`](domains.json)** (audit R-19). > Owner, npm scope, boundary tag, paths, and status per domain live there — > commitlint and CODEOWNERS are generated from it, and > `tools/domains/check-registry.mjs` guards it in CI. This file is the > human-readable overview; when the two disagree, `domains.json` wins. A comprehensive registry of all domains within the Oshun monorepo. Oshun is a unified platform following domain-driven design, where each domain operates as a bounded context with its own libraries, data ownership, and responsibilities, communicating with other domains through well-defined contracts and an event-driven bus (Redis Streams) over shared infrastructure (PostgreSQL, Redis, MinIO, BullMQ). For the auditable mapping from every `TODOS/` phase to the responsible domain documentation, see `docs/domains/README.md`. The `TODOS/` files remain the task-level implementation checklist; `docs/domains/` captures domain ownership, current package locations, planned package scopes, cross-domain contracts, and operational expectations. --- ## Core Domains These six domains form the architectural backbone of the Oshun platform, as defined in the production architecture. ### Yemaya — Creative Production Studio AAA game and movie production platform providing project management, asset orchestration, real-time collaboration, and autonomous production pipelines. Yemaya is the primary creative workspace where directors, artists, and producers manage projects from concept to final delivery. It consumes generated assets from Isis, narrative structures from Hathor, research material from Sophia, and exports through Bellona to external engines. ### Lilith — Consciousness & Meditation Experience End-user platform for meditation, spiritual exploration, and consciousness development. Lilith manages user sessions, guided meditations, courses, conversations, and personalized progress tracking. It shares meditation infrastructure with Tara (the App Store-safe variant) through the shared Meditation libraries, and integrates with Iris for conversational AI and Sophia for knowledge retrieval. ### Isis — Generative AI Factory AI-powered asset generation engine handling image, video, audio, 3D model, and multi-modal content generation with full provenance tracking. Isis manages GPU workflows (including ComfyUI integration), quality gates, and generation job orchestration. It serves as the generative backbone for Yemaya's production pipelines and feeds assets into Bellona for engine-specific export. ### Sophia — Research & Knowledge Platform Knowledge management and retrieval-augmented generation (RAG) infrastructure providing document ingestion, embedding generation, citation management, knowledge graphs, and semantic search. Sophia serves as the intelligence layer for the entire ecosystem — Hathor queries it for lore consistency, Iris uses it for grounded conversational responses, Metis leverages it for educational content, and Veritas relies on it for fact-checking. ### Hathor — Worldbuilding & Narrative Engine Story structures, world simulation, NPC AI, quest systems, and narrative branching engine. Hathor manages the creative universe — timelines, lore, character arcs, dialogue trees, and procedural narrative generation. It integrates deeply with Sophia for lore consistency checking, Bellona for exporting narrative data to game engines, and Yemaya for production-level storytelling workflows. **Facade (shim) libraries.** `libs/hathor/{characters,world,timeline,quests}` are deliberately thin: each owns exactly one engine-facing packet contract and holds no domain logic. Each shim carries a `facade-guard.spec.ts` asserting a source line budget and public-entry-point-only imports, plus golden-file contract tests for its packet shape — new behavior belongs in the owning library, never in the shim. | Facade | Owns | Logic actually lives in | | -------------------- | ----------------------------- | ---------------------------------------------------------------- | | `@hathor/characters` | CGI character packet | `@hathor/domain-models` (character) + `@hathor/pre-production` | | `@hathor/world` | CGI scene definition | `@hathor/domain-models` (culture, geography, location, timeline) | | `@hathor/timeline` | Narrative scene-order packet | `@hathor/domain-models` (timeline) | | `@hathor/quests` | Quest scene-dependency packet | `@hathor/narrative` (quest) | ### Bellona — Build & Engine Bridge Engine integration and asset export platform providing adapters for Godot, Unreal, Unity, Blender, and Houdini, plus OpenUSD pipeline support, MetaHuman integration, and motion capture tooling. Bellona is the bridge between Oshun's internal creative pipeline and external game/film engines, translating assets, scenes, and gameplay systems into engine-native formats. --- ## AI & Conversational Intelligence ### Iris — Universal Intelligent Assistant Multi-provider LLM integration platform (Anthropic, Google, OpenAI, local models) providing conversation orchestration, RAG pipelines, voice interfaces, and agent capabilities. Iris is the conversational AI layer that powers intelligent assistants across all Oshun services, drawing on Sophia for knowledge and Psyche for personality and emotional context. ### Psyche — Avatar & Behavioral Intelligence Hyper-realistic AI virtual assistant platform encompassing avatar systems, emotional intelligence, behavior prediction, memory management, speech recognition, translation, and meeting integration (Zoom, etc.). Psyche provides the embodied AI layer — facial expressions, voice synthesis, personality modeling — that gives Oshun's AI assistants lifelike presence across video calls, virtual environments, and interactive experiences. ### Nous — AI Model Infrastructure Low-level AI model platform providing LLM, audio, vision, and training infrastructure. Nous serves as the foundational ML layer that other AI-consuming domains (Iris, Psyche, Isis) build upon for model hosting, inference, and fine-tuning capabilities. Late roadmap phases extend Nous with neural world models, mechanistic interpretability, continual learning, autonomous research agents, and the cooperative bargaining optimization primitives consumed by the Concordia domain. --- ## Learning & Knowledge ### Metis — Adaptive Learning & Education AI-powered educational content platform providing adaptive learning paths, course management, assessment systems, AI tutoring, and knowledge graphs. Metis is the port of the Minerva Python system to TypeScript, delivering personalized education experiences that leverage Sophia's knowledge base and Iris's conversational capabilities. ### Mnemosyne — Language & Cultural Heritage Classical education, language learning, linguistic analysis, mythology, and heritage preservation platform. Mnemosyne provides polyglot language tools, pronunciation engines, immersion experiences, and cultural knowledge graphs, serving as the humanities and cultural intelligence layer of the ecosystem. ### Nisaba — Textual Analysis & Digital Humanities Ancient text analysis and cross-tradition scholarly research platform supporting literary criticism, paleography, comparative literature, geotemporal analysis, and corpus management. Nisaba handles specialized academic workflows for working with historical and ancient texts across writing systems (Cuneiform, Egyptian, Semitic, and others). --- ## Scientific Research ### Kalika — Mathematics, Physics & Materials Research Platform Scientific research platform providing symbolic mathematics, computer algebra, formal verification, numerical computation, computational notebooks, research agents, theoretical physics, materials science, autonomous experimentation, and reproducible scientific compute operations. Kalika is implemented under `apps/kalika/*` and `libs/kalika/*`, with Phases 99-131 defining the complete research and materials roadmap. --- ## Creative & Media Production ### Calliope — AI Artist Creation & Content Platform Autonomous AI artist persona creation, management, and career arc platform spanning content creation, music generation, brand intelligence, and creative evolution. Calliope enables the creation and management of AI-driven creative entities with their own artistic identities, production capabilities, and fan communities. ### Euterpe — Music & Sonic Creation Comprehensive music platform covering creation, distribution, licensing, collaboration, music theory education, and podcast publishing. Euterpe provides the full music lifecycle — from composition and recording through mastering, royalty management, and distribution — integrating with Calliope for AI artist workflows and Themis for copyright protection. ### Uzume — Live Performance & Media Production Real-time media production and live event platform providing broadcast systems, streaming infrastructure, protocol engines, and event management. Uzume handles everything from lighting design and audio engineering to video switching and stage automation for live performances and broadcast productions. ### Veritas — Journalism & Content Verification AI-powered journalism platform providing fact-checking, article generation, bias detection, claims analysis, and RAG-based investigative tools. Veritas automates and augments journalistic workflows with AI agents while maintaining rigorous verification standards, drawing on Sophia's knowledge infrastructure for source validation. --- ## Governance, Ethics & Protection ### Themis — Democratic Governance & IP Protection Universal governance intelligence platform encompassing democratic decision-making, constitutional systems, DAO tooling, deliberation frameworks, voting systems, and originality verification. Themis provides both community governance infrastructure and cross-media IP protection (music, visual art, video, 3D, text) to ensure fair attribution and copyright compliance across the ecosystem. ### Kuanyin — Compassionate Guardianship & Moderation Restorative justice, community safety, performer protection, harm prevention, and rehabilitation platform. Kuanyin provides the ethical moderation layer for the ecosystem — mindful friction, community harmony systems, and dharma analytics — with particular focus on protecting vulnerable participants in Aphrodite and other community-facing domains. ### Maat — Business Intelligence & Finance Financial intelligence, compliance, capital management, supply chain analysis, workforce management, risk assessment, and strategic planning platform. Maat provides the business operations backbone, enabling data-driven decision-making and regulatory compliance across all commercially-oriented domains. ### Concordia — Cooperative Bargaining & Negotiation Intelligence Planned cross-domain mediation and negotiation substrate named for Concordia, the Roman goddess/personification of concord, agreement, and social harmony. It supports disputes, procurement, governance compromise, restorative justice, creative royalty agreements, marketplace conflicts, and agent-to-agent contracts. Concordia coordinates private intake, preference inference, Pareto/Nash/coalition search, agreement DSL validation, review routing, settlement lifecycle, and audit export while leaving legal policy, community safety, procurement authority, smart-contract execution, and user-facing assistant flows with their owning domains. --- ## Physical World & Embodiment ### Galatea — Humanoid Robotics & Embodied AI Robotics control platform for humanoid movement, kinematics, locomotion, whole-body control, pose estimation, fleet management, and safety systems. Galatea bridges Oshun's AI capabilities into physical embodiment, enabling robotic avatars and autonomous humanoid systems that can leverage Psyche's behavioral intelligence. ### Aja — Motion Capture & Animation Motion capture, pose estimation, animation retargeting, human mesh recovery, and motion quality assessment platform. Aja provides the motion intelligence layer — capturing, analyzing, and retargeting human movement for use in Bellona's engine exports, Yemaya's production pipelines, and Galatea's robotic embodiment. ### Shakti — Physical Discipline & Movement Intelligence Yoga, martial arts, fitness, combat sports, body analysis, and physical training platform. Shakti provides form analysis, biometric tracking, instructor tools, and certification management for movement-based disciplines, integrating with Aja for motion analysis and Psyche for personalized coaching. ### Nike — Legacy Fitness Instruction Scope Legacy planned physical wellness and fitness instruction scope from Phase 15. Nike currently has no `apps/nike` or `libs/nike` workspace packages; Phase 15 features were historically implemented through Lilith fitness paths, while Shakti is the active named domain for physical discipline and movement intelligence. --- ## Lifestyle & Wellness ### Aglaea — Fashion & Beauty Intelligence Fashion recommendations, skincare analysis, body analysis, beauty forecasting, virtual try-on, color analysis, and wardrobe management platform. Aglaea provides AI-driven personal styling, trend forecasting, and augmented reality beauty experiences, leveraging Isis for generative imagery and Psyche for personalized avatar visualization. ### Airmid — Herbalism & Botanical Intelligence Herbal medicine, phytochemistry, clinical evidence, botanical interactions, ethnobotany, drug docking, microbiome analysis, and safety assessment platform. Airmid provides scientifically-grounded botanical intelligence — from traditional formulations to modern phytochemical analysis — integrating with Sophia for research evidence and Hestia for culinary herb applications. ### Hestia — Food, Cooking & Home Intelligence Recipe intelligence, nutrition analysis, meal planning, ingredient management, cooking education, and smart kitchen integration platform. Hestia provides the culinary and domestic intelligence layer, connecting with Demeter for farm-to-table ingredient sourcing and Airmid for nutritional and herbal knowledge. ### Tara — Meditation Platform (App Store) App Store-safe meditation platform built on the shared Meditation libraries, providing content delivery, analytics, and monitoring. Tara is the consumer-facing meditation app that shares core infrastructure with Lilith but operates within mainstream app distribution constraints. ### Meditation — Shared Meditation Infrastructure Core meditation session types, audio player engine, breathing exercises, progress tracking, and offline support shared between Tara and Lilith. This is not a standalone domain but a shared library layer that ensures consistent meditation experiences across both platforms. ### Arete — AI Coaching & Personal Development Goal tracking, habit formation, AI coaching, gamification, journaling, time management, and vision planning platform. Arete provides the personal development intelligence layer, integrating with Iris for conversational coaching, Psyche for behavioral modeling, and Shakti for physical discipline tracking. --- ## Agriculture & Sustainability ### Demeter — Urban Agriculture & Hydroponics Crop cultivation, hydroponics management, agricultural automation, weather intelligence, and inventory management platform. Demeter provides the agricultural technology layer for urban farming and controlled environment agriculture, integrating with sensor networks, climate data, and Hestia for produce-to-plate workflows. ### Gaia — Weather & Climate ML Planned sovereign weather and climate ML platform for GraphCast-class deterministic forecasting, GenCast-class probabilistic ensembles, tropical cyclone prediction, radar/satellite nowcasting, climate emulation, downscaling, forecast serving, CAP alerts, and downstream weather-impact APIs. Gaia owns the `@gaia/*` package namespace and planned `libs/gaia/*` libraries while Asase, Demeter, Oya, Cybele, Galatea, Lakshmi, Uzume, Aphrodite, Veritas, Kuanyin, and Oshun own their domain-specific decisions made from Gaia products. ### Asase — Food & Agriculture Operations (Ghana) Ghana-focused food value chain platform covering crop management, livestock operations, and agricultural infrastructure. Asase provides localized agricultural intelligence for the Ghanaian market, complementing Demeter's broader agricultural capabilities with region-specific crop data, supply chains, and operational patterns. --- ## Entertainment & Virtual Worlds ### Maya — Game Engine & Virtual Universe Game engine abstraction, modding tools, procedural universe generation, and metaverse infrastructure platform. Maya provides the virtual world layer — engine core, game development toolkit, client infrastructure, and modding governance (Forge) — integrating with Bellona for engine bridging, Hathor for narrative content, and Isis for procedural asset generation. ### Aphrodite — Adult Wellness & Intimacy Platform Adult content streaming, intimacy technology, consent systems, haptic device protocols, performer support, and safety intelligence platform. Aphrodite is the largest specialized domain, providing age-verified adult experiences with rigorous consent engineering, 2257 compliance, and performer autonomy systems, protected by Kuanyin's guardianship layer. ### Nyx — Cosmic Observatory & Astronomy Astronomy calculations, celestial catalogs, orbital mechanics, telescope control, ephemeris computation, and space exploration simulation platform. Nyx provides scientifically accurate astronomical intelligence for education, exploration, and integration into Maya's virtual universe environments. --- ## Blockchain & Web3 ### Aje — Blockchain & Web3 Infrastructure DeFi protocols, gaming on-chain systems, NFT tooling, cross-chain bridges, smart contracts, oracle integration, and governance token infrastructure. Aje provides the Web3 layer for the ecosystem, enabling token economics, fan tokens, on-chain asset provenance, and decentralized governance mechanisms that integrate with Themis's DAO systems. --- ## Design & Craft ### Seshat — Design & Craft Intelligence Design systems, craft and fabrication tools, smart manufacturing, sustainability analysis, and maker education platform. Seshat provides the design-to- fabrication pipeline — from digital design through physical production — integrating with Isis for generative design and Yemaya for production asset management. ### Athena — Maker Intelligence & Workshop Operations Planned maker and workshop operating system covering CAD/CAM, material science, woodcraft, metalcraft, glasswork, luthiery, smart furniture, firmware, electronics, CNC, additive manufacturing, robotics, simulation, workshop operations, MES, supply chain, quality, ERP, marketplace, sustainability, aftercare, compliance, academy, AI, packaging, restoration, and factory-biome intelligence. --- ## Commerce, Industry & Advanced Technology ### Freya — Luxury Goods & Fashion Intelligence Luxury goods and fashion business platform covering fashion design, textiles, beauty, brand operations, ecommerce, manufacturing, retail, academy, jewelry, market intelligence, financials, and connectors. Freya is the supply-side business domain that complements Aglaea's consumer-facing personal styling and beauty intelligence. ### Cybele — Real Estate & Construction Intelligence Built-environment intelligence platform covering site analysis, architectural design and BIM, construction project management, property portfolio management, prefab, building materials, real-estate finance, industrial parks, hospitality property, civil infrastructure, PropTech, market intelligence, and financials. ### Brigid — Industrial Automation Intelligence Industrial automation platform covering factory automation, custom machine building, industrial AI, energy systems, water and waste treatment, refrigeration/HVAC, weighing and calibration, technical training, maintenance, collaborative and warehouse robotics, digital twins, OT cybersecurity, packaging, agricultural mechanization, mining, oil and gas, supply chain, and industrial materials. ### Saraswati — Advanced Technology Intelligence Advanced technology domain covering electric vehicles, batteries, solar product manufacturing, IoT and smart-city systems, electronics manufacturing, pharmaceutical manufacturing, robotics, drone services, telecom infrastructure, medical devices, fintech hardware, security systems, e-waste, additive manufacturing, satellite communications, market intelligence, and financials. ### Lakshmi — Personal Finance Intelligence Planned personal and household finance domain covering account aggregation, transaction intelligence, budgeting, investments, tax, debt, credit, retirement, insurance, estate planning, real-estate finance, crypto, income, goals, behavioral finance, household and business finance, security, reporting, integrations, and alerts. ### Annapurna — Restaurant & Culinary Operations Intelligence Planned commercial food-service domain covering culinary intelligence, menu engineering, restaurant design, kitchen robotics, front-of-house operations, delivery, ghost kitchens, chains/franchises, commissaries, procurement, food safety, staff, finance, customer intelligence, sustainability, AI, and cross-domain integration. --- ## Platform Infrastructure ### Shared — Foundation Libraries Domain-agnostic infrastructure providing authentication, caching, database utilities, logging, metrics, error handling, configuration, event bus, GPU dispatching, health checks, and HTTP client libraries. Shared is the bedrock layer that all domains depend on for common concerns, ensuring consistent patterns across the entire monorepo. ### Neith — Web & Graphics Stack Low-level web framework, renderer, cryptographic operations, networking, and UI primitives. Neith provides the sovereign technology stack — a from-scratch web and graphics infrastructure that the platform can optionally build upon for maximum control over the rendering and networking pipeline. ### Oshun — Domain Registry & Platform Shell Central domain registry, application shell (desktop and assistant), and cross-domain integration points. The Oshun meta-domain is the orchestration layer that ties all other domains together — routing between domain UIs, managing the unified application shell, and providing integration bridges (embodiment-psyche, memory-iris, evidence-sophia). ### Contracts — Cross-Domain Type Contracts Shared TypeScript type definitions and schemas that define the communication boundaries between domains. Contracts ensure type-safe inter-domain communication without creating direct dependencies, currently covering Iris, Maat, Psyche, and Veritas interfaces. ### OpenAPI — API Specifications & Tooling OpenAPI specification management and code generation tooling for maintaining consistent, documented REST APIs across all domain services. ### Proto — Protocol Buffers & Code Generation Protocol buffer definitions and generated code for gRPC-based inter-service communication, providing strongly-typed, high-performance RPC contracts between domain services. ### Oya — Drone & Autonomous Aerial Systems Drone and autonomous aerial systems domain. Oya currently contains `@oya/core`, which defines branded IDs, coordinate frames, 3D math, flight-state enums, telemetry schemas, camera/payload/weather types, geofencing, and mission planning primitives. The planned expansion covers telemetry ingestion, mission execution, fleet management, swarm coordination, safety, photogrammetry, MAVLink/PX4/ArduPilot protocol adapters, and drone data persistence. --- ## External Projects These projects exist at the repository root as separate codebases being integrated into the Oshun ecosystem. ### Minerva — Educational Content Generation (Python) Python-based educational content generation system focused on Ghana K-12 curriculum. Minerva is the original Python implementation that Metis ports to TypeScript for integration into the Oshun monorepo. ### Serwaa — Backend Services & Infrastructure Microservices, API implementations, and infrastructure-as-code for Psyche's hyper-realistic AI virtual assistant platform. Serwaa contains the backend service layer for Psyche's video conferencing and computer-use capabilities. ### Yaa — Autonomous AI News Agency (Ghana) Ghana-focused autonomous AI-powered news agency with its own implementation phases. Yaa provides localized AI journalism capabilities that integrate with Veritas's broader fact-checking and content verification infrastructure.