ArcReel AI Agent

<h1 align="center"> <br> <picture> <source media="(prefers-color-scheme: light)" srcset="docs/assets/logo-animated-light.svg"> <source media="(prefers-color-scheme: dark)" srcset="frontend/public/logo-animated.svg"> <img src="docs/assets/logo-animated-light.svg" alt="ArcReel Logo" width="128"> </picture> <br> ArcReel <br> </h1> <p align="center"> <strong>开源、自托管的 AI 视频生产工作台</strong> <br> 将小说、成品剧本或商品素材转化为角色一致、过程可控、成本可追踪、可继续编辑的短视频。 </p> <p align="center"> <a href="README.md"><img src="https://img.shields.io/badge/lang-中文-red?style=flat-square" alt="中文"></a> <a href="README.en.md"><img src="https://img.shields.io/badge/lang-English-blue?style=flat-square" alt="English"></a> </p> <p align="center"> <a href="https://github.com/ArcReel/ArcReel/releases/latest"><img src="https://img.shields.io/github/v/release/ArcReel/ArcReel?style=flat-square&label=release" alt="Release"></a> <a href="https://github.com/ArcReel/ArcReel/actions/workflows/test.yml"><img src="https://img.shields.io/github/actions/workflow/status/ArcReel/ArcReel/test.yml?style=flat-square&label=tests" alt="Tests"></a> <a href="https://codecov.io/gh/ArcReel/ArcReel"><img src="https://img.shields.io/codecov/c/github/ArcReel/ArcReel?style=flat-square&label=coverage" alt="Coverage"></a> <a href="https://hub.docker.com/r/arcreel/arcreel"><img src="https://img.shields.io/docker/pulls/arcreel/arcreel?style=flat-square&logo=docker&logoColor=white&label=docker%20pulls" alt="Docker"></a> <a href="LICENSE"><img src="https://img.shields.io/badge/license-AGPL--3.0-2ea44f?style=flat-square" alt="License"></a> <a href="https://github.com/ArcReel/ArcReel"><img src="https://img.shields.io/github/stars/ArcReel/ArcReel?style=flat-square" alt="Stars"></a> </p> <p align="center"> <a href="#快速开始"><strong>快速开始</strong></a> · <a href="https://docs.arc-reel.com/guide/getting-started">入门教程</a> · <a href="https://docs.arc-reel.com/">完整文档</a> · <a href="#交流群">加入社区</a> </p> <p align="center"> <img src="docs/assets/screenshots/hero.webp" alt="ArcReel 工作台" width="900"> </p>

赞助商

想出现在这里？

<table> <tr> <td width="200" align="center" valign="top"> <a href="https://metaso.cn/minimax-h3/?s=arc"><img src="docs/assets/sponsors/metaso.png" alt="秘塔科技" width="180"></a> </td> <td valign="top"> <strong>MiniMax H3 视频生成 API｜秘塔科技</strong><br> 秘塔科技提供高性价比的 MiniMax H3 视频生成服务：<strong>768P 仅 0.09 元/秒，2K 仅 0.15 元/秒</strong>。支持原生 2K、音画同步，API 兼容 <strong>OpenAI 协议</strong>，同时支持 <strong>ComfyUI</strong>，无需自行部署 GPU。<br> 🎁 通过 <a href="https://metaso.cn/minimax-h3/?s=arc">ArcReel 专属链接注册</a>，即可领取赠送额度及专属优惠。 </td> </tr> <tr> <td width="200" align="center" valign="top"> <a href="https://ofox.ai/?utm_source=github&utm_medium=sponsorship&utm_content=arcreel"><img src="docs/assets/sponsors/ofox-ai.svg" alt="OfoxAI" width="180"></a> </td> <td valign="top"> <strong>OfoxAI：脚本、图像与视频创作的模型 API</strong><br> 通过 OfoxAI 接入文本、图像和视频模型，为脚本打磨、角色与场景参考图、视频镜头素材选择合适的能力。具体模型的输入要求、支持参数及调用方式请查看 API 文档。<br> <a href="https://ofox.ai/?utm_source=github&utm_medium=sponsorship&utm_content=arcreel">探索 OfoxAI 模型与 API →</a> </td> </tr> <tr> <td width="200" align="center" valign="top"> <a href="https://go.apimart.ai/tw-arcreel"><img src="docs/assets/sponsors/apimart.webp" alt="APIMart" width="180"></a> </td> <td valign="top"> <strong>APIMart：AI 图片/视频生成低价 API</strong><br> 感谢 APIMart 赞助了本项目！APIMart 是专注 AI 图片/视频生成的低价 API 平台，<strong>GPT-Image-2 低至 $0.006/张，1 美元可出图 160+ 张</strong>。图片、视频一套异步 API 通吃，提交任务拿 ID、回调取结果，跑批万张不超时、换模型不改代码。按量付费、无月费，通过<a href="https://go.apimart.ai/tw-arcreel">此注册链接</a>注册即可开用。 </td> </tr> </table>

界面一览

<table> <tr> <td width="50%"><img src="docs/assets/screenshots/video-units.webp" alt="视频单元"></td> <td width="50%"><img src="docs/assets/screenshots/props.webp" alt="道具库"></td> </tr> <tr> <td width="50%"><img src="docs/assets/screenshots/scenes.webp" alt="场景库"></td> <td width="50%"><img src="docs/assets/screenshots/ad-mode.webp" alt="广告/带货模式"></td> </tr> </table>

案例

<div align="center"> <video src="https://github.com/user-attachments/assets/fcc4ceb2-64dd-44a0-a32c-e0c00b2f9796" width="100%" controls></video> </div>

《入职地府后投诉鬼都是我老客户》第 1 集

<div align="center"> <video src="https://github.com/user-attachments/assets/d6bfe589-a5c0-4961-8bfe-b7b59be3bb8a" width="100%" controls></video> </div>

《入职地府后投诉鬼都是我老客户》第 2 集

<div align="center"> <video src="https://github.com/user-attachments/assets/1e580769-80f7-4d14-b46d-68569b6e7e4c" width="100%" controls></video> </div>

《入职地府后投诉鬼都是我老客户》第 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

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

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

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

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

文档

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

交流群

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

<p align="center"> <img src="docs/assets/feishu-qr.png" alt="ArcReel 飞书交流群二维码" width="280"> </p>

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

贡献

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

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

uv run pre-commit install

Star History

<a href="https://www.star-history.com/?repos=arcreel%2Farcreel&type=date&legend=top-left"> <picture> <source media="(prefers-color-scheme: dark)" srcset="https://api.star-history.com/chart?repos=arcreel/arcreel&type=date&theme=dark&legend=top-left" /> <source media="(prefers-color-scheme: light)" srcset="https://api.star-history.com/chart?repos=arcreel/arcreel&type=date&legend=top-left" /> <img alt="Star History Chart" src="https://api.star-history.com/chart?repos=arcreel/arcreel&type=date&legend=top-left" /> </picture> </a>

许可证与商业使用

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

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

support@arc-reel.com

Copyright © 2026 Pollo3470 and ArcReel contributors

---

<p align="center"> 如果 ArcReel 对你有帮助，欢迎点亮一个 ⭐ Star。 </p>