by ArcReel
AI Agent 驱动的开源视频生成工作台 — 小说→角色/场景/道具设计→剧本→分镜图→视频,跨镜头角色与场景一致 | Open-source AI video workspace powered by AI Agents, Nano Banana 2 & Veo 3.1 / Grok / Seedance / OpenAI
# Add to your Claude Code skills
git clone https://github.com/ArcReel/ArcReelLast scanned: 4/25/2026
{
"issues": [],
"status": "PASSED",
"scannedAt": "2026-04-25T05:50:44.376Z",
"semgrepRan": false,
"npmAuditRan": true,
"pipAuditRan": true
}graph TD
A["📖 上传小说"] --> B["🔍 全局角色/线索提取"]
B --> C["✂️ 分集规划与切分"]
C --> D["📝 剧本预处理与 JSON 生成"]
D --> E["👤 生成角色设计图"]
D --> F["🔑 生成线索设计图"]
E --> G["🖼️ 生成分镜图 / 宫格图"]
F --> G
G --> H["🎬 生成视频片段"]
H --> I["🎞️ FFmpeg 合成最终视频"]
H --> J["📦 导出剪映草稿"]
⚠️ 操作系统:Linux / MacOS / Windows WSL2(Claude Agent SDK 及部分依赖仅兼容 POSIX 环境,Windows 原生暂不支持,请使用 Docker Desktop 或 WSL2)
git clone https://github.com/ArcReel/ArcReel.git
cd ArcReel/deploy
cp .env.example .env
docker compose up -d
# 访问 http://localhost:1241
cd ArcReel/deploy/production
cp .env.example .env # 需设置 POSTGRES_PASSWORD
docker compose up -d
首次启动后,使用默认账号登录(用户名 admin,密码在 .env 中通过 AUTH_PASSWORD 设置;未设置则首次启动时自动生成并回写到 .env),前往 设置页(/settings)完成配置:
📖 详细步骤请参考 完整入门教程
No comments yet. Be the first to share your thoughts!
ArcReel 通过统一的 ImageBackend / VideoBackend / TextBackend 协议,支持多个预置供应商和自定义供应商,可在全局或项目级别切换:
| 供应商 | 可用模型 | 能力 | 计费方式 | |--------|----------|------|----------| | Gemini (Google) | Nano Banana 2, Nano Banana Pro | 文生图、图生图(多参考图) | 按分辨率查表 (USD) | | 火山方舟 | Seedream 5.0, Seedream 5.0 Lite, Seedream 4.5, Seedream 4.0 | 文生图、图生图 | 按张计费 (CNY) | | Grok (xAI) | Grok Imagine Image, Grok Imagine Image Pro | 文生图、图生图 | 按张计费 (USD) | | OpenAI | GPT Image 2, GPT Image 1.5, GPT Image 1 Mini | 文生图、图生图(多参考图) | 按张计费 (USD) |
| 供应商 | 可用模型 | 能力 | 计费方式 | |--------|----------|------|----------| | Gemini (Google) | Veo 3.1, Veo 3.1 Fast, Veo 3.1 Lite | 文生视频、图生视频、视频延展、负面提示词 | 按分辨率 × 时长查表 (USD) | | 火山方舟 | Seedance 2.0, Seedance 2.0 Fast, Seedance 1.5 Pro | 文生视频、图生视频、视频延展、音频生成、种子控制、离线推理 | 按 token 用量 (CNY) | | Grok (xAI) | Grok Imagine Video | 文生视频、图生视频 | 按秒计费 (USD) | | OpenAI | Sora 2, Sora 2 Pro | 文生视频、图生视频 | 按秒计费 (USD) |
| 供应商 | 可用模型 | 能力 | 计费方式 | |--------|----------|------|----------| | Gemini (Google) | Gemini 3.1 Flash, Gemini 3.1 Flash Lite, Gemini 3 Pro | 文本生成、结构化输出、视觉理解 | 按 token 用量 (USD) | | 火山方舟 | Doubao Seed 系列 | 文本生成、结构化输出、视觉理解 | 按 token 用量 (CNY) | | Grok (xAI) | Grok 4.20, Grok 4.1 Fast 系列 | 文本生成、结构化输出、视觉理解 | 按 token 用量 (USD) | | OpenAI | GPT-5.5, GPT-5.4, GPT-5.4 Mini, GPT-5.4 Nano | 文本生成、结构化输出、视觉理解 | 按 token 用量 (USD) |
除预置供应商外,可接入任何 OpenAI 兼容 或 Google 兼容 API:
/v1/models 发现可用模型,按名称推断媒体类型(图片/视频/文本)供应商选择优先级:项目级设置 > 全局默认。切换供应商时通用设置(分辨率、宽高比、音频等)直接沿用,供应商特有参数保留。
扫码加入飞书交流群,获取帮助和最新动态:
ArcReel 的 AI 助手基于 Claude Agent SDK 构建,采用编排 Skill + 聚焦 Subagent 的多智能体架构:
flowchart TD
User["用户对话"] --> Main["主 Agent"]
Main --> MW["manga-workflow<br/>编排 Skill"]
MW -->|"状态检测"| PJ["读取 project.json<br/>+ 文件系统"]
MW -->|"dispatch"| SA1["analyze-characters-clues<br/>全局角色/线索提取"]
MW -->|"dispatch"| SA2["split-narration-segments<br/>说书模式片段拆分"]
MW -->|"dispatch"| SA3["normalize-drama-script<br/>剧集动画规范化"]
MW -->|"dispatch"| SA4["create-episode-script<br/>JSON 剧本生成"]
MW -->|"dispatch"| SA5["资产生成 Subagent<br/>角色/线索/分镜/视频"]
SA1 -->|"摘要"| Main
SA4 -->|"摘要"| Main
Main -->|"展示结果<br/>等待确认"| User
核心设计原则:
ArcReel 支持通过 OpenClaw 等外部 AI Agent 平台调用,实现自然语言驱动的视频创作:
arc- 前缀)http://your-domain/skill.md 自动获取)技术实现:API Key 认证(Bearer Token)+ 同步 Agent 对话端点(POST /api/v1/agent/chat),内部对接 SSE 流式助手并收集完整响应返回。
flowchart TB
subgraph UI["Web UI — React 19"]
U1["项目管理"] ~~~ U2["素材预览"] ~~~ U3["AI 助手"] ~~~ U4["任务监控"]
end
subgraph Server["FastAPI Server"]
S1["REST API<br/>路由分发"] ~~~ S2["Agent Runtime<br/>Claude Agent SDK"]
S3["SSE Stream<br/>实时状态推送"] ~~~ S4["Auth<br/>JWT + API Key"]
end
subgraph Core["Core Library"]
C1["VideoBackend 抽象层<br/>Gemini · 火山方舟 · Grok · OpenAI · 自定义"] ~~~ C2["ImageBackend 抽象层<br/>Gemini · 火山方舟 · Grok · OpenAI · 自定义"]
C5["TextBackend 抽象层<br/>Gemini · 火山方舟 · Grok · OpenAI · 自定义"] ~~~ C3["GenerationQueue<br/>RPM 限速 · Image/Video 通道"]
C4["ProjectManager<br/>文件系统 + 版本管理"]
end
subgraph Data["数据层"]
D1["SQLAlchemy 2.0 Async ORM"] ~~~ D2["SQLite / PostgreSQL"]
D3["Alembic 迁移"] ~~~ D4["UsageTracker<br/>多供应商费用追踪"]
end
UI --> Server --> Core --> Data
| 层级 | 技术 |
|------|------|
| 前端 | React 19, TypeScript, Tailwind CSS 4, wouter, zustand, Framer Motion, Vite |
| 后端 | FastAPI, Python 3.12+, uvicorn, Pydantic 2 |
| AI 智能体 | Claude Agent SDK (Skill + Subagent 多智能体架构) |
| 图像生成 | Gemini (google-genai), 火山方舟 (volcengine-python-sdk[ark]), Grok (xai-sdk), OpenAI (openai) |
| 视频生成 | Gemini Veo 3.1 (google-genai), 火山方舟 Seedance 2.0/1.5 (volcengine-python-sdk[ark]), Grok (xai-sdk), OpenAI Sora 2 (openai