How mnm967/qamba-studio-oss works
Qamba Studio is a local-first desktop studio for planning, generating, and editing AI video. The main workflow moves from a user’s story brief through staged planning and story-bible references into queued renders, then into timeline editing and final assembly. The README documents the local project-file/PostgREST bridge and the Python job pipeline; the tree identifies the major UI and runtime modules. Some subsystem links are documented rather than verified from sampled implementation, so uncertain internal calls are omitted.
Main entry points: Workspace.tsx Workspace UI · Timeline.tsx Timeline editor · handlers Job handlers · planner.py Story planning
Components 23
Studio experience
- Workspace UI
src/routes/Workspace.tsx - Storyboard view
src/components/shell/StoryboardView.tsx - Timeline editor
src/components/timeline/Timeline.tsx - Director chat
src/routes/ChatPage.tsx
Story development
- Story planning
worker/planner.py - Story bible
src/lib/db/lore.ts - Director tools
worker/director_tools.py
Generation pipeline
- Job handlers
worker/handlers - Speech engines
worker/voice_engines.py
Local runtime
- Project file store
src/lib/localStore.ts - Live query refresh
src/hooks/useLiveQuery.ts - Generation queue
src/lib/db/jobs.ts - PostgREST bridge
src/lib/localRest.ts - Desktop shell
src-tauri/src/lib.rs - Local engine manager
src-tauri/src/engine.rs
Editing and output
- Timeline data
src/lib/db/timeline.ts - Take assembly
src/lib/assembly.ts - Finishing chain
src/lib/postChain.ts
Other components
- Creator
- ComfyUI
- Model providers
- Rendered media
- ffmpeg
Connections 26
- Creator → Workspace UI: creates project
- Workspace UI → Storyboard view: opens storyboard
- Workspace UI → Timeline editor: opens timeline
- Workspace UI → Director chat: opens chat
- Workspace UI → Project file store: reads and writes
- Project file store → Live query refresh: invalidates tables
- Storyboard view → Generation queue: queues work
- Director chat → Director tools: invokes project tools
- Director tools → Project file store: changes project
- Generation queue → PostgREST bridge: serves project data
- PostgREST bridge → Story planning: provides PostgREST
- PostgREST bridge → Job handlers: provides PostgREST
- Story planning → Story bible: uses references
- Story planning → Generation queue: records jobs
- Job handlers → Speech engines: selects local voice
- Job handlers → ComfyUI: submits local renders
- Job handlers → Model providers: requests hosted models
- Workspace UI → Desktop shell: calls desktop bridge
- Desktop shell → Local engine manager: manages engine
- Local engine manager → ComfyUI: starts and checks
- Timeline editor → Timeline data: reads and edits
- Timeline editor → Take assembly: assembles takes
- Timeline editor → Finishing chain: configures finishing
- Take assembly → ffmpeg: renders assembly
- Finishing chain → ffmpeg: applies effects
- ffmpeg → Rendered media: writes media