caleb-video-editor Vibe 项目

项目简介

caleb-video-editor（命令行工具名为 Storyboard）是独立开发者 Saeed Vaziry 用 vibe coding 方式做出来的本地化、提示词驱动的动效视频编辑器。项目起因是 Caleb Porzio 的一条推文——他提到自己用 AI 顺手 vibe coded 了一个小编辑器来给视频做动效，Saeed 受此启发把这个想法做成了完整的开源工具。在这个编辑器里，视频的每一个场景都是一小段代码，你不需要在时间轴上手动拖拽，而是坐在实时预览旁边，通过与 Claude Code 或 Codex 对话来逐毫秒地修改场景，做完的视频直接导出为 MP4。项目采用 MIT 许可开源，适合所有想用对话方式做 motion design 的创作者。

核心功能

1. 场景级对话编辑：可以针对单个场景发起对话，也可以就整条视频的节奏、配色、转场提出修改意见，所有改动都发生在实时预览旁边，改完立刻能看到效果。
2. 音乐驱动剪辑：编辑器会自动检测背景音乐的节拍（beats）、小节（bars）和乐句（phrases），把剪辑点吸附到节拍上，让画面切换天然踩点。
3. 音效与动画同步：音效被放在与动画完全相同的时间轴上触发，转场音、强调音与画面动作严格对齐，不需要二次对轨。
4. 本地 AI 作曲与音效生成（可选）：你的 Agent 可以在本机直接为视频创作配乐并生成拟真音效，音乐引擎为 ACE-Step 1.5，音效模型为 Stable Audio Open 1.0，全部离线运行，不消耗云端额度。
5. 双 Agent 支持：Claude Code 和 Codex CLI 都可作为编辑器的对话引擎，在编辑器内的 Agent 选择器随时切换；模型选择器会读取 Codex 本地目录中的可用模型与推理等级。
6. MP4 成品导出：剪辑完成后一键导出标准 MP4 文件，可直接发布到社交平台。

技术实现

Storyboard 是一个运行在本地的 Node.js 应用，要求 macOS 或 Linux 系统以及 Node.js 22.12 或更高版本。视频渲染与导出由 ffmpeg 完成；编辑器本体是一个本地服务，默认监听 5299 端口，浏览器打开即可使用，也支持通过 --host=0.0.0.0 绑定局域网地址，让手机、平板等其他设备访问同一份工程。Agent 集成方面，setup 向导会引导你完成 ffmpeg 安装、Claude Code 或 Codex 的登录授权，以及是否启用音乐与音效生成选项。依赖安装采用 npm ci --ignore-scripts 策略，任何第三方包的安装脚本都不会被执行，从源头避免供应链攻击。可选的音乐引擎 ACE-Step 1.5 遵循 MIT 许可，音效模型 Stable Audio Open 1.0 则从 Hugging Face 下载，使用 Stability AI 社区许可。需要注意的是，局域网共享模式没有登录鉴权，任何能访问该端口的人都能编辑工程，因此只能在可信网络或防火墙保护下使用，切勿暴露到公网。

快速上手

1. 确认系统为 macOS 或 Linux，并安装 Node.js 22.12 及以上版本；
2. 克隆仓库：git clone https://github.com/saeedvaziry/caleb-video-editor.git，进入目录；
3. 运行 ./storyboard setup，按提示完成 ffmpeg、Agent 登录（Claude Code 或 Codex）、音乐音效引擎的选择与安装，全部依赖装在项目文件夹内，随时可重跑修改选项；
4. 运行 ./storyboard start 启动编辑器，在浏览器中打开，于对话框里用自然语言描述你想要的场景效果，配合实时预览逐毫秒调整，完成后导出 MP4。

适用人群

短视频与动效创作者、想把"对话式开发"用在视频剪辑上的开发者、vibe coding 学习者、需要批量产出踩点视频的社交媒体运营者，以及希望所有 AI 管线保留在本机的隐私敏感用户。

出品方与更新动态

由独立开发者 Saeed Vaziry 开源维护，MIT 许可（音乐引擎与音效模型各有独立许可）。仓库于 2026 年 10 月初发布，README 中的首个示例分镜生成于 2026-10-02，目前仍在快速迭代中，文档涵盖使用指南、音乐音效配置、故障排查与二次开发。

官方链接

https://github.com/saeedvaziry/caleb-video-editor