OpenMontage 如何配置并验证 HyperFrames 本地渲染运行时【免费下载链接】OpenMontageWorlds first open-source, agentic video production system. 12 production pipelines, 100 tools, 700 agent skill and production-knowledge files. Turn your AI coding assistant into a full video production studio.项目地址: https://gitcode.com/GitHub_Trending/op/OpenMontageOpenMontage 用render_runtime字段决定每个项目由哪个本地引擎合成视频remotion、hyperframes或ffmpeg。当 proposal 阶段把render_runtime锁定为hyperframes动效图形类 brief、kinetic typography、registry block、website-to-video 等场景的默认选择时你的机器必须真正具备 HyperFrames 运行时否则 compose 阶段会被视为 blocker 而不是静默降级。这篇文章的任务分两步先在本机配置好 HyperFrames 运行时Node.js ≥ 22、FFmpeg、npx拉取的hyperframesnpm 包再用make hyperframes-doctor和一套 lint → validate → render 验证链确认它可用。运行时是纯本地的API 成本为 $0但渲染吃 CPUheadless Chrome FFmpeg。以下所有命令都在 OpenMontage 仓库根目录执行。运行时前置条件依据 Makefile、README.md 的 Quick Start 和 tools/video/hyperframes_compose.py 中HyperFramesCompose的install_instructionsruntime_available: true需要同时满足Python 3.10项目整体要求Makefile 中PYTHON_VERSION ? 3.10ffmpeg在 PATH 上macOS/Linux 可用brew install ffmpeg/sudo apt install ffmpegNode.jsmajor 版本 ≥ 22且npx在 PATH 上npx随 Node.js 附带。注意 README.md Quick Start 对整个项目写的是 Node.js 18但 HyperFrames 这条运行时的下限明确是 22做 HyperFrames 合成时按 22 准备能访问公共 npmCLI 通过npx hyperframes按包名hyperframes拉取。源码注释特别强调不要用npx hyperframes/cli——那是 monorepo 内部名不在公共 npm 上会 404bun不是必需的。工具自身的依赖声明是dependencies [cmd:npx, cmd:ffmpeg]doctor操作还会额外校验 npm 包可解析npm view hyperframes version和 CLI 可执行npx --yes hyperframes doctor --json。安装并预热 HyperFrames 缓存主路径就是一条命令make setup它做四件事创建/复用 Python 虚拟环境并安装 requirements.txt进入remotion-composer/执行npm install安装离线 TTSPiper最后执行 HyperFrames 缓存预热——npx --yes hyperframes --version /dev/null 21把hyperframesnpm 包拉进本地 npx 缓存使首次渲染不用付 30–60 秒的冷启动下载约占 20MB 磁盘并顺手打印runtime_available和 npm 解析结果。副作用还包括若不存在则从.env.example复制出.env。make setup结束时它会提示两条可选命令正好是本文的验证入口# 完整验证 HyperFrames 运行时详见下节 make hyperframes-doctor # 随时把 npx 缓存刷新到最新版 make hyperframes-warmhyperframes-warm执行npx --yes --prefer-online hyperframes --version用--prefer-online让 npx 获取自上次运行以来的新版本。如果你的 Node 版本或 npm 网络不满足下限setup 里这一步只输出[skip]提示而不会中断此时应参照doctor的报错处理。用 hyperframes-doctor 验证运行时可用性make hyperframes-doctor该 target 在虚拟环境内调用HyperFramesCompose().execute({operation:doctor})以 JSON 打印完整探测结果末行输出OK或FAIL: 原因。探测分两层见 tools/video/hyperframes_compose.py 的_runtime_check与_doctor本机工具链node --version解析 major 版本要求 ≥ 22、ffmpeg和npx是否在 PATH、npm view hyperframes version是否成功、npx --yes hyperframes doctor --json是否退出码 0CLI 自体检前一层通过后再跑一次完整的npx hyperframes doctor其exit_code、stdout_tail、stderr_tail原样放进结果同时这次调用会预热 npm 缓存。结果中值得关注的字段{ runtime_check: { runtime_available: true, node_major: 22, ffmpeg_available: true, npx_available: true, npm_package: hyperframes, npm_package_version: 0.4.5, npm_resolve_error: null, reasons: [] }, cli_doctor: { exit_code: 0, stdout_tail: ..., stderr_tail: ... } }runtime_available为false时reasons会逐条列出原因如node major version 20 required 22、npm package hyperframes not found (404)、npm view failed: ...。按 skills/core/hyperframes.md 的 Setup Offer 约定按工作量分组处理缺 Node 22 是约 5 分钟的修复缺 FFmpeg 在 macOS/Linux 上约 1 分钟doctor报问题时直接把 doctor 输出原样展示排查。另一种查看方式是 preflight 视角。make preflight打印整个 provider 菜单若只想看合成引擎状态可用 AGENT_GUIDE.md 给出的片段python -c from tools.tool_registry import registry registry.discover() info registry._tools[video_compose].get_info() print(Render engines:, info.get(render_engines)) print(HyperFrames note:, info.get(hyperframes_note)) video_compose.get_info()的render_engines里hyperframes布尔值是 proposal 阶段两个运行时都可用时必须都呈现给用户这条硬性规则的依据。若render_runtimehyperframes已被锁定而运行时不可用文档明确禁止静默换到 Remotion 或 FFmpeg——应把 blocker 报给用户取得批准并记入render_runtime_selection决策后才可以切换。验证渲染链scaffold → lint → validate → renderdoctor 通过只证明环境可用。完整的运行时验证要跑通合成链。在 OpenMontage 中HyperFrames 工作区位于每个项目自己的projects/project-name/hyperframes/下由hyperframes_compose从edit_decisions、asset_manifest和 playbook 生成典型结构是projects/project-name/hyperframes/ ├── index.html # 根合成 ├── compositions/ # 子合成与 registry block ├── assets/ # 项目资产的拷贝/软链 ├── hyperframes.json # CLI 配置registry 地址、安装路径 └── DESIGN.md # playbook 派生的视觉简报可选不要复用remotion-composer/public/作为 HyperFrames 工作区两个运行时混用会互相冲突也不要在流水线里执行hyperframes init——init是给人手动起步项目用的hyperframes_compose直接生成项目文件。hyperframes_compose工具提供一组操作doctor、scaffold_workspace、lint、validate、inspect、check、render、render_existing、add_block其中render操作即完整链条scaffold 生成 HTML/CSS/资产 → lint → validate →npx hyperframes render --output path --fps fps --quality quality。关键行为validate 失败会直接阻断渲染HyperFrames render is blocked — fix the composition and re-run不会带病渲染渲染退出码为 0 但输出文件不存在时同样判失败。对应的 CLI 验证协议skills/core/hyperframes.md Validation protocolnpx hyperframes lint—— 静态契约检查重复 id、轨道重叠、缺失data-composition-id等渲染前必须通过npx hyperframes validate—— 基于浏览器的运行时检查对暂停的合成做 seek、截图、采样像素、计算 WCAG 对比度、校验window.__timelines注册和定时元素上的classclip。迭代期可用--no-contrast跳过对比度最终交付不可跳npx hyperframes render --quality standard—— 产出 MP4渲染后终检ffprobe 探测、抽帧、音频转写并与脚本比对与 Remotion 路径同一契约见final_review.schema.json。工具参数里与验证直接相关的几个quality取draft/standard/highdraft用于迭代、high用于交付默认standardfps取 24/30/60默认 30strict为 true 时任何 lint 错误都会让渲染失败对应hyperframes render --strictskip_contrast只应在迭代期使用。仓库自带一条端到端 QA 用例 tests/qa/test_09_hyperframes_compose.py它通过真实的hyperframesCLI 跑 scaffold lint validate是最省事的完整验证# scaffold lint validate真实 CLI HYPERFRAMES_QA1 python -m pytest tests/qa/test_09_hyperframes_compose.py -v # 再加真实渲染约 1–3 分钟 HYPERFRAMES_QA1 HYPERFRAMES_QA_RENDER1 python -m pytest tests/qa/test_09_hyperframes_compose.py -v副作用说明首次运行 npx 会拉取hyperframes包约 30–90 秒validate 还会下载 headless Chrome 的浏览器约 30 秒之后走缓存。断言即成功条件scaffold 后index.html、assets/hero.png、hyperframes.json三个文件存在全新 scaffold 的 lint 必须干净render 断言要求输出 MP4 存在、大小 5000 字节且ffprobe -v error -select_streams v:0 -show_entries streamcodec_name,duration能取到有效视频流文档示例的探测命令codec_name具体取值因编码而异。另外两个用户可见的验证手段来自工具user_visible_verification直接播放渲染出的 MP4 核对节奏、字体和音频或npx hyperframes preview在浏览器里打开工作区做 scrub。长渲染提交前先用 preview 逐章抽查至少一个 b-roll 主导的场景可以把布局问题拦在渲染前。已知限制与常见陷阱字体HyperFrames 的确定性字体编译器只内联它有映射的字体Space Grotesk会静默回退常见为 Arial。安全选择是Outfit、Montserrat、Inter、JetBrains Mono、Poppins、Playfair Display见 skills/core/hyperframes.md Gotchas in practice。视频密集合成背景视频元素超过 5 个时hyperframes render应传--workers 1否则默认并行捕获会压垮 headless Chrome库存素材关键帧间隔 5s 时渲染会以video_heavy_parallel_timeout失败或产生冻帧需先重编码-c:v libx264 -r 30 -g 30 -keyint_min 30 -sc_threshold 0 -movflags faststart。GSAP 时序不要用repeat: -1的无限 tween会破坏确定性 seek-and-capture 渲染window.__timelines必须在页面加载后同步填充完。能力边界词级烧录字幕remotion_caption_burn、TalkingHead头像合成在 Phase 1 仍是 Remotion 独占不要试图在这条运行时上补齐talking-head、avatar-spokesperson等流水线因此仍是 Deferred。静默换运行时是契约违规render_runtime在 proposal 锁定、经edit_decisions原样传递final review 若发现render_runtime_used与 proposal 不一致会置runtime_swap_detected true。判定标准一条可执行的验收路径make hyperframes-doctor末行输出OK且runtime_available为true说明环境配置完成随后对任意一个projects/p/hyperframes/工作区npx hyperframes lint与npx hyperframes validate通过、npx hyperframes render产出可用 ffprobe 探测到视频流的 MP4说明本地渲染链完整可用。doctor 报FAIL时按reasons与cli_doctor.stdout_tail逐条处理lint/validate 失败时修复合成后重跑不要直接渲染。【免费下载链接】OpenMontageWorlds first open-source, agentic video production system. 12 production pipelines, 100 tools, 700 agent skill and production-knowledge files. Turn your AI coding assistant into a full video production studio.项目地址: https://gitcode.com/GitHub_Trending/op/OpenMontage创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考 OpenMontage 如何配置并验证 HyperFrames 本地渲染运行时？
OpenMontage 如何配置并验证 HyperFrames 本地渲染运行时【免费下载链接】OpenMontageWorlds first open-source, agentic video production system. 12 production pipelines, 100 tools, 700 agent skill and production-knowledge files. Turn your AI coding assistant into a full video production studio.项目地址: https://gitcode.com/GitHub_Trending/op/OpenMontageOpenMontage 用render_runtime字段决定每个项目由哪个本地引擎合成视频remotion、hyperframes或ffmpeg。当 proposal 阶段把render_runtime锁定为hyperframes动效图形类 brief、kinetic typography、registry block、website-to-video 等场景的默认选择时你的机器必须真正具备 HyperFrames 运行时否则 compose 阶段会被视为 blocker 而不是静默降级。这篇文章的任务分两步先在本机配置好 HyperFrames 运行时Node.js ≥ 22、FFmpeg、npx拉取的hyperframesnpm 包再用make hyperframes-doctor和一套 lint → validate → render 验证链确认它可用。运行时是纯本地的API 成本为 $0但渲染吃 CPUheadless Chrome FFmpeg。以下所有命令都在 OpenMontage 仓库根目录执行。运行时前置条件依据 Makefile、README.md 的 Quick Start 和 tools/video/hyperframes_compose.py 中HyperFramesCompose的install_instructionsruntime_available: true需要同时满足Python 3.10项目整体要求Makefile 中PYTHON_VERSION ? 3.10ffmpeg在 PATH 上macOS/Linux 可用brew install ffmpeg/sudo apt install ffmpegNode.jsmajor 版本 ≥ 22且npx在 PATH 上npx随 Node.js 附带。注意 README.md Quick Start 对整个项目写的是 Node.js 18但 HyperFrames 这条运行时的下限明确是 22做 HyperFrames 合成时按 22 准备能访问公共 npmCLI 通过npx hyperframes按包名hyperframes拉取。源码注释特别强调不要用npx hyperframes/cli——那是 monorepo 内部名不在公共 npm 上会 404bun不是必需的。工具自身的依赖声明是dependencies [cmd:npx, cmd:ffmpeg]doctor操作还会额外校验 npm 包可解析npm view hyperframes version和 CLI 可执行npx --yes hyperframes doctor --json。安装并预热 HyperFrames 缓存主路径就是一条命令make setup它做四件事创建/复用 Python 虚拟环境并安装 requirements.txt进入remotion-composer/执行npm install安装离线 TTSPiper最后执行 HyperFrames 缓存预热——npx --yes hyperframes --version /dev/null 21把hyperframesnpm 包拉进本地 npx 缓存使首次渲染不用付 30–60 秒的冷启动下载约占 20MB 磁盘并顺手打印runtime_available和 npm 解析结果。副作用还包括若不存在则从.env.example复制出.env。make setup结束时它会提示两条可选命令正好是本文的验证入口# 完整验证 HyperFrames 运行时详见下节 make hyperframes-doctor # 随时把 npx 缓存刷新到最新版 make hyperframes-warmhyperframes-warm执行npx --yes --prefer-online hyperframes --version用--prefer-online让 npx 获取自上次运行以来的新版本。如果你的 Node 版本或 npm 网络不满足下限setup 里这一步只输出[skip]提示而不会中断此时应参照doctor的报错处理。用 hyperframes-doctor 验证运行时可用性make hyperframes-doctor该 target 在虚拟环境内调用HyperFramesCompose().execute({operation:doctor})以 JSON 打印完整探测结果末行输出OK或FAIL: 原因。探测分两层见 tools/video/hyperframes_compose.py 的_runtime_check与_doctor本机工具链node --version解析 major 版本要求 ≥ 22、ffmpeg和npx是否在 PATH、npm view hyperframes version是否成功、npx --yes hyperframes doctor --json是否退出码 0CLI 自体检前一层通过后再跑一次完整的npx hyperframes doctor其exit_code、stdout_tail、stderr_tail原样放进结果同时这次调用会预热 npm 缓存。结果中值得关注的字段{ runtime_check: { runtime_available: true, node_major: 22, ffmpeg_available: true, npx_available: true, npm_package: hyperframes, npm_package_version: 0.4.5, npm_resolve_error: null, reasons: [] }, cli_doctor: { exit_code: 0, stdout_tail: ..., stderr_tail: ... } }runtime_available为false时reasons会逐条列出原因如node major version 20 required 22、npm package hyperframes not found (404)、npm view failed: ...。按 skills/core/hyperframes.md 的 Setup Offer 约定按工作量分组处理缺 Node 22 是约 5 分钟的修复缺 FFmpeg 在 macOS/Linux 上约 1 分钟doctor报问题时直接把 doctor 输出原样展示排查。另一种查看方式是 preflight 视角。make preflight打印整个 provider 菜单若只想看合成引擎状态可用 AGENT_GUIDE.md 给出的片段python -c from tools.tool_registry import registry registry.discover() info registry._tools[video_compose].get_info() print(Render engines:, info.get(render_engines)) print(HyperFrames note:, info.get(hyperframes_note)) video_compose.get_info()的render_engines里hyperframes布尔值是 proposal 阶段两个运行时都可用时必须都呈现给用户这条硬性规则的依据。若render_runtimehyperframes已被锁定而运行时不可用文档明确禁止静默换到 Remotion 或 FFmpeg——应把 blocker 报给用户取得批准并记入render_runtime_selection决策后才可以切换。验证渲染链scaffold → lint → validate → renderdoctor 通过只证明环境可用。完整的运行时验证要跑通合成链。在 OpenMontage 中HyperFrames 工作区位于每个项目自己的projects/project-name/hyperframes/下由hyperframes_compose从edit_decisions、asset_manifest和 playbook 生成典型结构是projects/project-name/hyperframes/ ├── index.html # 根合成 ├── compositions/ # 子合成与 registry block ├── assets/ # 项目资产的拷贝/软链 ├── hyperframes.json # CLI 配置registry 地址、安装路径 └── DESIGN.md # playbook 派生的视觉简报可选不要复用remotion-composer/public/作为 HyperFrames 工作区两个运行时混用会互相冲突也不要在流水线里执行hyperframes init——init是给人手动起步项目用的hyperframes_compose直接生成项目文件。hyperframes_compose工具提供一组操作doctor、scaffold_workspace、lint、validate、inspect、check、render、render_existing、add_block其中render操作即完整链条scaffold 生成 HTML/CSS/资产 → lint → validate →npx hyperframes render --output path --fps fps --quality quality。关键行为validate 失败会直接阻断渲染HyperFrames render is blocked — fix the composition and re-run不会带病渲染渲染退出码为 0 但输出文件不存在时同样判失败。对应的 CLI 验证协议skills/core/hyperframes.md Validation protocolnpx hyperframes lint—— 静态契约检查重复 id、轨道重叠、缺失data-composition-id等渲染前必须通过npx hyperframes validate—— 基于浏览器的运行时检查对暂停的合成做 seek、截图、采样像素、计算 WCAG 对比度、校验window.__timelines注册和定时元素上的classclip。迭代期可用--no-contrast跳过对比度最终交付不可跳npx hyperframes render --quality standard—— 产出 MP4渲染后终检ffprobe 探测、抽帧、音频转写并与脚本比对与 Remotion 路径同一契约见final_review.schema.json。工具参数里与验证直接相关的几个quality取draft/standard/highdraft用于迭代、high用于交付默认standardfps取 24/30/60默认 30strict为 true 时任何 lint 错误都会让渲染失败对应hyperframes render --strictskip_contrast只应在迭代期使用。仓库自带一条端到端 QA 用例 tests/qa/test_09_hyperframes_compose.py它通过真实的hyperframesCLI 跑 scaffold lint validate是最省事的完整验证# scaffold lint validate真实 CLI HYPERFRAMES_QA1 python -m pytest tests/qa/test_09_hyperframes_compose.py -v # 再加真实渲染约 1–3 分钟 HYPERFRAMES_QA1 HYPERFRAMES_QA_RENDER1 python -m pytest tests/qa/test_09_hyperframes_compose.py -v副作用说明首次运行 npx 会拉取hyperframes包约 30–90 秒validate 还会下载 headless Chrome 的浏览器约 30 秒之后走缓存。断言即成功条件scaffold 后index.html、assets/hero.png、hyperframes.json三个文件存在全新 scaffold 的 lint 必须干净render 断言要求输出 MP4 存在、大小 5000 字节且ffprobe -v error -select_streams v:0 -show_entries streamcodec_name,duration能取到有效视频流文档示例的探测命令codec_name具体取值因编码而异。另外两个用户可见的验证手段来自工具user_visible_verification直接播放渲染出的 MP4 核对节奏、字体和音频或npx hyperframes preview在浏览器里打开工作区做 scrub。长渲染提交前先用 preview 逐章抽查至少一个 b-roll 主导的场景可以把布局问题拦在渲染前。已知限制与常见陷阱字体HyperFrames 的确定性字体编译器只内联它有映射的字体Space Grotesk会静默回退常见为 Arial。安全选择是Outfit、Montserrat、Inter、JetBrains Mono、Poppins、Playfair Display见 skills/core/hyperframes.md Gotchas in practice。视频密集合成背景视频元素超过 5 个时hyperframes render应传--workers 1否则默认并行捕获会压垮 headless Chrome库存素材关键帧间隔 5s 时渲染会以video_heavy_parallel_timeout失败或产生冻帧需先重编码-c:v libx264 -r 30 -g 30 -keyint_min 30 -sc_threshold 0 -movflags faststart。GSAP 时序不要用repeat: -1的无限 tween会破坏确定性 seek-and-capture 渲染window.__timelines必须在页面加载后同步填充完。能力边界词级烧录字幕remotion_caption_burn、TalkingHead头像合成在 Phase 1 仍是 Remotion 独占不要试图在这条运行时上补齐talking-head、avatar-spokesperson等流水线因此仍是 Deferred。静默换运行时是契约违规render_runtime在 proposal 锁定、经edit_decisions原样传递final review 若发现render_runtime_used与 proposal 不一致会置runtime_swap_detected true。判定标准一条可执行的验收路径make hyperframes-doctor末行输出OK且runtime_available为true说明环境配置完成随后对任意一个projects/p/hyperframes/工作区npx hyperframes lint与npx hyperframes validate通过、npx hyperframes render产出可用 ffprobe 探测到视频流的 MP4说明本地渲染链完整可用。doctor 报FAIL时按reasons与cli_doctor.stdout_tail逐条处理lint/validate 失败时修复合成后重跑不要直接渲染。【免费下载链接】OpenMontageWorlds first open-source, agentic video production system. 12 production pipelines, 100 tools, 700 agent skill and production-knowledge files. Turn your AI coding assistant into a full video production studio.项目地址: https://gitcode.com/GitHub_Trending/op/OpenMontage创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考