ArcReel README

The project's README from github.com/ArcReel/ArcReel. As one markdown file: README.md.


ArcReel Logo
ArcReel

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

中文 English

Release Tests Coverage Docker License Stars

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

ArcReel 工作台

赞助商

想出现在这里?

秘塔科技 MiniMax H3 视频生成 API|秘塔科技
秘塔科技提供高性价比的 MiniMax H3 视频生成服务:768P 仅 0.09 元/秒,2K 仅 0.15 元/秒。支持原生 2K、音画同步,API 兼容 OpenAI 协议,同时支持 ComfyUI,无需自行部署 GPU。
🎁 通过 ArcReel 专属链接注册,即可领取赠送额度及专属优惠。

ArcReel 是什么

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

从输入到成片

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 流程

交流群

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

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 开源义务的情况下进行商业部署、白标或再分发,请联系:

[email protected]

Copyright © 2026 Pollo3470 and ArcReel contributors


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

ArcReel (ArcReel/ArcReel)

Searching Database…

5.6K ·GitHub
Что это такое?ArcReel — это открытое ПО для самостоятельного развёртывания: рабочее пространство для производства видео с помощью ИИ, которое превращает романы, готовые сценарии или материалы о продуктах в персонажей, сцены, реквизит, раскадровки, видеоклипы и итоговый монтаж.
Это библиотека, которую я подключаю, или отдельное приложение, которое я запускаю?Это самостоятельное приложение для самостоятельного развёртывания через Docker, а не библиотека. После запуска стека Compose вы работаете с ним через веб-интерфейс.
Как это запустить?Установите Docker и Docker Compose, запустите файл compose проекта, затем откройте веб-интерфейс (порт по умолчанию — 1241) и настройте Agent и провайдеров генерации в Настройках, прежде чем создавать проект.
Нужны ли мне собственные аккаунты у провайдеров ИИ, чтобы пользоваться этим?Да. После запуска ArcReel нужно настроить Agent и отдельных провайдеров для генерации текста, изображений, видео и TTS в Настройках, прежде чем можно будет что-либо создавать.
На какие подводные камни при развёртывании стоит обратить внимание?По умолчанию конфигурация Compose открывает порт 1241 на всех сетевых интерфейсах, поэтому его нельзя напрямую выставлять в интернет. Добавьте аутентификацию и используйте HTTPS, VPN или защищённый туннель для удалённого доступа. Экспорт черновика для Jianying также рассчитан на китайское приложение CapCut в материковом Китае, а совместимость с международной версией CapCut не проверена.
Что на самом деле выдаёт производственный конвейер по ходу работы?Начиная с романа или сценария, ArcReel последовательно создаёт персонажей, сцены, реквизит, раскадровки, отдельные видеоклипы и итоговый монтаж. На каждом этапе результат можно просмотреть или сгенерировать заново.
Можно ли продолжить редактировать результат в CapCut/Jianying после генерации?Да. Помимо сборки итогового видео, ArcReel может экспортировать черновик Jianying (剪映), чтобы вы могли дальше корректировать субтитры, озвучку, темп и переходы. Экспорт рассчитан на китайское приложение материкового Китая и не проверен на международной версии CapCut.
Отслеживает ли он, сколько я трачу на генерацию ИИ?Да, ArcReel позволяет настроить несколько провайдеров для текста, изображений, видео и TTS и показывает оценку стоимости и использования до и после каждого этапа генерации.
Согласованность визуала между кадрами поддерживается автоматически?ArcReel использует эталонные изображения ресурсов (персонажей, сцены, реквизит) в кадрах раскадровки, чтобы сохранять единый визуальный стиль. Если что-то начнёт отличаться, можно заново сгенерировать отдельный ресурс или вернуться к предыдущей версии.
Creator
ArcReel
Size
146 MB
Stars
5.6K
Age
8mo
Commits · 90 Days