Eve library

@yemaya - Creative Production Studio

Other

Revision 1

On this page

Yemaya is Oshun's AAA game and movie production platform, providing project management, asset orchestration, real-time collaboration, and autonomous AI pipelines.

Overview#

Aspect Description
Domain Creative Production
Scope Tag scope:yemaya
API Port 4000
Database Schema yemaya

Capabilities#

  • Project Management: Full production lifecycle management
  • Asset Library: Centralized asset organization and tagging
  • Real-time Collaboration: Multi-user editing with CRDT sync
  • AI Pipelines: Autonomous creative workflows
  • Team Management: Roles, permissions, and organizations
  • Marketplace: Creator asset marketplace
  • Multi-SDK: TypeScript, C++, Python SDKs

Libraries#

text
libs/yemaya/
├── sdk/                 # TypeScript SDK
├── sdk-cpp/             # C++ SDK for engine integration
├── sdk-python/          # Python SDK for pipelines
├── database/            # Prisma schema & utilities
├── projects/            # Project management logic
├── orchestration/       # Workflow orchestration
├── collaboration/       # Real-time collaboration (Yjs/CRDT)
├── autonomous-pipelines/ # Autonomous AI workflows
├── agents/              # AI agent framework
├── asset-library/       # Asset management
├── safety/              # Content moderation
├── marketplace/         # Creator marketplace
├── enterprise/          # Enterprise features
├── community/           # Community features
├── ui/                  # React component library
└── event-handlers/      # Event subscriptions

Quick Start#

Using the SDK#

typescript
import { createYemayaClient } from '@yemaya/sdk';

const yemaya = createYemayaClient({
  baseUrl: process.env.YEMAYA_API_URL || 'http://localhost:4000',
  auth: { type: 'api-key', credentials: process.env.YEMAYA_API_KEY },
});

// Create a project
const project = await yemaya.projects.create({
  name: 'Epic Adventure Game',
  type: 'game',
  description: 'An open-world RPG',
});

// Generate assets via Isis
const job = await yemaya.projects.generateAsset(project.id, {
  type: 'image',
  prompt: 'Fantasy landscape concept art',
});

// Real-time collaboration
const collab = await yemaya.collaboration.connect(project.id);
collab.on('change', (update) => console.log('Project updated'));

Running Locally#

bash
# Start Yemaya API
nx serve yemaya-api

# Start Studio web app
nx serve yemaya-studio-web

# Run tests
nx test @yemaya/sdk

# Build all Yemaya libraries
nx run-many --target=build --projects=tag:scope:yemaya

Applications#

text
apps/yemaya/
├── api/                 # API Gateway (Hono + OpenAPI)
├── studio-web/          # React web application
├── studio-desktop/      # Electron desktop app
├── workers/             # Background job processors
└── cli/                 # Command-line interface

API Endpoints#

Method Endpoint Description
POST /v1/projects Create project
GET /v1/projects/:id Get project details
PUT /v1/projects/:id Update project
DELETE /v1/projects/:id Delete project
POST /v1/projects/:id/assets Upload asset
POST /v1/projects/:id/generate Generate AI asset
POST /v1/projects/:id/export Export to engine
GET /v1/teams List teams
POST /v1/teams Create team
WS /v1/collaboration/:projectId Real-time sync

Events#

Event Description
yemaya.project.created New project created
yemaya.project.updated Project modified
yemaya.asset.uploaded Asset uploaded
yemaya.asset.attached Asset attached from Isis
yemaya.generation.started AI generation started
yemaya.generation.completed AI generation finished
yemaya.collaboration.joined User joined project

Configuration#

bash
# Required
YEMAYA_DATABASE_URL=postgresql://...?schema=yemaya
REDIS_URL=redis://localhost:6379

# Storage
ASSET_BUCKET=oshun-yemaya-assets
ASSET_CDN_URL=https://assets.yemaya.io

# Cross-domain
ISIS_API_URL=http://localhost:4001
BELLONA_API_URL=http://localhost:4005
SOPHIA_API_URL=http://localhost:4003
HATHOR_API_URL=http://localhost:4004

# Collaboration
WEBSOCKET_URL=wss://ws.yemaya.io

Project Types#

Type Description
game Video game project
film Film/video production
animation Animation project
vfx Visual effects
xr VR/AR experience
other Custom project type

Cross-Domain Integration#

Yemaya integrates with all other Oshun domains:

  • Isis: AI-powered asset generation
  • Sophia: Research and reference management
  • Hathor: World and narrative design
  • Bellona: Engine export and builds
typescript
// Generate with Isis
const asset = await yemaya.projects.generateAsset(projectId, {
  type: 'image',
  prompt: 'Concept art',
});

// Search with Sophia
const refs = await yemaya.research.search({
  query: 'medieval architecture',
});

// Create world with Hathor
const world = await yemaya.worldbuilding.createWorld({
  name: 'Game World',
});

// Export with Bellona
const build = await yemaya.projects.export(projectId, {
  engine: 'godot',
});

Local Development#

Start the full development environment:

bash
# Start infrastructure (PostgreSQL, Redis, MinIO)
docker compose -f docker/docker-compose.dev.yml up -d

# Run database migrations
pnpm nx run @yemaya/database:prisma:migrate:dev

# Start the API
pnpm nx serve yemaya-api

# Start Studio web app
pnpm nx serve yemaya-studio-web

See CLAUDE.md for detailed local development setup.