_{🎬 Trailer: Bilibili  ·  YouTube}

🎬 Made with DramaClaw

_{Real short dramas our team produced on this very pipeline — click a link to play.}

归灵司 ▶ 第 1 集	鲁班 ▶ 第 1 集	师兄你怎么不舔了 ▶ 第 1 集
天命不可欺 ▶ 第 02 集  ·  第 58 集	乌龙仙途 ▶ 第 1 集	非遗㑇舞 ▶ 播放

_{More clips: 3D 动漫混剪 demo  ·  动态打斗}

DramaClaw is an industrialized drama-production line whose source is available. Drop in a manuscript and DramaClaw takes over all the heavy lifting: extracting characters, planning episodes, generating scripts, drawing storyboards and first frames, synthesizing voice-over, and cutting the final film.

It's built for creators, indie studios, and creative engineers — letting you run the whole "drama factory" on your own infrastructure, without stitching together a dozen disconnected tools or handing your material to an opaque black-box cloud service.

And although it's built around drama production, the same pipeline — characters, assets, scripts, storyboards, voice-over, and compositing — carries just as well to other visual-content formats: short-form ads, e-commerce product videos, and interactive otome (romance) games.

• Novel parsing & story graph — parse the manuscript into a queryable graph of characters, relationships, and timeline
• Asset Library & identity consistency — unified management of characters, scenes, props and voices; keep stable identities across episodes, generate character portraits and per-episode variants
• Episode planning & narrative pacing — automatic chapter segmentation, beat planning, multi-episode arcs
• Script generation — multiple modes (adaptive, literal, staged) with review / repair loops
• Storyboards & first frames — beat-driven stylized image generation, grid splitting, image-pool selection
  
• Voice-over synthesis — emotion-aware speech synthesis, switchable across providers
• Video composition & export — assemble episodes, export video + subtitle files and the full asset pack
• Freezone (infinite canvas) — node-based visual workbench: drag in project assets to generate images / video / audio, promote satisfying candidates back to the main line; the main pipeline and canvas exploration run as dual tracks
  
• Director World / 3GS (scene variants) — a framable virtual set that locks spatial structure, character blocking and camera placement to keep the same location consistent across shots
  
• Xia Director (AI assistant) — conversational production assistant that checks project progress, advances script / shot tasks, audits deliverable completeness and suggests next steps
  
• Visual Style (style templates) — upload a reference image to auto-extract style parameters and apply them across the whole project for a consistent look
• Task Center — status, progress, logs and cancel / retry for background generation tasks, with resume-from-checkpoint for long runs

Every step has its own interface — run them in order, skip steps, resume from any checkpoint, or even plug in your own orchestrator.

DramaClaw runs all inference through a remote OpenAI-compatible gateway — nothing runs models on your machine — so the local footprint is light. An ordinary laptop or a small VPS is enough.

Local development (non-Docker) additionally needs Python 3.11–3.12 + uv + ffmpeg. Full prerequisites in the Self-hosting guide.

git clone https://github.com/dramaclaw/dramaclaw.git
cd dramaclaw

cp .env.example .env
# Edit .env — set PROMPT_EXPORT_PASSWORD to a non-default value.
# NEWAPI_BASE_URL defaults to the official gateway; add your DC key here or paste it in the UI next.

docker compose up -d --build   # starts two services: api / web

Open the app at http://localhost:8080; the REST API is at http://localhost:8780. In Settings → Model Config → Official, paste your DC key (get one at https://relayclaw.cdnfg.com) and you're ready — no model mapping needed. Full steps in the Quick Start.

No build needed — every GitHub Release publishes multi-arch (amd64/arm64) images to Docker Hub, so a single file is enough to run:

curl -LO https://raw.githubusercontent.com/dramaclaw/dramaclaw/main/docker-compose.release.yml
docker compose -f docker-compose.release.yml up -d
# Pin a version (defaults to latest): DRAMACLAW_VERSION=1.0.1 docker compose -f docker-compose.release.yml up -d

git clone https://github.com/dramaclaw/dramaclaw.git
cd dramaclaw

uv sync
cp .env.example .env && $EDITOR .env

uv run novelvideo api --port 8780   # start the REST API (CE defaults to inline tasks, no Ray/Redis)

DramaClaw stays model-neutral — all text/image/video/audio models connect through a single OpenAI-compatible gateway, in two ways:

• DramaClaw official key (recommended): docker compose up, open http://localhost:8080 → Settings → Model Config → Official, paste your DC key, save. Works instantly — no model mapping needed. Get a key at https://relayclaw.cdnfg.com.
• Bring your own gateway (BYO): point NEWAPI_BASE_URL at your own OpenAI-compatible endpoint and map model names (see Configuring Models).

Prefer fully local? Run docker compose -f docker-compose.selfhosted.yml up for a bundled newapi gateway you configure yourself (prebuilt-image variant: docker-compose.selfhosted.release.yml).

Built for novel-to-short-drama. General workflow tools can wire nodes together, but they don't know what an "episode beat" is, don't understand why a character's cross-scene identity consistency matters, and won't guard a chapter's emotional arc across image + voice + editing. DramaClaw builds all that judgment into the tool.

Every step is decomposable. Each stage is an independent async task with its own interface. Run sequentially, skip steps, resume mid-way — the toolchain itself is the product, with no hidden black box.

Self-hostable, model-neutral. Your manuscript, your characters, your models, your servers. Use closed-source frontier models when you want the best results; switch to open-weight models when you want full control. DramaClaw won't lock you into any single vendor.

The edge isn't "more generation" — it's organizing the whole short-drama production loop (script → assets → shots → canvas → final cut) into something reusable, collaborative and scalable.

_{Legend: ✅ Full · ◐ Partial · ○ Planned · ❌ None — competitor names partially masked; comparison based on publicly available product docs and positioning.}

• Product user manual — full UI walkthrough (Feishu)
• Feature overview
• Architecture
• Quick Start
• Self-hosting guide
• Configuring model providers
• More docs →

• Report a Bug
• Request a Feature
• Join the Discussion
• Contributing Guide
• Security Policy

We continuously curate and label good first issue — a great place to start.

The people building DramaClaw — thank you. 💜

bopy-zou	Handanhhhy	Hanlin-Gabriel	ryanhuang-duat	lywaterman	n7s4
NewYuee	SimonRen	vkiki	wangwenqq	zhen2025109

_{Logo is a trademark of its respective owner, shown with permission.}

Elastic License 2.0. Free to use, modify, and redistribute — the only restriction is that you may not resell the software as a hosted service. See the license explainer.

See NOTICE for required branding and third-party attribution notices.