How heroesjouney/aimoviestudiov2 works
AI Movie Studio 2 is a browser-based AI filmmaking workstation. Its documented workflow moves from screenplay or project setup through scene and shot design, camera previs, image/video generation, audio, timeline assembly, and export. The graph preserves those stages and the driver abstraction that supports local ComfyUI and cloud providers. Source excerpts show router registration, asset storage, generation-driver selection, and screenplay parsing; other documented capabilities are included, but their internal links are omitted where implementation evidence was not sampled.
Main entry points: app.py FastAPI Application · __init__.py Driver Registry · routes_shots.py Shot Management · page.tsx Project Workspace
Components 30
Workspace & Story
- Studio Web App
frontend/src/app/page.tsx - Project Workspace
frontend/src/app/project/[id]/page.tsx - Project API
backend/api/routes_projects.py - Screenplay Import
frontend/src/components/studio/ScreenplayImportModal.tsx - Screenplay API
backend/api/routes_screenplay.py - Screenplay Parser
backend/core/logic/screenplay_parser.py - Scene Management
backend/api/routes_scenes.py - Asset Vault UI
frontend/src/components/library/MediaLibrary.tsx - Asset Management
backend/api/routes_assets.py
Visual Planning
- 3D Camera Director
frontend/src/components/camera/CameraDirector.tsx - 3D Previs
frontend/src/components/previs/PrevisStage.tsx - Previs API
backend/api/routes_previs.py - Shot Composer
frontend/src/components/shots/ShotCreatePanel.tsx - Shot Management
backend/api/routes_shots.py - Prompt Builder
backend/core/logic/prompt_builder.py
AI Generation
- Image & Video Jobs
backend/api/routes_generate.py - Driver Registry
backend/core/drivers/__init__.py - Driver Contracts
backend/core/drivers/base.py - ComfyUI Image
backend/core/drivers/comfy_image.py - ComfyUI Video
backend/core/drivers/comfy_video.py - Audio Drivers
backend/core/drivers/comfy_audio.py
Audio & Post
- Audio Jobs
backend/api/routes_audio.py - Timeline Editor
frontend/src/components/timeline/TimelineEditor.tsx - Timeline API
backend/api/routes_timeline.py - Timeline Export
backend/api/routes_export.py
Application Platform
- Local Vault
backend/api/routes_assets.py - Frontend API Client
frontend/src/lib/api.ts - FastAPI Application
backend/app.py
Other components
- Filmmaker
- AI Model Providers
Connections 39
- Filmmaker → Studio Web App: uses
README.md - Filmmaker → Project Workspace: creates project
README.md - Project Workspace → Project API: manages projects
- Project Workspace → Screenplay Import: imports screenplay
- Screenplay API → Screenplay Parser: parses screenplay
backend/api/routes_screenplay.py - Screenplay Parser → Scene Management: produces scene data
README.md - Filmmaker → Asset Vault UI: manages references
README.md - Asset Vault UI → Asset Management: browses assets
- Asset Management → Local Vault: reads and writes
backend/api/routes_assets.py - Filmmaker → 3D Camera Director: frames shots
README.md - Filmmaker → 3D Previs: blocks camera moves
README.md - 3D Previs → Previs API: renders previs
- Filmmaker → Shot Composer: composes shots
README.md - Shot Composer → Shot Management: submits shot work
- Shot Management → Prompt Builder: builds prompts
backend/api/routes_shots.py - Shot Management → Driver Registry: selects drivers
backend/api/routes_shots.py - Image & Video Jobs → Driver Registry: selects image driver
backend/api/routes_generate.py - Driver Registry → ComfyUI Image: instantiates
backend/core/drivers/__init__.py - Driver Registry → ComfyUI Video: instantiates
backend/core/drivers/__init__.py - Driver Registry → Audio Drivers: registers audio drivers
backend/core/drivers/__init__.py - ComfyUI Image → Driver Contracts: implements
backend/core/drivers/comfy_image.py - ComfyUI Video → Driver Contracts: implements
backend/core/drivers/comfy_video.py - Audio Jobs → Driver Registry: selects audio driver
backend/api/routes_audio.py - Filmmaker → Timeline Editor: assembles edit
README.md - Timeline Editor → Timeline API: manages timeline
- Timeline API → Timeline Export: exports timeline
- ComfyUI Image → AI Model Providers: generates images
- ComfyUI Video → AI Model Providers: generates video
- Audio Drivers → AI Model Providers: generates audio
- Studio Web App → Frontend API Client: uses API client
- Frontend API Client → FastAPI Application: calls API
- FastAPI Application → Asset Management: registers routes
backend/app.py - FastAPI Application → Shot Management: registers routes
backend/app.py - FastAPI Application → Image & Video Jobs: registers routes
backend/app.py - FastAPI Application → Audio Jobs: registers routes
backend/app.py - FastAPI Application → Timeline API: registers routes
backend/app.py - FastAPI Application → Timeline Export: registers routes
backend/app.py - FastAPI Application → Screenplay API: registers routes
backend/app.py - FastAPI Application → Previs API: registers routes
backend/app.py