Canonical source: the canonical features document for this domain is
deep-dive/features.md, rendered in the docs center. This file is its operational companion (service topology, APIs, schemas, runtime detail) — reconciled by linking, not duplicated (§2, §13).
Creative Production Studio Platform for Film, Games, Animation, and Interactive Entertainment
Yemaya is a comprehensive creative production platform that unifies project management, asset management, engine integration, AI-assisted workflows, and real-time collaboration into a single ecosystem. From pre-production planning to final export, Yemaya supports the complete creative pipeline for AAA studios, indie developers, solo creators, film production houses, and educational institutions.
Table of Contents#
- Executive Summary
- Project Management
- Asset Management
- Script and Storyboard Management
- Character and World Design
- Engine Integration
- AI-Assisted and Autonomous Production
- Real-Time Collaboration
- Production Management
- Gameplay and NPC Systems
- Virtual and Extended Reality
- Plugin Marketplace and SDKs
- Organizations and Enterprise
- Content Safety and Compliance
- Community and Showcase
- Platform Availability
- Access Tiers
- Integration Features
Executive Summary#
Yemaya addresses the fundamental challenge of creative production: the tools are fragmented. Studios juggle dozens of applications for scripting, storyboarding, asset management, 3D modeling, rendering, collaboration, and project management. Yemaya brings all of these into one platform with three modes of operation:
| Mode | Description |
|---|---|
| Human-Driven | Traditional manual workflows with professional tools |
| AI-Assisted | AI suggestions with human-in-the-loop approval |
| Fully Autonomous | AI agents execute complete production pipelines |
Target Users#
| User Type | Primary Use Cases |
|---|---|
| AAA Studios | Large-scale blockbuster game and film production |
| Indie Developers | Small team projects with professional output |
| Solo Creators | Individual artists leveraging AI assistance |
| Film Production Houses | Feature films, commercials, virtual production |
| Educational Institutions | Teaching game and film development |
Key Numbers#
| Metric | Value |
|---|---|
| API Route Groups | 44 resource groups |
| Libraries | 24 domain modules |
| Asset Types | 15 supported formats |
| Engine Integrations | 5 (Blender, Godot, Unreal, Houdini, DaVinci) |
| SDK Languages | 3 (TypeScript, C++, Python) |
| Worker Types | 5 background processing types |
| Project Types | 6 (Film, Game, Animation, etc.) |
Project Management#
Project Creation and Types#
Users create projects organized by production type:
- Film -- Feature films, short films, documentaries, and commercials
- Game -- Video games across all genres and platforms
- Animation -- 2D and 3D animated content, motion graphics
- Commercial -- Advertising and promotional content
- Music Video -- Music video production
- Documentary -- Documentary filmmaking
Project Workspaces#
Each project provides a complete workspace:
- Project Dashboard -- Overview of progress, recent activity, team members, and key milestones
- Version Control -- Full version history for all project assets and configuration with rollback capability
- Activity Feeds -- Real-time activity stream showing all changes, uploads, comments, and status updates
- Project Settings -- Configure project metadata, visibility, engine integration, and export targets
Team Collaboration#
- Member Management -- Invite and manage project team members with role assignments
- Role-Based Access -- Five project roles with escalating permissions: Viewer, Contributor, Editor, Admin, Owner
- Activity Logging -- Complete audit trail of every action taken in the project
Asset Management#
15 Asset Types#
Yemaya manages every type of creative asset:
| Category | Asset Types |
|---|---|
| Visual | Image, Video, 3D Model, Texture, Material, Font |
| Audio | Audio (music, SFX, dialogue, ambient) |
| Narrative | Document, Script, Storyboard |
| Design | Character Design, Environment Design |
| Production | Animation, VFX |
Asset Pipeline#
- Upload and Ingest -- Drag-and-drop upload with automatic format detection and validation
- Automatic Metadata Extraction -- Dimensions, duration, format, codec, color space, and other technical metadata extracted on upload
- Thumbnail Generation -- Automatic preview thumbnail generation for all visual asset types
- Checksum Verification -- SHA-256 integrity verification for all uploaded assets
- Asset Versioning -- Upload new versions of existing assets while maintaining full version history
- Usage Tracking -- Track where each asset is used across projects, scenes, and compositions
Organization#
- Hierarchical Folders -- Organize assets into nested folder structures within projects
- Tagging -- Apply custom tags for flexible categorization and discovery
- Search -- Full-text search across asset names, descriptions, tags, and metadata
- Filtering -- Filter by asset type, format, date, size, and custom metadata
- Asset Library -- Curated asset library views for browsing and distributing reusable assets across projects
Script and Storyboard Management#
Screenplay Tools#
- Script Editor -- Full-featured screenplay editor with industry-standard formatting
- Script Management -- Create, edit, version, and collaborate on scripts within projects
- AI Script Analysis -- AI-powered analysis that extracts characters, locations, scenes, props, and dialogue from scripts
Storyboard Creation#
- Visual Storyboarding -- Create storyboard sequences with shot compositions, camera angles, and timing
- Shot Planning -- Define shots with type, angle, movement, framing, and duration
- Storyboard-to-Pipeline -- Feed storyboard data directly into production pipelines for asset generation and scene assembly
Character and World Design#
Character Design System#
- Character Profiles -- Rich character profiles with appearance, backstory, personality traits, and visual references
- AI Character Generation -- Generate character designs from text descriptions using AI
- Character Sheet Export -- Export character reference sheets for production teams
World and Location Design#
- World Builder -- Design and document worlds with geography, culture, history, and visual style
- Location Management -- Define locations with descriptions, reference images, and technical requirements for production
- Location Scouting -- Digital location scouting tools for virtual and physical production
Engine Integration#
Blender Integration#
Full bidirectional integration with Blender:
- Scene Import/Export -- Import and export complete Blender scenes with materials, lighting, and camera settings
- Material Sync -- Synchronize materials and shaders between Yemaya asset library and Blender projects
- Render Job Submission -- Submit Blender render jobs from Yemaya and track progress
- Asset Pipeline -- Push assets directly from Yemaya to Blender project directories
Godot Integration#
- Project Sync -- Bidirectional synchronization of Godot project files and assets
- Scene Management -- Create and manage Godot scenes from Yemaya
- Export Management -- Configure and trigger Godot exports for multiple platforms
Unreal Engine Integration#
- Level Streaming -- Manage Unreal Engine level streaming configurations from Yemaya
- Asset Import -- Push assets from Yemaya directly into Unreal Engine content browser
- Niagara VFX -- Configure and manage Niagara particle effects
- Build Pipeline -- Trigger and monitor Unreal Engine builds
Houdini Integration#
- Procedural Generation -- Leverage Houdini's procedural generation capabilities from within Yemaya
- Simulation Export -- Export Houdini simulation data for use in other engines
DaVinci Resolve Integration (via SDK)#
- Color Grading -- Synchronize color grading projects between Yemaya and DaVinci Resolve
- Editing Timeline Sync -- Bidirectional editing timeline synchronization
- Media Management -- Manage media assets shared between Yemaya and Resolve
AI-Assisted and Autonomous Production#
Multi-Agent Orchestration#
Yemaya's AI system uses a multi-agent architecture (based on LangGraph and CrewAI patterns):
- Agent Management -- Deploy, configure, and monitor AI agents from the Yemaya dashboard
- Agent Types -- Specialized agents for different production tasks (scripting, storyboarding, asset generation, review, etc.)
- Human-in-the-Loop -- All AI actions can require human approval before execution
- Agent Collaboration -- Agents can collaborate on complex tasks, passing work products between them
AI Content Generation#
- Text Generation -- Script drafts, dialogue, descriptions, and marketing copy
- Image Generation -- Concept art, character designs, environment art, and texture generation via Isis
- 3D Model Generation -- AI-generated 3D models from text or image descriptions via Isis
- Gaussian Splatting -- NeRF and Gaussian splatting for 3D scene reconstruction
- Audio Generation -- Sound effects, ambient audio, and music generation via Isis
- NPC Behavior Generation -- AI-generated NPC behavior trees and dialogue systems
Autonomous Production Pipelines#
Pre-built and customizable autonomous pipelines that execute entire production workflows:
Film Pipeline#
End-to-end autonomous film production:
- Script Analysis -- AI analyzes the script to extract characters, locations, scenes, and props (via Sophia)
- Visual Research -- AI researches visual references and mood boards for the chosen style (via Sophia)
- Character Creation -- AI generates character designs based on script analysis (via Hathor)
- Location Creation -- AI generates environment designs from script locations (via Hathor)
- 3D Asset Generation -- AI generates 3D character and environment assets (via Isis)
- Audio Generation -- AI generates sound effects and music (via Isis)
- Scene Assembly -- Assets are assembled into scenes in the target engine (via Bellona)
- Export -- Final rendering and export in target formats and platforms (via Bellona)
- Review -- Automated or manual review of final output
Game Pipeline#
Autonomous game production following similar stages with game-specific additions:
- Game Design Analysis -- AI analyzes game design documents
- World Generation -- Procedural and AI-assisted world creation
- Gameplay Systems -- AI-generated gameplay mechanics and balance
- Asset Generation -- Characters, environments, items, and UI assets
- Level Assembly -- Automated level design and assembly
- Testing -- Automated playtesting and QA
Pipeline Configuration#
- Quality Presets -- Draft, Preview, Production, and Final quality levels with appropriate resolution, detail, and rendering settings
- Step Dependencies -- Define dependencies between pipeline steps with automatic dependency resolution
- Conditional Execution -- Steps can execute conditionally based on variables and prior step results
- Retry Logic -- Configurable retry count and delay for failed steps
- Timeout Control -- Per-step timeout configuration
- Variable Injection -- Pass variables into pipeline execution for customization
Pipeline Templates#
- Built-In Templates -- Pre-configured pipeline templates for common production workflows
- Custom Templates -- Create and share custom pipeline templates with configurable variables
- Template Marketplace -- Discover and use community-created pipeline templates
Real-Time Collaboration#
Multi-User Presence#
- User Presence -- See who is currently active in the project, what document or asset they are viewing, and their current activity
- Activity Status -- Idle, active, typing, selecting, dragging, scrolling, and other activity states with automatic detection
- Focus Context -- See which document, asset, scene, or timeline each collaborator is focused on
CRDT-Based Document Sync#
Conflict-free collaborative editing powered by Yjs CRDTs:
- Real-Time Co-Editing -- Multiple users can edit the same document simultaneously with automatic conflict resolution
- CRDT Text -- Collaborative text editing with character-level granularity
- CRDT Arrays and Maps -- Collaborative data structures for complex document types
- Offline Support -- Edit documents offline with automatic sync and conflict resolution when reconnecting
- Selective Sync -- Subscribe to specific regions of a document to reduce bandwidth for large assets
Cursor and Selection Sharing#
- Remote Cursors -- See other users' cursor positions in real-time with color-coded identifiers
- Selection Sharing -- See what text or regions other users have selected
- Typing Indicators -- Real-time typing indicators showing when collaborators are actively editing
- Name Tags -- User name tags displayed at cursor positions for easy identification
Voice and Video Communication#
Built-in communication tools for production teams:
- Voice Calls -- Peer-to-peer voice calls within the studio
- Video Calls -- WebRTC-based video conferencing for remote collaboration
- Screen Sharing -- Share your screen during production sessions
- Call Recording -- Record voice/video sessions for review and reference
Video Collaboration Integrations#
Integration with industry-standard video review tools:
- Evercast -- Real-time video collaboration for color grading and editing sessions
- Frame.io -- Video review and approval workflows
- Louper -- VFX review and feedback
- SyncDNA -- Audio/video synchronization
Production Management Integrations#
- ShotGrid -- Autodesk ShotGrid integration for VFX pipeline management
- Miro -- Visual collaboration boards for pre-production planning
- Notion -- Documentation and knowledge management
- Slack -- Team messaging and notification integration
- Discord -- Community and team communication
Advanced Collaboration Features#
- Undo/Redo Manager -- Collaborative undo/redo with per-user undo stacks and scoped operations
- Binary Protocol Optimizer -- Optimized binary protocol for real-time sync with configurable compression algorithms
- Bandwidth Management -- Adaptive sync based on available bandwidth with configurable bandwidth limits
Production Management#
Scheduling#
- Production Schedules -- Create and manage production schedules with milestones, deadlines, and task dependencies
- AI-Optimized Scheduling -- AI suggests optimal task ordering and resource allocation
- Schedule Sharing -- Share schedules with team members and external stakeholders
- Schedule Optimization -- AI analyzes schedules for bottlenecks and suggests improvements
- Call Sheet Generation -- Automated call sheet creation for film and commercial production
Budget Management#
- Budget Creation -- Create project budgets with line items organized by department and category
- Multi-Currency Support -- Budget tracking in multiple currencies with exchange rate conversion
- Budget Templates -- Pre-built budget templates for different project types
- Budget Line Items -- Granular budget tracking at the line-item level
- Cost Prediction -- AI-powered cost prediction based on historical project data and current scope
- Variance Tracking -- Track budget variance (planned vs. actual) across all categories
Crew Management#
- Crew Database -- Maintain a database of crew members with roles, skills, availability, and rate cards
- Crew Assignment -- Assign crew members to specific production days, roles, and tasks
- Availability Management -- Track crew availability and scheduling conflicts
Location Management#
- Location Database -- Digital location library with photos, coordinates, availability, and logistics
- Virtual Location Scouting -- Browse and scout locations virtually using reference imagery and 3D scans
Gameplay and NPC Systems#
Gameplay Design#
- Gameplay Mechanics -- Define and document game mechanics, rules, and systems
- Game Balance -- AI-assisted game balance analysis and tuning
NPC Systems#
- NPC Behavior Trees -- Create and manage NPC behavior trees with visual editors
- AI Dialogue Generation -- Generate NPC dialogue using AI with character personality and context awareness
- NPC Personality Profiles -- Define NPC personalities that influence their dialogue and behavior
Virtual and Extended Reality#
Virtual Production#
- Virtual Production Stage -- Digital virtual production stage for real-time filmmaking with LED wall integration concepts
- Camera Tracking -- Virtual camera tracking for mixed-reality production
XR Support#
- VR Previewing -- Preview scenes in virtual reality
- AR Asset Placement -- Place and preview assets in augmented reality
Plugin Marketplace and SDKs#
Plugin Marketplace#
A three-vertical marketplace for extending Yemaya:
Asset Marketplace#
- 3D Models, Textures, Audio -- Browse and purchase creative assets
- Licensing -- Multiple license types (personal, commercial, enterprise) with usage tracking
- Seller Analytics -- Revenue tracking and payout management for asset creators
- Reviews and Ratings -- Community reviews and ratings for quality assurance
- Cart and Transactions -- Full e-commerce with shopping cart, transactions, and payment processing
Plugin Marketplace#
- Tool Plugins -- Extend Yemaya with custom tools and utilities
- Agent Plugins -- Custom AI agent plugins
- Importer/Exporter Plugins -- Support additional file formats and platforms
- Renderer Plugins -- Custom rendering pipeline plugins
- Integration Plugins -- Connect Yemaya to third-party services
- Sandboxed Execution -- Plugins run in sandboxed environments with declared permissions
- Dependency Management -- Automatic dependency resolution and version compatibility checking
- Revenue Sharing -- Plugin developers earn revenue from sales
AI Model Marketplace#
- Model Listings -- Browse, discover, and download AI models (checkpoints, LoRAs, embeddings, VAEs)
- Model Cards -- Standardized model documentation with architecture, training data, metrics, and usage instructions
- Model Versioning -- Track model versions with changelogs and metrics
- Fine-Tune Support -- Upload and share fine-tuned models
- Model Demos -- Interactive demos for models before download
- Publisher Profiles -- Verified publisher profiles with model portfolios
Unified Search#
- Cross-Marketplace Search -- Search across all three marketplaces simultaneously with faceted filtering by vertical, price type, rating, tags, and publisher
- Trending and Featured -- Discover trending and curated content across all verticals
Developer SDKs#
Three SDK options for extending Yemaya and integrating with production pipelines:
| SDK | Language | Use Cases |
|---|---|---|
@yemaya/sdk |
TypeScript | Web apps, Node.js tools, automation scripts |
@yemaya/sdk-cpp |
C++ | Engine plugins (Unreal, custom engines) |
@yemaya/sdk-python |
Python | ML pipelines, scripting, DCC tool integration |
Organizations and Enterprise#
Organization Management#
- Organization Creation -- Create organizations with name, description, logo, and domain
- Team Management -- Create teams within organizations with specific roles and permissions
- Member Management -- Invite, remove, and manage organization members
- Organization-Level Settings -- Billing, security policies, and global configuration
Enterprise Plans#
| Feature | Free | Starter | Professional | Enterprise |
|---|---|---|---|---|
| Projects | 3 | 10 | Unlimited | Unlimited |
| Team members | 5 | 25 | 100 | Unlimited |
| Storage | 5 GB | 50 GB | 500 GB | Custom |
| GPU rendering hours | 0 | 10/mo | 100/mo | Custom |
| AI generation credits | 100 | 1,000 | 10,000 | Custom |
| Engine integrations | 1 | 3 | All | All |
| Real-time collaboration | Basic | Full | Full | Full |
| Marketplace access | Browse | Full | Full | Full |
| Plugin development | No | Yes | Yes | Yes |
| API access | No | Read | Full | Full |
| GDPR compliance | No | No | Yes | Yes |
| SOC2 audit logging | No | No | Yes | Yes |
| Custom SSO | No | No | No | Yes |
| Dedicated support | No | No | Priority | Dedicated |
Role-Based Access Control (RBAC)#
Hierarchical RBAC with three levels:
- Organization Level -- Organization-wide roles (Owner, Admin, Member)
- Team Level -- Team-specific roles and permissions
- Project Level -- Per-project roles (Owner, Admin, Editor, Contributor, Viewer)
Compliance and Audit#
- GDPR Compliance -- Data protection features, export, and deletion capabilities
- SOC2 Audit Logging -- Complete audit trail of all user actions for compliance reporting
- API Key Management -- Scoped API keys with configurable permissions for programmatic access
Enterprise Analytics#
- Usage Analytics -- Track platform usage across the organization
- Resource Consumption -- Monitor GPU hours, storage, and API usage
- Cost Attribution -- Attribute costs to specific teams, projects, or users
Content Safety and Compliance#
AI Safety#
- Content Filtering -- Automatic detection and filtering of unsafe or inappropriate generated content
- Safety Scoring -- AI-generated content receives safety scores before being made available
- Custom Safety Policies -- Configure safety thresholds and policies per organization
Community and Showcase#
Community Features#
- Forums -- Discussion forums for creators to share knowledge and ask questions
- Showcase Gallery -- Public gallery for creators to showcase their best work
- Tutorials -- Community-created and official tutorials for learning Yemaya features
Platform Availability#
| Platform | Technology | Description |
|---|---|---|
| Studio Web | Vite + React | Full-featured browser-based studio |
| Studio Desktop | Electron | Native desktop application with local |
| engine integration | ||
| CLI | Commander.js | Command-line project management and |
| automation | ||
| REST API | Hono (44 route groups) | Complete API with OpenAPI documentation |
| WebSocket | WSS | Real-time collaboration and presence |
| TypeScript SDK | npm package | SDK for TypeScript/JavaScript clients |
| C++ SDK | Native library | SDK for engine plugin development |
| Python SDK | PyPI package | SDK for ML and scripting workflows |
Access Tiers#
Feature Availability by Mode#
| Feature | Human-Driven | AI-Assisted | Fully Autonomous |
|---|---|---|---|
| Project management | Full | Full | Full |
| Asset management | Full | Full | Full |
| Script and storyboard editing | Full | AI suggests | AI generates |
| Character and world design | Full | AI suggests | AI generates |
| Engine integration | Full | Full | Full |
| Scene assembly | Manual | AI assists | AI assembles |
| Rendering | Manual trigger | Auto-queue | Auto-pipeline |
| Audio production | Manual | AI assists | AI generates |
| Quality review | Human review | AI + human | AI auto-approve |
| Export and distribution | Manual | Scheduled | Automated |
| Real-time collaboration | Full | Full | N/A |
Integration Features#
Cross-Domain Integration (Oshun Monorepo)#
Yemaya delegates specialized work to other domains via the event bus:
| Domain | Integration Purpose |
|---|---|
| Isis | AI generation (3D models, images, video, audio, text) |
| Hathor | Worldbuilding (characters, locations, lore, narrative) |
| Sophia | Research (analysis, summarization, reference materials) |
| Bellona | Engine builds (rendering, export, optimization, sync) |
Cross-domain references are stored as lightweight IDs on Yemaya records (hathorWorldId, isisWorkflowIds, sophiaPackIds, bellonaAssetId) to maintain database independence.
Pipeline Step Types#
The orchestration engine supports 30 step types across all integrated domains:
| Domain | Step Types |
|---|---|
| Isis | generate_image, generate_3d, generate_audio, generate_video, |
| inpaint, upscale, style_transfer | |
| Sophia | research, analyze, summarize, embed |
| Hathor | create_character, create_location, compile_lore, generate_dialogue |
| Bellona | export, build, sync, convert |
| Yemaya | review, approve, publish, notify |
| Utility | transform, filter, merge, split, conditional, loop, parallel, wait |
External Tool Integrations#
| Tool/Service | Integration Type | Purpose |
|---|---|---|
| Blender | Engine bridge (API) | 3D modeling, rendering, animation |
| Godot | Engine bridge (API) | Game development, scene management |
| Unreal Engine | Engine bridge (API) | AAA game/film production |
| Houdini | Engine bridge (API) | Procedural generation, VFX |
| DaVinci Resolve | SDK integration | Color grading, video editing |
| Evercast | Collaboration | Real-time video review |
| Frame.io | Collaboration | Video review and approval |
| ShotGrid | Production mgmt | VFX pipeline management |
| Miro | Production mgmt | Visual collaboration boards |
| Notion | Production mgmt | Documentation and wikis |
| Slack | Communication | Team notifications and messaging |
| Discord | Communication | Community and team chat |