OpenMontage 使用教程

贴一条参考视频链接,AI照着做同款成片

56K Star · AGPL-3.0

📖 项目简介

OpenMontage 是开源的智能体视频生产系统:把 Claude Code、Cursor、Codex 这类编程助手,变成一条从调研、写稿、生图、配音到成片的流水线。GitHub 搜索 calesthio/OpenMontage,截至 2026-09-07 约 5.65 万星,协议 AGPL-3.0。

它不是「丢一句提示词出几秒片段」。仓库里有 12 条生产管线、100 多个工具、700 多个技能文件。Agent 按 YAML 管线读技能、调工具、自己验收。新能力是贴一条参考视频链接:它扒转写、节奏、分镜和风格,给你两三个方向,本地 Backlot 看板上实时亮,镜头先过目,你点头才渲。

另一条硬能力是真素材成片:从 Archive.org、NASA、Wikimedia 拉真实镜头剪纪录片,不是几张图来回推拉。渲之前算像不像幻灯片,打分不过直接拦;渲完抽帧验画面和声音,自审不过关不给你看。

✨ 核心亮点

🔗
贴链接出同款
丢 YouTube / Short / Reel / 本地成片,它扒节奏和分镜,再给你两三个方向。
📋
Backlot 实时看板
写稿、生图、配音、剪辑跑到哪步亮到哪,镜头先摆给你过目,点头才渲。
🛡️
防幻灯片质检
渲前算像不像 PPT,打分不过直接拦;渲完抽帧验画面和声音。
🎬
真素材纪录片
从公开档案库拉真实镜头剪时间线,不是几张静图来回推拉。

🧩 它能做什么、输出什么

项目说明
输入一句话需求,或一条参考视频链接(YouTube / Short / Reel / TikTok / 本地文件)
适用类型动画讲解、纪录片混剪、口播、录屏演示、播客切片、本地化配音、角色动画、产品片
输出成片 MP4 + 字幕 + Backlot 决策日志;画幅支持横屏、竖屏、方形、电影宽幅
语言 / 兼容中英文脚本都能做;驱动端支持 Claude Code、Cursor、Codex、Copilot、Windsurf
规格 / 容量12 条管线、100+ 工具、60+ 供应商、700+ 技能文件;零密钥也能走 Piper + 公开素材库

🖥️ 环境要求

环境建议配置
操作系统Windows、macOS、Linux 都能跑。Windows 用 PowerShell 按仓库说明装
运行环境Python 3.10+、Node.js 18+、FFmpeg 在 PATH 里。还要一个能读文件、跑命令的编程助手
硬件普通笔记本即可起步。本地生视频才需要独显,走云端接口时本机只负责编排和渲染
低配 / 无卡方案不配云端密钥:Piper 本地配音 + 公开档案库真素材 + Remotion / HyperFrames 合成
关键依赖FFmpeg、Python 虚拟环境、remotion-composer 的 npm 依赖;可选 Piper TTS

🚀 如何使用

💡
最短路径:GitHub 搜索 calesthio/OpenMontage → 克隆后跑 make setup → 用 Codex / Claude Code / Cursor 打开仓库 → 丢一句需求或一条参考视频链接。
1

先装运行环境

本机先有 Python 3.10+、Node.js 18+、FFmpeg。Windows 在 PowerShell 里确认这三条命令都能跑。

powershell python --version node --version ffmpeg -version
2

克隆并初始化

在 GitHub 搜索 calesthio/OpenMontage,克隆到本地。有 make 直接跑 setup;Windows 没有 make 就按仓库 README 的 PowerShell 分步装。

bash git clone calesthio/OpenMontage cd OpenMontage make setup

Windows 没有 make 时,用仓库写明的这条链路:建虚拟环境、装 requirements、进 remotion-composer 跑 npm install、再拷一份环境变量模板。

powershell py -3 -m venv .venv .\.venv\Scripts\Activate.ps1 python -m pip install -r requirements.txt cd remotion-composer npx --yes npm install cd .. python -m pip install piper-tts Copy-Item .env.example .env
3

跑通一个最小例子

用 Codex、Claude Code 或 Cursor 打开这个仓库,把下面任一句话丢给它。第一条是讲解片,第二条是真素材纪录片,第三条是「照着参考视频做同款」。

prompt Make a 45-second animated explainer about why the sky is blue Make a 75-second documentary montage about city life in the rain. Use real footage only, no narration, elegiac tone, with music. Here's a YouTube Short I love. Make me something like this, but about quantum computing.

三条路径怎么选:

你想要的结果怎么说
讲解 / 科普片点名 animated explainer,让它走调研→脚本→配图→合成
真镜头纪录片写明 use real footage only,走 Documentary Montage
照着某条视频做同款先贴链接,再说要保留什么节奏、改成什么主题
4

看板过镜头,再决定渲不渲

生产一开始,Agent 会打开本地 Backlot。脚本、分镜、供应商选择和花费都摊在板上。资源生成会在分镜联系表上暂停,你先过目再继续。

bash python -m backlot open python -m backlot open 项目编号
5

结合 Codex 使用

仓库自带 CODEX.md。用 Codex 打开项目根目录,它会先读 AGENT_GUIDE.md 和管线清单,再选管线、调工具。你不用自己拼 FFmpeg 命令,只要给需求或参考链接,在看板上点头。

prompt 先读 AGENT_GUIDE.md,再用参考视频分析这条片子,给我 3 个方向,等我挑完再渲染。
✅
Codex 负责选管线、调工具、过质检;你只负责给链接和在看板上拍板。

🎯 典型应用场景

🔗
照着爆款做同款
刷到一条节奏对的短视频,贴链接,改成自己的主题。
📚
讲解片 / 科普
先调研再写稿,Remotion 把图和字幕编成讲解片。
🎥
真素材纪录片
从公开档案库拉真实镜头,剪情绪片或历史短片。
🎙️
播客切竖屏
Clip Factory / Podcast Repurpose 把长音频切成一批短片。
💻
软件演示片
Screen Demo 管线把录屏收成产品讲解。
🌍
翻译配音
Localization & Dub 给现成片子上字幕、换语言。

📈 和同类怎么选

对比说明
普通文生视频网站那边给你一段几秒的片段;它给你一整条生产流水线,能过质检再交货
只给静图做推拉它也能走图片路径,但另有真素材纪录片管线,专门防「PPT 成片」
自己手写 FFmpeg它把剪、烧字幕、混音收成工具,Agent 按技能文件调用,决策写进日志
要不要配云端密钥讲解片和真素材片可以零密钥起步;要 Kling / Veo 这类运动镜头再往 .env 里加
🧠
没有单独的编排器。编程助手自己读管线 YAML 和技能 Markdown,Python 只提供工具和存档。质检卡在渲染前后两道门上。

❓ 常见问题

Q: 和普通 AI 视频工具有什么不一样?

普通工具给你一段片段。它把调研、写稿、生图、配音、剪辑、质检串成管线,还能贴参考视频照着做同款,并且会拦幻灯片成片。

Q: 必须配云端密钥吗?

不用。零密钥能走 Piper 配音 + 公开档案库真素材 + Remotion / HyperFrames。要生成运动镜头再加对应供应商的密钥。

Q: Windows 上 make 跑不了怎么办?

按仓库 README 的 PowerShell 分步做:建虚拟环境、装 requirements、进 remotion-composer 用 npx --yes npm install。npm install 报 ERR_INVALID_ARG_TYPE 时也用这条。

Q: 没有独显能不能用?

能。本地生视频才吃显卡。讲解片和真素材剪辑走 CPU + FFmpeg 即可。有卡再开 VIDEO_GEN_LOCAL_ENABLED 跑本地模型。

Q: 参考视频支持哪些来源?

YouTube、Short、Reel、TikTok 和本地成片。Agent 会拆转写、节奏、分镜、风格,再给你两三个差异化方案和工具路径。

Q: 怎么和 Codex / Claude Code / Cursor 结合?

用对应助手打开仓库即可,根目录有 CODEX.md、CLAUDE.md、CURSOR.md。先让它读 AGENT_GUIDE.md,再给需求,不要让它跳过管线自己即兴剪。

Q: 成片看起来像 PPT 怎么办?

这正是它要拦的。渲前有幻灯片风险打分,渲后抽帧验画面。提示词里写明 use real footage only,或走 Documentary Montage。

Q: 协议是什么,能不能用在自己项目里?

仓库是 AGPL-3.0。网络提供服务需要遵守 AGPL 的源码公开要求。具体条款看仓库 LICENSE,按协议使用即可。