How nithin0553/cutsceneai-studio works
CutSceneAI Studio turns a creative brief into a validated cinematic plan, then offers preview, dialogue-audio, and Unreal-export branches. The README documents these capabilities; sampled source confirms the API-to-preview path, CIR validation, preview-to-Unreal compilation, and dialogue bundle generation and verification. Other API wiring and some subsystem internals are represented only where documented, so uncertain call relationships are omitted.
Main entry points: main.py FastAPI app · preview.py Preview API · dialogue.py Dialogue API · unreal.py Unreal API
Components 24
HTTP API
- FastAPI app
backend/app/main.py - CIR validation API
backend/app/api/cir.py - Director API
backend/app/api/director.py - Preview API
backend/app/api/preview.py - Dialogue API
backend/app/api/dialogue.py - Unreal API
backend/app/api/unreal.py
Cinematic Planning
- CIR contract
cir/src/cutsceneai_cir/models.py - CIR validation
cir/src/cutsceneai_cir/validation.py - Director service
backend/app/services/director.py - OpenAI director
backend/app/services/openai_director.py
Preview Pipeline
- Manifest compiler
preview/src/cutsceneai_preview/compiler.py - Storyboard renderer
preview/src/cutsceneai_preview/rendering.py
Dialogue Pipeline
- Cue planning
dialogue/src/cutsceneai_dialogue/planning.py - Audio bundling
dialogue/src/cutsceneai_dialogue/service.py - WAV processing
dialogue/src/cutsceneai_dialogue/audio.py - Bundle verification
dialogue/src/cutsceneai_dialogue/loading.py
Unreal Export
- Sequencer compiler
adapters/unreal/src/cutsceneai_unreal/compiler.py - Engine conversion
adapters/unreal/src/cutsceneai_unreal/conversion.py - Dialogue importer
adapters/unreal/src/cutsceneai_unreal/dialogue_import.py - Editor script renderer
adapters/unreal/src/cutsceneai_unreal/rendering.py
Other components
- Creative user
- OpenAI
- Speech provider
- Unreal Editor
Connections 29
- Creative user → Director API: submits brief
- FastAPI app → CIR validation API: dispatches
- FastAPI app → Director API: dispatches
- FastAPI app → Preview API: dispatches
- FastAPI app → Dialogue API: dispatches
- FastAPI app → Unreal API: dispatches
- CIR validation API → CIR contract: parses project
- CIR validation API → CIR validation: validates
- Director API → Director service: requests generation
- Director service → OpenAI director: generates with
- OpenAI director → OpenAI: requests structured CIR
- Director service → CIR validation: validates result
- Preview API → CIR validation: validates input
- Preview API → Manifest compiler: compiles project
- Preview API → Storyboard renderer: renders manifest
- Manifest compiler → CIR validation: checks project
- Dialogue API → Cue planning: plans cues
- Dialogue API → Audio bundling: builds audio bundle
- Audio bundling → Cue planning: uses cue plan
- Audio bundling → WAV processing: processes WAV
- Audio bundling → Speech provider: synthesizes speech
- Dialogue API → Bundle verification: verifies uploaded bundle
- Unreal API → Sequencer compiler: compiles export
- Sequencer compiler → Manifest compiler: compiles preview data
- Sequencer compiler → Engine conversion: converts engine values
- Unreal API → Dialogue importer: imports dialogue bundle
- Dialogue importer → Bundle verification: verifies bundle
- Unreal API → Editor script renderer: renders import script
- Unreal Editor → Editor script renderer: runs generated script