AI-native film & video pre-production. A StudioBinder-style workflow (Write → Breakdown → Visualize → Plan → Shoot) where every stage is swappable AI: 21 providers behind a single interface, generate storyboards from your screenplay, animate them, then export to Final Cut Pro, CapCut or EDL — without leaving the tool.
| Stage | What you do | Driven by |
|---|---|---|
| Write | Upload Fountain / FDX / PDF / plain text — or use the built-in Lexical WYSIWYG editor with Tab-cycle elements, INT./EXT. auto-detect and Fountain round-trip | screenplay-editor |
| Breakdown | Per-scene characters, props, wardrobe, set dressing, vehicles, SFX/VFX, animals — auto-extracted | Anthropic Claude |
| Visualize | AI-proposed shot list → storyboards (text-to-image or img2img with character reference locks) → image-to-video clips → ambient/dialogue/music audio | Catalog of 21, defaults fal.ai for image/video, ElevenLabs for voice |
| Plan | Contacts, tasks, calendar, media library, cost tally | — |
| Shoot | Auto-drafted call sheets, location info, NLE export (FCPXML / CapCut JSON / EDL) | nle-export |
Drive the whole thing from Claude Code or Cursor via the bundled MCP server — 29 tools + 4 resource URIs per project, stdio transport.
Sample project bundled — click Load Interstellar sample to get the 367-scene screenplay pre-loaded with 10 contacts, 7 locations, 5 tasks.
 |
 |
| Projects list. Open the bundled sample or start a new production. | Project dashboard. Workflow tracker on the left tells you what's done and what's next; KPI cards count scenes, characters, shots, boards, clips, sheets. |
 |
 |
| Lexical WYSIWYG editor. Tab cycles element types, INT./EXT. auto-detects sluglines, Fountain round-trip, scene navigator on the right, optional sepia "Paper" mode. | Stripboard. Scenes grouped by location, colored by time of day — the planning view AD's actually use. |
 |
|
| Sides. Per-scene extracts for actors and shoot-day handouts — click any scene to preview content + CAST tags. |
yarn install
cp .env.example .env # at minimum: ANTHROPIC_API_KEY + FAL_KEY
yarn docker:up # Postgres 16 + Redis 7 + MinIO
yarn db:migrate
yarn db:seed
yarn start # api :4000 + web :3000
yarn start:desktop # Electron wrapper (optional)Open http://localhost:3000. Sign in with admin@cinestudio.dev / Test@1234.
Click Load Interstellar sample on the projects page to get a 367-scene
sample project pre-seeded with contacts, locations and tasks.
Swagger: http://localhost:4000/api/docs
| Capability | Providers |
|---|---|
| Text / LLM | Anthropic Claude, OpenAI, Google Gemini |
| Image (txt2img + img2img) | fal.ai, Replicate, OpenAI (gpt-image-1, DALL·E 3), Stability, Ideogram, Black Forest Labs (Flux direct), Leonardo, Google Imagen, ComfyUI (self-hosted, $0) |
| Image-to-video | fal.ai, Replicate, Runway, Luma, Higgsfield, Kling, Pika, MiniMax/Hailuo, HeyGen, Synthesia, Google Veo |
| Audio (TTS / music / SFX) | ElevenLabs, Suno (catalog), Mubert (catalog) |
Unconfigured providers stay in the picker but are tagged (no key) so you
can browse the catalog without keys. See docs/03-ai-providers.md
for the full registry, docs/13-cost-estimation.md
for the pricing model, and docs/20-comfyui.md for the
self-hosted setup that drives image cost to zero.
The docs/ directory is the source of truth.
| docs/01-architecture.md | Monorepo layout, module boundaries, package graph |
| docs/02-data-model.md | 24 Prisma models with ERD |
| docs/03-ai-providers.md | IAIProvider contract + how to add a new one |
| docs/04-workflow.md | Write → Breakdown → Visualize → Plan → Shoot pipeline + BullMQ |
| docs/05-auth.md | Local JWT, refresh tokens, role guards |
| docs/06-api-reference.md | Endpoint catalog (Swagger is canonical, this is the cheat sheet) |
| docs/10-development.md | Hacking on the codebase |
| docs/11-imports.md | PDF / FDX / Fountain / CSV import pipeline |
| docs/12-character-bible.md | Reference-image consistency model |
| docs/13-cost-estimation.md | Pre-flight quotes, usage tracking |
| docs/14-workflow-gates.md | Stage state machine |
| docs/15-audio.md | VO / music / SFX |
| docs/16-nle-export.md | FCPXML, CapCut JSON, EDL |
| docs/17-workspace.md | Three-pane unified editor |
| docs/18-mcp-server.md | Run Cine Studio from Claude Code / Cursor |
| docs/19-screenplay-editor.md | Lexical WYSIWYG, Fountain I/O |
| docs/20-comfyui.md | Self-hosted GPU, free image generation |
- API: NestJS 11 · Prisma 6.19 · PostgreSQL 16 · BullMQ · Redis 7 · MinIO (S3 API)
- Web: Next.js 16 (App Router, PWA) · React 19 · Tailwind v4 · Shadcn/Radix · TanStack Query · Lexical (editor) ·
react-resizable-panelsv2.1.7 - Desktop: Electron 32 wrapper around
apps/web - MCP:
@modelcontextprotocol/sdkstdio server - Auth: local JWT (access + refresh), bcrypt
- AI registry: 21 providers behind one
IAIProviderinterface — see docs/03-ai-providers.md
Pinned to Node 20.17.0 and Yarn 1.22.22. Don't upgrade Prisma to 7.x without bumping Node to ≥ 20.19.
PRs welcome — please read CONTRIBUTING.md first, especially
the "What we don't accept" section. Bug reports, feature ideas and new
provider adapter requests use the issue templates under .github/ISSUE_TEMPLATE/.
By participating in this project you agree to abide by the Code of Conduct. For security issues, see SECURITY.md.
Changelog: CHANGELOG.md.
MIT © Cine Studio contributors.