OpenMontage 安装配置教程 Windows 源码部署详解 Python Remotion

OpenMontage 是 GitHub 46k Star 的开源 AI 视频制作系统，支持 Python + Node.js + Remotion + FFmpeg。本文详细介绍 Windows 环境下的源码部署安装配置过程，包含国内镜像加速、字体本地化修复、版本冲突解决等。

一、项目简介

OpenMontage 是全球首个开源的智能体驱动视频制作系统（46,160 Star）。它将 AI 编程助手（Claude Code、Cursor、Copilot 等）变成完整的视频制作工作室。

你只需用自然语言描述需求，AI 自动完成：

网络调研 → 概念提案 → 脚本撰写 → 场景规划 → 素材生成（图片/视频/配音/音乐）→ 剪辑合成 → 字幕烧录 → 质量自检 → 最终视频输出

零 API Key 也能制作视频：Piper TTS 提供免费离线配音，Remotion 提供免费动画合成，FFmpeg 提供免费视频处理。

核心看点

1. OpenMontage Windows 部署完整步骤（含命令行）
2. pip 清华镜像 + npm 淘宝镜像加速配置
3. Google Fonts CORS 错误修复（字体本地化方案）
4. Remotion @remotion/fonts 版本冲突解决
5. FontFace delayRender 超时修复（CSS @font-face 方案）

二、GitHub 数据一览

项目	信息
项目名称	OpenMontage
GitHub 地址	https://github.com/calesthio/OpenMontage
Star 数	46,160 ⭐
Fork 数	5,721 🍴
开源协议	AGPL-3.0
主语言	Python
技术栈	Python 3.10+, Remotion (React/Node.js), HyperFrames, FFmpeg, Piper TTS

三、环境准备

软件	版本要求
Python	3.10 及以上
Node.js	22 及以上
npm	10 及以上
FFmpeg	最新稳定版
Git	最新稳定版
Google Chrome	最新版（Remotion 渲染需要）

💡 提示：建议使用 Windows 10/11 64 位系统，本文所有命令均在 PowerShell 中执行。

四、详细部署步骤

4.1 安装前置软件

依次安装 Python、Node.js、Git、FFmpeg 和 Google Chrome。安装完成后逐一验证：

python --version
# 应输出 Python 3.10.x 或更高

node --version
# 应输出 v22.x.x 或更高

npm --version
# 应输出 10.x.x 或更高

ffmpeg -version
# 应输出 ffmpeg 版本信息

git --version
# 应输出 git version x.x.x

4.2 配置国内镜像源（加速下载）

国内网络环境下，pip 和 npm 默认源下载极慢，务必先配置镜像源：

# pip 配置清华镜像源
pip config set global.index-url https://pypi.tuna.tsinghua.edu.cn/simple

# npm 配置淘宝镜像源
npm config set registry https://registry.npmmirror.com

4.3 克隆项目代码

git clone https://github.com/calesthio/OpenMontage.git
cd OpenMontage

4.4 创建 Python 虚拟环境

python -m venv .venv
.\.venv\Scripts\Activate.ps1

⚠️ 注意：如果 PowerShell 提示执行策略错误，先运行：Set-ExecutionPolicy -Scope CurrentUser RemoteSigned

4.5 安装 Python 依赖

python -m pip install -r requirements.txt

配置好清华镜像源后通常 3-5 分钟内完成。

4.6 安装 Remotion 合成器

cd remotion-composer
npx --yes npm install
cd ..

⚠️ 注意：这里必须使用 npx --yes npm install，而不是直接 npm install，否则 Windows 下会报 ERR_INVALID_ARG_TYPE 错误。

4.7 安装 Piper 离线 TTS

python -m pip install piper-tts

Piper TTS 提供完全免费的离线语音合成，无需任何 API Key。

4.8 创建 .env 配置文件

Copy-Item .env.example .env

⚠️ 注意：.env 文件必须放在项目根目录，和 requirements.txt 同级，切勿放在子目录中。

4.9 修复 Google Fonts 字体问题（国内必做）

❗ 原因：Remotion 默认从 Google Fonts CDN 加载字体，国内网络无法访问，会导致 CORS 错误和渲染失败。

解决方案：将字体文件下载到本地，通过 CSS @font-face 引用，实现字体本地化。

python fix_fonts.py

❗ 警告：如果 fix_fonts.py 报 FileNotFoundError [WinError 2]，原因是 Windows 下 npm 实际是 npm.cmd，需要在 subprocess 调用中添加 shell=True 参数。

4.10 验证部署

python render_demo.py world-in-numbers

✅ 成功：看到视频输出文件即代表整个 AI 视频制作流水线已经跑通，可以开始用自然语言驱动 AI 制作视频了。

五、踩坑与解决方案

5.1 pip/npm 下载极慢

💡 解决：配置清华镜像源（pip）和淘宝镜像源（npm），下载速度可提升 10 倍以上。

5.2 npm install 报 ERR_INVALID_ARG_TYPE

⚠️ 解决：Windows 下直接运行 npm install 会报参数类型错误，改用 npx --yes npm install 即可正常安装。

5.3 .env 文件位置不明确

⚠️ 解决：.env 必须放在项目根目录，和 requirements.txt 同级。

5.4 Remotion 渲染报 CORS/字体错误

❗ 解决：Google Fonts CDN 被墙，需将字体本地化。下载字体文件到本地，通过 CSS @font-face 引用。

5.5 fix_fonts.py 报 FileNotFoundError [WinError 2]

❗ 解决：Windows 下 npm 实际是 npm.cmd，Python 的 subprocess 找不到它。在调用中添加 shell=True 参数即可。

5.6 Remotion Version mismatch

❗ 解决：@remotion/fonts 版本与 Remotion 主包冲突，需从 package.json 中移除该依赖，使用项目内置的字体加载方式。

5.7 字体 404 Not Found

❗ 解决：glob 匹配顺序错误导致找不到字体文件。正确的匹配模式应为 *latin*400*normal*。

5.8 delayRender 超时

❗ 解决：FontFace.load() 在无头 Chrome 中不可靠，会触发 delayRender 超时。改用 CSS @font-face 声明方式加载字体。

5.9 虚拟环境未激活导致工具不可用

⚠️ 解决：每次打开新的 PowerShell 窗口，都必须先激活虚拟环境 .\.venv\Scripts\Activate.ps1。

5.10 Remotion 找不到浏览器

⚠️ 解决：通过 --browser-executable 参数显式指定 Chrome 路径：

npx remotion render --browser-executable="C:\Program Files\Google\Chrome\Application\chrome.exe" ...

六、功能验证

验证项	预期结果
工具注册表	FFmpeg / Remotion / HyperFrames / Piper TTS 全部为 True
合约测试	630 passed（全部通过）
Backlot 看板	浏览器访问 http://localhost:4750 正常打开
渲染演示视频	python render_demo.py world-in-numbers 成功输出视频文件

✅ 成功：以上四项全部通过，说明 OpenMontage 已完全就绪，可以开始制作视频了。

七、常见问答

Q1：零 API Key 真的能做视频吗？
可以。Piper TTS 提供免费离线配音，Remotion 提供免费动画合成，FFmpeg 提供免费视频处理，三者组合即可完成完整的视频制作流水线，全程无需任何 API Key。

Q2：需要什么 AI 编程助手？
Claude Code / Cursor / Copilot / Windsurf / Codex 任选其一即可。OpenMontage 通过 MCP 协议与这些助手对接。

Q3：部署需要多长时间？
配置好镜像源后约 15-30 分钟。主要耗时在依赖下载和 Remotion 安装上。

Q4：支持 GPU 加速吗？
支持。有 NVIDIA GPU 的用户可以运行 make install-gpu 来安装 GPU 加速版本。

Q5：项目怎么使用？
用 AI 编程助手（如 Claude Code）打开项目目录，用自然语言描述需求即可。

八、总结

OpenMontage 的部署难度中等偏低，核心难点集中在国内网络环境下的字体本地化和Windows 下 npm 的兼容性处理。只要按照本教程的 10 个步骤依次操作，15-30 分钟即可完成部署。

适合人群：

• 🎬 AI 视频制作爱好者
• ✍️ 内容创作者
• 💻 开发者

---

如果这篇教程对你有帮助，欢迎点赞收藏！

👍 点赞 · ⭐ 收藏 · 💬 评论 · 🔔 关注

标签：OpenMontage、Python、Remotion、FFmpeg、AI视频制作、开源项目部署、Windows