返回项目目录
ArcReel

ArcReel

ArcReel

AI Agent 驱动的开源可自部署视频工作台:将小说与剧本转为角色、场景、道具资产、分镜、视频和剪映草稿,支持跨镜头一致性、多供应商与费用追踪 | Self-hosted AI video workspace for stories, storyboards and short-form video production

Agent视觉 / 图像工作流 / 自动化agentic-workflowai-agentai-animationai-video-generatorcapcutclaude-agent-sdk
Stars
4033
Forks
805
Watchers
4033
Issues
119

README

项目介绍

7107 bytes


ArcReel Logo
ArcReel

开源、自托管的 AI 视频生产工作台
将小说、成品剧本或商品素材转化为角色一致、过程可控、成本可追踪、可继续编辑的短视频。

中文 English

Release Tests Coverage Docker License Stars

快速开始 · 入门教程 · 完整文档 · 加入社区

ArcReel 工作台

ArcReel 是什么

ArcReel 是面向 AI 漫剧与小说改编、说书与旁白短视频、广告与带货短片的开源自托管工作台。它把内容分析、资产管理、分镜、媒体生成、费用追踪和导出组织成一条可审核、可中断恢复的生产流水线。

  • 统一生产链路:小说、成品剧本或商品素材都能逐步转化为角色、场景、道具、分镜、视频片段和最终成片。
  • 视觉一致、人工可控:跨镜头复用参考资产,关键阶段可审核,单个素材可重做,历史版本可回滚。
  • 模型与成本可管理:统一配置文本、图像、视频和 TTS 能力,并在生成前后查看费用与实际用量。
  • 交付可继续编辑:既可直接合成视频,也可导出剪映草稿继续调整字幕、配音、节奏和转场。导出面向中国大陆版剪映,与 CapCut 的兼容性尚未验证。

从输入到成片

flowchart LR
    A["小说 / 成品剧本 / 商品素材"] --> B["内容分析与项目规划"]
    B --> C["角色 / 场景 / 道具资产"]
    C --> D["分集与结构化剧本"]
    D --> E["分镜图 / 分镜板"]
    E --> F["视频片段 / 旁白音轨"]
    F --> G["成片合成"]
    F --> H["剪映草稿导出"]

每个阶段都可以由 AI 助手编排,也可以由用户在工作台中审核、调整或重新生成。详细模式选择见 创作流程与模式

快速开始

准备好 Docker 和 Docker Compose,然后运行:

git clone https://github.com/ArcReel/ArcReel.git
cd ArcReel/deploy

cp .env.example .env
docker compose up -d

访问 http://localhost:1241。默认用户名为 adminAUTH_PASSWORD 留空时,首次启动会自动生成密码并回写到 deploy/.env

默认 Compose 会将 1241 端口发布到宿主机所有网络接口。请勿将服务直接暴露到公网;远程访问前请配置认证,并使用 HTTPS、VPN 或安全隧道,详见 反向代理与 HTTPS

登录后进入 设置 页面,配置 ArcReel AI 助手以及文本、图像、视频等生成能力,再创建项目开始制作。

完整的首次使用流程见 完整入门教程;生产部署、升级、备份和反向代理见 部署与运维

文档

页面 内容
文档首页 按使用者、运维者和开发者进入文档
完整入门教程 从首次部署到生成第一条视频
创作流程与模式 小说、剧本、广告模式以及三种视频制作方式
供应商与模型配置 Agent、文本、图像、视频、TTS 供应商的选择和配置
剪映草稿导出 将 ArcReel 生成结果交给剪映继续编辑
常见问题 部署、费用、模型、数据和许可证问题
部署与运维 SQLite、PostgreSQL、升级、备份和反向代理
从 SQLite 迁移到 PostgreSQL 数据迁移、验证与回滚流程
架构说明 Agent Runtime、任务队列、供应商抽象和数据层
贡献指南 本地开发、测试、代码规范和 PR 流程

交流群

扫码加入飞书交流群,获取使用帮助、版本动态和创作经验:

ArcReel 飞书交流群二维码

遇到可以复现的 Bug 或明确的功能需求,也可以直接提交 GitHub Issue

贡献

欢迎贡献代码、文档、测试、供应商适配和问题复现。

开始开发前请阅读 CONTRIBUTING.md。本地克隆后建议立即安装项目的 pre-commit 钩子:

uv run pre-commit install

许可证与商业使用

ArcReel 采用 GNU Affero General Public License v3.0,附加条款见 NOTICE

如果你的组织无法采用 AGPL-3.0,或者希望在不承担 AGPL 开源义务的情况下进行商业部署、白标或再分发,请联系:

support@arc-reel.com

Copyright © 2026 Pollo3470 and ArcReel contributors


如果 ArcReel 对你有帮助,欢迎点亮一个 ⭐ Star。