AI Agent 驱动的开源可自部署视频工作台：将小说与剧本转为角色、场景、道具资产、分镜、视频和剪映草稿，支持跨镜头一致性、多供应商与费用追踪 | Self-hosted AI video workspace for stories, storyboards and short-form video production
概览
🤖 AI Agent 工作流 基于 Claude Agent SDK ，编排 Skill + 聚焦 Subagent 多智能体协作，自动完成从剧本创作到视频合成的完整流水线 🎨 多供应商图像生成 Gemini 、 火山方舟 、 Grok 、 OpenAI 、 Vidu 、 阿里百炼 、 MiniMax 、 可灵 及自定义供应商，角色设计图确保角色一致性，线索追踪保证道具/场景跨镜连贯 🎬 多供应商视频生成 Veo 3.1 、 Seedance 、 Grok 、 Sora 2 、 Vidu Q3 、 阿里百炼 、 MiniMax 、 可灵 及自定义供应商，全局/项目级可切换 ⚡ 异步任务队列 RPM 速率限制 + Image/Video/Audio 独立并发通道，lease-based 调度，支持断点续传 🖥️ 可视化工作台 Web UI 管理项目、预览素材、版本回滚、实时 SSE 任务追踪，内置 AI 助手 ⚠️ ：推荐 Linux / macOS / WSL2 / Docker。Windows 原生可运行项目创建与基础流程，但 Bash 沙箱、bwrap 等 POSIX-only 隔离机制会自动降级，生产部署仍建议 WSL2 或 Docker Desktop 首次启动后，使用默认账号登录（用户名 admin，密码在 .env 中通过 AUTH_PASSWORD 设置；未设置则首次启动时自动生成并回写到 .env），前往 （/app/settings）完成配置： 1. — 配置驱动 AI 助手的供应商凭据，支持 Anthropic 官方及多种兼容供应商，自定义 Base URL 与模型 2.
README
ArcReel
开源、自托管的 AI 视频生产工作台
将小说、成品剧本或商品素材转化为角色一致、过程可控、成本可追踪、可继续编辑的短视频。
快速开始 · 入门教程 · 完整文档 · 加入社区
赞助商
界面一览
案例
《入职地府后投诉鬼都是我老客户》第 1 集
《入职地府后投诉鬼都是我老客户》第 2 集
《入职地府后投诉鬼都是我老客户》第 3 集
ArcReel 是什么
ArcReel 是面向 AI 漫剧与小说改编、旁白/解说短视频、广告与带货短片的开源自托管工作台。它把内容分析、资产管理、分镜、媒体生成、费用追踪和导出组织成一条可审核、可中断恢复的生产流水线。
- 统一生产链路：小说、成品剧本或商品素材都能逐步转化为角色、场景、道具、分镜、视频片段和最终成片。
- 视觉一致、人工可控：跨分镜复用资产图等参考图，关键阶段可确认，单个素材可重做，历史版本可回滚。
- 模型与成本可管理：统一配置文本、图像、视频和 TTS 能力，并在生成前后查看费用与实际用量。
- 交付可继续编辑：既可直接合成视频，也可导出剪映草稿继续调整字幕、配音、节奏和转场。导出面向中国大陆版剪映，与 CapCut 的兼容性尚未验证。
从输入到成片
flowchart LR
A["小说 / 成品剧本 / 商品素材"] --> B["内容分析与项目规划"]
B --> C["角色 / 场景 / 道具资产"]
C --> D["分集与结构化剧本"]
D --> E["分镜图 / 多宫格分镜"]
E --> F["视频片段 / 旁白音轨"]
F --> G["成片合成"]
F --> H["剪映草稿导出"]
每个阶段都可以由 Agent（智能体）编排，也可以由用户在工作台中审核、调整或重新生成。详细模式选择见 创作流程与模式。
快速开始
准备好 Docker 和 Docker Compose，然后运行：
git clone https://github.com/ArcReel/ArcReel.git
cd ArcReel/deploy
cp .env.example .env
docker compose up -d
访问 。默认用户名为 admin；AUTH_PASSWORD 留空时，首次启动会自动生成密码并回写到 deploy/.env。
默认 Compose 会将
1241端口发布到宿主机所有网络接口。请勿将服务直接暴露到公网；远程访问前请配置认证，并使用 HTTPS、VPN 或安全隧道，详见 反向代理与 HTTPS。
登录后进入 设置 页面，配置 ArcReel Agent 以及文本、图像、视频等生成能力，再创建项目开始制作。
完整的首次使用流程见 完整入门教程；生产部署、升级、备份和反向代理见 部署与运维。
文档
| 页面 | 内容 |
|---|---|
| 文档首页 | 按使用者、运维者和开发者进入文档 |
| 完整入门教程 | 从首次部署到生成第一条视频 |
| 创作流程与模式 | 小说、剧本与创作构想，三种创作类型及两种生成模式 |
| 供应商与模型配置 | Agent、文本、图像、视频、TTS 供应商的选择和配置 |
| 剪映草稿导出 | 将 ArcReel 生成结果交给剪映继续编辑 |
| 常见问题 | 部署、费用、模型、数据和许可证问题 |
| 部署与运维 | SQLite、PostgreSQL、升级、备份和反向代理 |
| 从 SQLite 迁移到 PostgreSQL | 数据迁移、验证与回滚流程 |
| 架构说明 | Agent Runtime、任务队列、供应商抽象和数据层 |
| 贡献指南 | 本地开发、测试、代码规范和 PR 流程 |
交流群
扫码加入飞书交流群，获取使用帮助、版本动态和创作经验：
遇到可以复现的 Bug 或明确的功能需求，也可以直接提交 GitHub Issue。
贡献
欢迎贡献代码、文档、测试、供应商适配和问题复现。
开始开发前请阅读 CONTRIBUTING.md。本地克隆后建议立即安装项目的 pre-commit 钩子：
uv run pre-commit install
Star History
许可证与商业使用
ArcReel 采用 GNU Affero General Public License v3.0，附加条款见 NOTICE。
如果你的组织无法采用 AGPL-3.0，或者希望在不承担 AGPL 开源义务的情况下进行商业部署、白标或再分发，请联系：
Copyright © 2026 Pollo3470 and ArcReel contributors
如果 ArcReel 对你有帮助，欢迎点亮一个 ⭐ Star。
推荐工具
换一个关键词，或者移除筛选条件。
安装
npx skillfish add arcreel/arcreel