项目预览
项目数据
项目介绍
Star 增长趋势
本站每日记录该项目 GitHub 星标变化，观测越久曲线越完整
数据来源：GitHub API 逐日快照 · 收录于 2026-08-09 · 当前星标 ★ 7376
使用教程
ℹ 本教程由 AI 依据该项目 README 整理，个别步骤可能需要按你的环境微调。
环境要求
- 已安装 Git，能克隆 GitHub 仓库
- 已安装 Docker 与 Docker Compose（官方推荐方式）
- 两个仓库需并列克隆到同一父目录（默认从 ../dramaclaw-gateway 构建）
- 磁盘/网络可拉取多架构镜像（amd64/arm64）
安装与启动步骤
-
1克隆主仓库
把 DramaClaw 主仓库克隆到本地，为后续 docker compose 构建准备源码。
git clone https://github.com/dramaclaw/dramaclaw.git -
2克隆网关仓库
克隆随附的 dramaclaw-gateway 网关仓库，默认源码构建会从同级目录 ../dramaclaw-gateway 读取它。
git clone https://github.com/dramaclaw/dramaclaw-gateway.git -
3进入项目目录
切换到主仓库目录，后续命令都在这里执行。
cd dramaclaw -
4准备环境变量
复制环境变量模板为 .env，再按需填写运行配置（README 节选未列出具体配置项）。
cp .env.example .env -
5构建并启动
用 docker compose 一次性构建并后台启动全部三个服务，首次构建耗时较长。
docker compose up -d --build
关键配置
| 配置项 | 必填 | 说明 | 示例 |
|---|---|---|---|
.env | 是 | 由 .env.example 复制而来，存放服务运行所需的环境变量 | .env |
如何确认成功
README 未给出专门验证步骤；可用 docker compose ps 确认三个服务均为 Up 状态。
常见问题
Q：需要克隆几个仓库？
A：源码构建方式下需要两个：主仓库 dramaclaw 和随附网关 dramaclaw-gateway，且要并列放在同一父目录。
Q：可以用现成镜像而不自己构建吗？
A：可以，每次 GitHub Release 都会向 Docker Hub 发布 amd64/arm64 多架构镜像，但 README 节选未给出具体镜像名与拉取命令。
Q：可以商用或卖用它生成的作品吗？
A：可以。项目采用 Elastic License 2.0，允许运行、修改并用它构建的成果获利，独立版本免费。
Q：启动后默认端口是多少？
A：README 节选未提供端口信息，请以仓库完整文档或官网 dramaclaw.ai 的说明为准。
注意事项
- README 节选在 cp .env.example .env 之后被截断，完整配置项与端口请查阅仓库完整文档
- 默认源码构建依赖两个仓库的相对目录关系，路径放错会导致构建失败
- 首次 docker compose 构建需拉取基础镜像并编译服务，耗时可能超过预估的 10 分钟
- 项目使用 Elastic License 2.0，使用前请确认授权条款
核心亮点
- 一站式流水线覆盖从剧本到成片全流程，支持漫剧、广告、电商、乙游等多场景，显著降低视频制作门槛
- 基于TypeScript和FastAPI构建，技术栈清晰，便于二次开发与集成，且项目处于成长中，社区活跃度较高
- 定位通用AIGC视频引擎，集成AI Agent与图像生成视频能力，具备较强的扩展性和自动化潜力
不足之处
- 文档/社区待观察
适用场景
- 漫剧、短剧等剧情类视频的自动化批量生产
- 广告片、产品宣传视频的快速生成与迭代
- 乙女游戏、互动内容等定制化视频场景
替代项目
Runway Gen-2、Pika Labs、Sora
上一篇：PersonaLive
同类项目推荐
vox-director
开源
输入主题，自动产出 Vox 风格拼贴解说视频
Turn one topic into a finished Vox-style paper-collage explainer/ad video — automat···
liquid-shape-distortions
开源
在浏览器中实时生成流动迷幻的液体扭曲动画。
Create psychedelic animations in real-time in the browser. Webgl shader using liqui···
ManvoTV
开源
输入想法，自动生成漫剧剧本和视频
Manvo TV — 想到什么就生成什么 · AI 原生创作平台(无限画布 + 漫剧剧本工厂) | https:/···
DAWN-pytorch
开源
用扩散模型快速生成动态说话头视频，告别卡顿和误差累积
Offical implement of Dynamic Frame Avatar with Non-autoregressive Diffusion Framewor···
glucose_media_player
开源
Windows 上超轻量播放器，离线 AI 自动生成字幕
A Full-Featured, Powerful & Ultra-lightweight, video player for Windows with on-devi···
Vista4D
开源
用 4D 点云重拍视频，自由切换视角
Official code, models, and data for Vista4D: Video Reshooting with 4D Point Clouds (···
SCoPE
开源
给视频扩散模型装上三维坐标感，生成不漂移的新视角视频
SCoPE: Sightline-Coordinate Positional Encoding for 3D-Aware Video Generation
FlashVSR
开源
单步扩散做流式视频超分，接近实时出片
[CVPR 2026] Towards Real-Time Diffusion-Based Streaming Video Super-Resolution — An···
cinematic-video-prompt-skill
开源
700+电影术语速查，让AI视频提示词拍出电影感
AI video prompt cheat sheet & Claude Skill: cinematic camera angles, camera movement···