The open source AI video agent: turns any coding agent into a video agent, with an editor to change anything it makes.

★ 7,697⑂ 749👁 24⑃ 349● 89▤ 16
TypeScriptMITCreated 2026-10-04openfilm.dev
下载:v0.3.2v0.3.2 ↓0.3.22026-11-09
+440
日增长
+2,253
周增长
7,697
stars
749
forks
24
watchers
349
prs
89
issues
16
releases

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),从什么时候

Top issues

Discussions

Latest release

v0.3.2 v0.3.2 2026-11-09
OpenFilm 0.3.2 improves project switching on Windows, brings more of the edit across to other editors, and makes the canvas and asset library work together.

Projects and workspace. Open and switch project tabs more reliably on Windows. Duplicate a project from its menu, or reference media on a network share that disallows system links. The chat divider resizes the workspace and asset drawer together, and the inspector scrolls with a trackpad.

Canvas and timeline. Canvas writing nodes take text, image and video references. Videos rest on their opening frame, play on hover and can give you a s

Snapshot: 2026-11-16T09:23:14Z · Data license Apache-2.0 · JSON