README

开源的 AI 视频智能体。

一个 HTML 文件，一个函数，一个真正的剪辑器。

English · 简体中文

 简介

OpenFilm 让你的编程智能体来做视频，也让你亲手修改。

让 Codex、Claude Code 或任何编程智能体做一部片子。它把片子写成网页，Studio（一个在浏览器里运行的本地剪辑器）
实时显示片子成形的过程。之后哪里想改就改，可以自己动手，也可以直接跟它说。

- 一个 HTML 文件。 film.html 把动画网页、视频素材、图片和声音按轨道剪在一起，样式用 CSS 写。不用学新东西：
  你的智能体本来就懂网页。
- 一个函数。 每个镜头都是一个网页，用 frame(t) 画出任意时刻，浏览器能画的都能用：three.js、WebGL、canvas、
  SVG、CSS、GSAP、视频等等。不需要框架（比如 Remotion 或 HyperFrames）：一个函数就够了。
- 一个真正的剪辑器。 可以移动、缩放、旋转页面里的任何元素，改它的文字、颜色和样式；摆放、裁剪、调整每个片段的
  样式，在时间线上修剪和切分。


▶ 观看 1 分 42 秒的发布视频（英文），从头到尾都是用 OpenFilm 做的。

 安装

需要 Node 22.2+ 和 ffmpeg，支持 macOS、Windows、Linux（Studio 保存版本还需要 git）；第一次运行会下载一个无界面的
Chromium（约 100 MB）。

sh
npx skills add openfilm/openfilm


然后让你的智能体做一部片子：

 给我的命令行工具做一支 20 秒的发布视频，带配乐。

它会在 Studio 里打开这部片子，你能看着它一步步成形。如果你的智能体不支持 skill，就对它说：“运行
npx -y openfilm@latest，按它打印的内容来做。”

也可以从 openfilm.dev 或 Releases
下载 macOS 或 Windows 桌面版：就是 Studio，旁边多了一个对话窗口，接上你已有的智能体。它自带 ffmpeg 和无界面浏览器，
不用另外安装。

制作、剪辑和渲染片子都不需要账号，OpenFilm 素材库里的音乐、音效、音色、贴纸、转场、特效和模板都可以免费使用。需要生成
配音、音乐、图片和视频时，在 Studio 的设置 → 服务里，用你自己的 key 连接你在用的服务（ElevenLabs、OpenAI、Google、
OpenRouter、fal 等），或者登录 OpenFilm，不用自己的 key 也能生成。

想从一部完整的片子开始，可以打开一个示例：

sh
npx -y openfilm@latest open https://github.com/openfilm/examples/tree/main/one-prompt


 命令

这些命令由你的智能体来运行；你也可以自己运行：npx -y openfilm@latest ，或者先 npm i -g openfilm。

sh
openfilm                           片子是什么，以及 OpenFilm 自带的技能：智能体从这里开始
openfilm open   [folder | url]     在 Studio 里打开片子：新建、打开已有的、从 GitHub 获取，或者当前目录的、上次打开的
openfilm look   [what] [t | a-b]   检查片子、某个页面或媒体文件：缩略图总览、单帧或一段区间
openfilm render [a-b]              渲染成 MP4；--4k、--blur（运动模糊）、--alpha（.webm / .mov）、--loudness=-14
openfilm get    [what]             素材：先从 OpenFilm 素材库免费取，没有再用你接入的服务生成
openfilm canvas [apply ]    剪辑旁边的画布：读取，或者摆上笔记、文件和要生成的内容
openfilm skills                    可以用来做片子的技能；openfilm skill  打印其中一个
openfilm doctor                    这台电脑上 OpenFilm 需要的东西，可以直接贴进 issue


openfilm  --help 列出某个命令的选项；单独运行 openfilm get 会列出能生成什么、素材库里有什么，以及怎么在
Studio 里接入服务。

 Studio

Studio 在你的电脑上运行，在浏览器里打开。片子里的一切都能改：画面里的文字和图层，时间线上的片段，它们的位置、外观、
音量和速度，还有字幕。你的修改会保存到片子的文件里，智能体能看到并保留它们；你也可以保存带名字的版本，随时回退。
可以导出视频、GIF、声音或分轨、字幕、静帧、幻灯片、透明背景视频，也可以把整条时间线导出给
Final Cut Pro、Premiere Pro 和 DaVinci Resolve。

剪辑旁边是画布（⌘E 在两者之间切换）：你和智能体可以在上面摆笔记、图片、视频、配音、音乐和音效，把它们连起来，用你的
服务逐个生成，再按顺序送到时间线。一个项目可以有多个画布，每个也能看成分镜。素材库在素材抽屉里，有视频素材、音色、音效、
音乐、文字、贴纸、滤镜、特效、转场、模板，还有技能。

桌面版（apps/desktop）就是 Studio 加上一个对话窗口，可以用 Claude Code、Codex 等智能体，也可以用
它自带的智能体配上你自己的 key。

 技能

片子怎么做写在技能里，而不是写死在工具里。openfilm 只打印一页：片子是什么，以及 OpenFilm 自带的技能，其余的都在
这些技能里：edit（项目、film.html 和页面，以及怎么检查）、media（素材库和各项服务）、canvas（画布）。智能体
用 openfilm skill  读取当前任务需要的那个。

其他技能各是一种做片子的方法，用全名 owner/name 区分。Studio 素材库的「发现」里列出 OpenFilm 官方和社区的技能，
来自 openfilm/skills，那里也说明了怎么写一个技能。可以在那里安装，也可以不安装
直接在对话里试用，或者从链接、文件夹添加你自己的（openfilm skill add ）。装好的技能所有智能体都能用。

 工作原理

一部片子就是一个带 film.html 的文件夹：由片段组成的轨道剪在一起。

html


  .card { object-fit: cover; border-radius: 24px; }


  


  


  



每个  是一条轨道，顺序和时间线上一致：第一条在最上层。一个片段就是一个元素：页面、视频、静态图片或声音。
播放文件的哪一段用媒体片段标记（t=12,18），从什么时候开始用 at

Top issues

Discussions

Latest release

OpenFilm 0.3.1 brings the built-in OpenFilm agent, editable workspace layouts, system notifications, complete-original editing exports, and a faster first visit to the canvas.

- Use the built-in OpenFilm agent with your Services account. Manage the order and visibility of its Claude, GPT and DeepSeek models.
- Edit your workspace layout: move and resize panels, create nested splits, undo changes, and save, import or export named layouts.
- Receive system notifications when an agent finishes, fails or needs an answer while OpenFilm is in the background. Click a notification to return to its pr