dramaclaw/dramaclaw

★ 7,193⑂ 942

A general-purpose AIGC video engine: script to finished film in one pipeline — dramas, ads, product videos, otome games, and more. | 通用 AIGC 视频引擎 —— 从剧本到成片一条流水线,漫剧、广告、电商、乙游皆可

About dramaclaw/dramaclaw

dramaclaw/dramaclaw is an open-source project on GitHub, mainly written in Python. A general-purpose AIGC video engine: script to finished film in one pipeline — dramas, ads, product videos, otome games, and more. It currently holds 7,193 stars and 942 forks with 103 open issues, and was last pushed on 2026-11-04 (repository created 2026-03-27).

Project Overview

Git Homed tracks it on the Video Trending board and on the AI Video Trending list.

GitHub Repository Details

Repository dramaclaw/dramaclaw · default branch main · size 711926 KB · watchers 124 · source: GitHub REST API and repository README

README

DramaClaw

Make Your Own DC.

They say you're obsolete.
Maybe it's the whole idea of "working for someone else" that's obsolete.

In the age of AI, the real question isn't whether machines replace people.
The real question is:
Who owns the machines?
Who owns the pipeline?
Who owns industrialized productivity?

If the answer is always Big Tech,
then AI isn't empowerment.
It's just a new wall.

I'm Eric.

This isn't a demo.
Not a toy.
Not a crippled edition.

This is the industrialized drama-production line our own team runs every day.
From script to storyboard, from assets to finished film — the whole chain.

Because people aren't beasts of burden.
Because creativity is humanity's last line of defense.

What DramaClaw sets out to do is simple:

Tear down the wall.

Put the industrialized drama-production power that only Big Tech had
into the hands of ordinary creators.

The code is here.
If this resonates, leave a ⭐.
We'll keep tearing down walls.

And yes, you can make money with it.
DramaClaw is Elastic License 2.0. Run it, modify it, sell what you build with it —
the standalone version is free for commercial use, no permission needed.
We ask for one thing: a small "Powered by DramaClaw" in the corner of your UI.
The only door still closed is wrapping it up as a hosted SaaS for other people; that license isn't open yet.
Why, and the FAQ: #475.


License GitHub stars Release Docker

English  |  简体中文  |  Tiếng Việt  |  ไทย  |  Website  |  Docs  |  Quick Start


https://github.com/dramaclaw/dramaclaw/blob/HEAD/DramaClaw — storytellers, back in front of the camera

🎬 Trailer: Bilibili  ·  YouTube


What is DramaClaw?

DramaClaw is a self-hostable production line for AI drama: from manuscript to finished episodes, and from a one-line brief to a short film. An agent and an infinite canvas share one asset library:

Bring any model through an OpenAI-compatible gateway, run it on your own machine, and keep your material.

🚀 Quick Start  ·  🆕 What's New  ·  🎬 Showcase  ·  ✨ Features  ·  🔌 Models  ·  📖 Docs


🆕 What's New

Three things we have been building with our own production team, now in main.

🤖 Xia Director — from a brief to a running workflow

https://github.com/dramaclaw/dramaclaw/blob/HEAD/Xia Director turns a natural-language brief into a canvas workflow

One brief → planned workflow → nodes on the canvas → generated assets → composed video.

🎥 3D Previz Stage — block the scene before you generate it

https://github.com/dramaclaw/dramaclaw/blob/HEAD/3D Previz stage: blocking, camera and timeline, recorded back into the canvas

Reference image → 3D blockout → characters, cameras and timeline → recorded preview back on the canvas.

An in-browser previs stage that lives on the canvas as a node. Lock down space, blocking and framing first, then feed the result to image and video generation.

🔀 Interactive Stories — audience choices shape the story

https://github.com/dramaclaw/dramaclaw/blob/HEAD/Interactive stories: branching authoring and player

Branching story generation, canvas authoring, interactive playback and multiple endings.


🎬 Made with DramaClaw

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

https://github.com/dramaclaw/dramaclaw/blob/HEAD/归灵司
归灵司
▶ 第 1 集
https://github.com/dramaclaw/dramaclaw/blob/HEAD/鲁班
鲁班
▶ 第 1 集
https://github.com/dramaclaw/dramaclaw/blob/HEAD/师兄你怎么不舔了
师兄你怎么不舔了
▶ 第 1 集
https://github.com/dramaclaw/dramaclaw/blob/HEAD/天命不可欺
天命不可欺
▶ 第 02 集  ·  第 58 集
https://github.com/dramaclaw/dramaclaw/blob/HEAD/乌龙仙途
乌龙仙途
▶ 第 1 集
https://github.com/dramaclaw/dramaclaw/blob/HEAD/非遗㑇舞
非遗㑇舞
▶ 播放

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


🚀 Quick Start

You need Docker with docker compose. No GPU, database or queue is required — models run behind the gateway, state lives on local disk.

git clone https://github.com/dramaclaw/dramaclaw.git
cd dramaclaw
cp .env.example .env          # set PROMPT_EXPORT_PASSWORD to a non-default value

docker compose -f docker-compose.release.yml pull docker compose -f docker-compose.release.yml up -d

Open , go to Settings → Models & Channels, and paste your DC key (get one at ) — or switch to Custom to use your own providers. That's it.

The release Compose file runs the published v2.1.1 multi-arch images (DRAMACLAW_VERSION=2.1.1, DRAMACLAW_GATEWAY_VERSION=v1.0.0-rc.24-dramaclaw.3). Mainland China users can switch to the ACR mirror with DRAMACLAW_IMAGE_PREFIX.

Other ways to run it


| Method | When to use | Command | Guide | |---|---|---|---| | Published images | Try or self-host a release | docker compose -f docker-compose.release.yml up -d | Quick Start | | Source Docker | Run your own modified code | clone dramaclaw-gateway next to this repo, then docker compose up -d --build | Self-hosting | | Local dev | Hack on DramaClaw with hot reload | scripts/start-ce.sh (API :8780 + UI :5173; needs Python 3.11–3.12, uv, Node/pnpm, ffmpeg) | Installation |

scripts/start-ce.sh downloads the patched Codex 0.164.0 Agent runtime for macOS or Linux, verifies its pinned SHA256, and caches it under runtime/codex/bin/. Set CODEX_BIN in .env to use your own patched build instead; Windows users should use WSL2 or Docker.

Upgrading from an older checkout, pinning versions, exposing the bundled gateway, or using your own Codex binary: see the Self-hosting guide and Troubleshooting.

System requirements


| Item | Requirement | |---|---| | CPU / RAM | ≥ 2 vCPU / 4 GB (model inference runs on the gateway, not locally) | | GPU | Not required. Only the optional world extra (voxel / panorama-to-3D) needs CUDA | | OS | macOS (Apple Silicon / Intel), Windows (Docker Desktop + WSL2), Linux | | Ports | 8080 web UI · 8780 REST API · 3000 bundled gateway admin (localhost only by default) | | Datastores | None — no Postgres, Redis, Celery or Ray. SQLite + files on the ce-data volume | | Network | Outbound access to relayclaw.cdnfg.com and/or the providers you configure |


✨ Features

XiaHua — the infinite canvas

https://github.com/dramaclaw/dramaclaw/blob/HEAD/XiaHua canvas: a 17-node short-film workflow that Xia Director laid out and ran from one prompt

One prompt to Xia Director (right) became this 17-node, 32-edge workflow (left): brief → story direction → character and set references → five first frames → five shot videos → voice-over and score → final cut.

https://github.com/dramaclaw/dramaclaw/blob/HEAD/Director World

Director World

https://github.com/dramaclaw/dramaclaw/blob/HEAD/Previz node connected to its reference image

Previz node on the canvas

Series (XiaJi) — the pipeline

https://github.com/dramaclaw/dramaclaw/blob/HEAD/DramaClaw pipeline — Ingest, Plan, Produce, Deliver

Every stage is an independent task with its own interface — run them in order, skip steps, resume from any checkpoint, or drive them from your own orchestrator.

https://github.com/dramaclaw/dramaclaw/blob/HEAD/XiaTang asset library

XiaTang — asset library

https://github.com/dramaclaw/dramaclaw/blob/HEAD/Storyboards and first frames

Storyboards and first frames


🤔 Why DramaClaw?

How DramaClaw compares

Legend: ✅ Full · ◐ Partial · ○ Planned · ❌ None · — Not verified. Competitor names partially masked; based on publicly available product docs and positioning.

| Capability | L\*TV | R\*Hub | T\*Now | S\*ko | U\*dream | O\II | J\/K\* | DramaClaw | |---|:--:|:--:|:--:|:--:|:--:|:--:|:--:|:--:| | Built-in agent (workflow planning, canvas orchestration, execution) | ✅ | ✅ | ✅ | ○ | ✅ | ○ | ✅ | ✅ | | Workflow Skills and Recipes (reuse, import, export, share) | — | — | — | — | — | — | — | ✅ | | 3D previz stage (blocking, motion, cameras, timeline, recording) | — | — | — | — | — | — | — | ✅ | | Interactive series (branching, variables, multiple endings) | ◐ | ◐ | ◐ | ✅ | ◐ | ❌ | ❌ | ✅ | | Infinite canvas (node-based, free exploration) | ✅ | ✅ | ✅ | ❌ | ✅ | ✅ | ✅ | ✅ | | Dual-track (main pipeline + canvas exploration) | ❌ | ❌ | ❌ | ❌ | ❌ | ❌ | ❌ | ✅ | | Storyboard preview (script → shots, boards) | ◐ | ✅ | ◐ | ✅ | ◐ | ❌ | ❌ | ✅ | | Asset library (characters / scenes / props / voices) | ◐ | ❌ | ◐ | ✅ | ◐ | ○ | ❌ | ✅ | | Scene consistency (variants, 360°, multi-state) | ✅ | ◐ | ❌ | ❌ | ○ | ❌ | ❌ | ✅ | | Director's world (360° / 3D set, camera, framing) | ✅ | ◐ | ❌ | ❌ | ◐ | ❌ | ❌ | ✅ | | Final delivery (multi-shot, subtitles / SRT, pack) | ✅ | ○ | ○ | ✅ | ✅ | ❌ | ❌ | ✅ | | Team production (sharing, roles, tasks, cost) | ✅ | ✅ | ○ | ✅ | ○ | ○ | ○ | ✅ | | Custom style (templates, prompts, negatives) | ✅ | ◐ | ○ | ✅ | ◐ | ○ | ◐ | ✅ | | Creative companion (persona, nudges, feedback) | ❌ | ❌ | ❌ | ❌ | ❌ | ❌ | ❌ | ✅ | | Source-available (self-host, fork, customize) | ❌ | ❌ | ❌ | ❌ | ❌ | ❌ | ❌ | ✅ |


🔌 Models & Providers

All text, image, video and audio models connect through an OpenAI-compatible gateway. Pick a mode in Settings → Models & Channels:

| Mode | What you do | Best for | |---|---|---| | Official (recommended) | Paste your DC key from RelayClaw. Every model mapping is preconfigured. | Getting started fast | | Custom | One click initializes the bundled dramaclaw-gateway; add your own provider channels. | Full control over providers and cost | | Local + Official Hybrid | Official models for the pipeline, plus your own channels (e.g. a local ComfyUI workflow). | Mixing in local or niche models |

The bundled gateway is DramaClaw's fork of New API. It speaks the DC-Media contract and ships adapters for ComfyUI · MiniMax / Hailuo · VolcEngine Doubao / Seedance · fal.ai · Alibaba · Kling · Jimeng · Vertex AI · Gemini · OpenAI / Sora · Suno (support matrix, add a provider).

The Agent model is configured separately under Models & Channels → Agent model and can follow the active channel or use any endpoint that supports the OpenAI Responses API with tool calls. Details: Configuring models.


📖 Documentation

| | | |---|---| | Start | Quick Start · Installation · Configuring models | | Learn | Feature overview · Architecture · Product manual (Feishu) | | Operate | Self-hosting · Troubleshooting · Use from Claude Code (MCP) | | More | All docs → |


🤝 Community & Contributing


Produced By

https://github.com/dramaclaw/dramaclaw/blob/HEAD/Neo Flying AI Laboratory

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


License

Elastic License 2.0. Free to use, modify, redistribute and sell what you build with it; keep a small "Powered by DramaClaw" in your UI. The only restriction is that you may not offer the software itself as a hosted service to others. See the license explainer, the licensing statement, and NOTICE for required branding and third-party attributions.


Star History

GitHub Stars & Activity

7,193Stars
942Forks
103Open issues
PythonLanguage

GitHub Popularity

GitHub stars7,193
Forks942
Open issues103
Primary languagePython
LicenseNOASSERTION
Stars gained today0
Created2026-03-27
Last pushed2026-11-04

Trending History

Trending statusnot on today's boards

Related GitHub Projects

1

harry0703 / MoneyPrinterTurbo

Python★ 144,122⑂ 0
→
2

OpenMontageInc / OpenMontage

Python★ 81,161⑂ 0
→
3

ATH-MaaS / Pixelle-Video

Python★ 30,170⑂ 0
→
4

Wan-Video / Wan2.2

Python★ 18,718⑂ 0
→
5

Zulko / moviepy

Python★ 15,157⑂ 0
→
6

zai-org / CogVideo

Python★ 13,207⑂ 0
→
7

HKUDS / ViMax

Python★ 12,943⑂ 0
→
8

Tencent-Hunyuan / HunyuanVideo

Python★ 12,785⑂ 0
→

More Trending Repositories