📌 项目地址:browser-use/video-use | ⭐ 10,845 颗星 | 🔧 Python | 📜 未标注
什么是 video-use?
video-use 是一个完全开源的视频编辑工具,但它的操作方式很不一样——你不需要打开 Premiere 或 Final Cut,而是直接在终端里跟一个代码 Agent(比如 Claude Code、Codex)对话,告诉它你想怎么剪,它就会自动完成粗剪、校色、加字幕、加动画等任务,最终输出 final.mp4。
项目的核心思路:把原始素材丢进一个文件夹,启动 Agent 后说一句 edit these into a launch video,剩下的交给 Agent 去调用 ffmpeg、ElevenLabs API、HyperFrames/Remotion 等子工具完成。整个流程不需要用户手动编写任何 ffmpeg 命令,也不需要预设模板。
它具体能做什么?
根据 README,video-use 目前内置了以下自动功能:
- 自动剪掉填充词和死区:
umm、uh、错误开头以及拍摄之间的空白片段会被自动切除。 - 自动色彩分级:每段片段自动应用暖色调电影风格或中性明亮风格,也支持自定义 ffmpeg 色彩链。
- 30ms 音频淡入淡出:每个剪辑点加入极短淡入淡出,防止爆音。
- 自动烧录字幕:默认使用“2个单词一组、大写”的风格,可完全自定义。
- 动画覆盖层:通过 HyperFrames、Remotion、Manim 或 PIL 生成动画,每个动画由并行的子 Agent 独立生成。
- 自我评估:Agent 会在每个剪辑边界对渲染输出进行自我检查,有问题才推送给你。
- 会话记忆:项目会维护一个
project.md,下次打开 Agent 时能保持上下文。
这些功能并不是摆设,而是通过 Agent 调用 README 中提到的 helpers/ 目录里的 Python 和 ffmpeg 脚本来实现的。用户不需要关心具体脚本怎么写,Agent 会按需组合调用。
怎么用?三步上手
1. 安装与依赖
按照 README 给出的手动安装方式:
git clone https://github.com/browser-use/video-use ~/Developer/video-use
# 将项目软链到 Agent 的 skills 目录(以 Claude Code 为例)
ln -sfn ~/Developer/video-use ~/.claude/skills/video-use
cd ~/Developer/video-use
uv sync # 或用 pip install -e .
brew install ffmpeg # 必须
brew install yt-dlp # 可选,用于下载在线视频
2. 启动 Agent 并设置
将 README 里提供的 setup prompt 粘贴给 Agent(Claude Code、Codex、Hermes 等)。这段 prompt 会让 Agent 查阅 install.md、SKILL.md 和 helpers/ 目录,自动完成依赖安装、技能注册,并提示你输入 ElevenLabs API 密钥(用于语音合成,可选)。之后 Agent 会等待你放入素材。
3. 开始编辑
把你拍摄的原始视频文件放入一个文件夹(例如 ~/videos/),在终端中启动 Agent:
cd ~/videos
claude # 或其他 Agent
然后在对话窗口中输入:
edit these into a launch video
Agent 会扫描文件夹,提出一个编辑策略,等你确认后开始工作。最终输出在 edit/final.mp4,中间产物也都在 edit/ 目录下,不污染素材文件夹。
看到这里你可能已经发现:整个使用流程中,用户唯一需要做的事就是说出目标,然后等待。这和传统视频编辑工具“手动拖时间线-加效果-导出”的思维完全不同。
和同类工具相比,它有什么不同?
市面上自动视频编辑工具不少,比如:
- Descript:AI 字幕、自动消除填充词,但它是 SaaS,不开源,需要上传到云端,隐私和导出控制有限。
- RunwayML:提供视频生成和编辑,也是闭源、需付费。
- 自动脚本方案:用 Python + ffmpeg 写脚本处理特定场景,但需要编程能力,且每个项目都要重写逻辑。
video-use 的独特之处在于:
- 完全开源:你可以本地部署,数据不出机器。
- 通过 Agent 自然语言驱动:不需要学习软件界面或脚本语言,只需要告诉 Agent 想要什么,剩下由 Agent 自行调用工具链。
- 模块化可扩展:因为使用了并行子 Agent 生成动画(HyperFrames/Remotion),你可以很容易地替换成自己的动画生成脚本。
- 自我评估和会话记忆:这是大多数自动化方案没有的——Agent 会在每次渲染后自我检查,且能记住上次的编辑偏好。
当然,它也有显著的限制:目前依赖 Agent 对 helpers/ 路径的理解能力(你可能需要先用 setup prompt 建立知识),并且一切编辑最终依赖 ffmpeg 的能力,所以复杂特效(多轨合成、关键帧动画)可能不适用。它更适合快速出粗剪、打底稿,比如:
- 录制了一批教程视频,想快速消掉口癖、加字幕、导出一个能发布的版本;
- 旅行片段混剪,统一色调、加标题动画;
- 面试或会议录像,去除多余停顿并烧录说话人名字。
需要注意的几个事项
- 必须要有一个具有 shell 访问权限的 Agent:Claude Code、Codex、Hermes、Openclaw 等,不是普通聊天界面。README 特意提到“set up prompt”帮你快速安装。
- ElevenLabs API 密钥:虽然 README 说是“可选”的,但如果是语音相关内容编辑可能需要。免费版有限额。
- 编辑质量依赖于 Agent 对视频的理解:Agent 通过读取文件元数据、转录文本来判断,如果素材内容复杂(多语言、无说话人、大量纯音乐),自动填充词切除可能不准。你仍可以手动纠正 Agent 的剪辑方案(它会等待你确认)。
- 项目仍处于早期阶段:Star 数已超一万,但功能完备性、错误处理、文档成熟度需要自行评估。建议先在简单的小项目(1-2 个片段)上测试。
如果你厌倦了打开剪辑软件、一层层找设置,又不想自己写几十行 ffmpeg 命令,video-use 提供了一个全新的中间态——用自然语言跟代码 Agent 协作,让它帮你完成 80% 的重复劳动。剩下的精调,通过对话修正也很自然。