📚 Storymatrix SSOT
Quick Start
- Onboarding: Read
PROJECT_STATE_2025-11-10.yamlfor the project overview. - Fast Dev:
uv run storymatrix generate --config config/fast_dev.yaml(1 scene, 10-30s). - Full Test: Use
config/full_test.yaml(2 scenes, all features, 5-10m). - Verify Output: Inspect latest artifacts with
ls -1dt out/*_* | head -1.
System Overview
StoryMatrix is a Python 3.11+ CPU-only AI Content Factory converting prompts into multimedia stories with audio, visuals, and timelines.
| Layer | Component | Rules / Technologies |
|---|---|---|
| Domain | Pure business logic (Story, Scene, Segment) | Zero external dependencies (Allowed: pydantic v2, typing, uuid). |
| Application | Orchestration & interfaces | Clean architecture. |
| Infrastructure | CrewAI, TTS, SFX, music assembly | No GPU dependencies. Use uv instead of pip. |
Core Documentation
- CrewAI System (
01_CREWAI_SYSTEM.md): Configs, agents, tasks, guardrails, and tool registry. - Active Tasks (
CHECKLIST.md): Current project priorities and pipeline improvements.
Active Backlog
- SFX Pipeline: Implement ElevenLabs caching in
sfx_resolver_service.py, auto-tag audio assets inelevenlabs.py, and updateassets/audio_library.json. - Audio Effects: Integrate Pedalboard presets based on scene metadata.