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
+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
#290Codex model list stays outdated after refreshing connection (OpenFilm 0.2.6)4 comments · 2026-10-28#230桌面版几条体验建议:做完提醒、附件预览、回复底部的模型、导出推荐、Claude Code 版本提示4 comments · 2026-10-24#452macbook导出视频一直报错失败3 comments · 2026-11-12#3030.2.6 长片实测:46 条缺陷与不足(渲染不能续、片段属性无关键帧、声音无处理链、MCP 工具拿不到 等)3 comments · 2026-10-29#440One from-scratch film turn ran 85 min, grew the session to 48.6 MB of base64 stills, and never ended after the film had already exported2 comments · 2026-11-10#431Cant navigate in my folders..2 comments · 2026-11-09#225DeepSeek Harness:新配置默认选的线路要 API key,只登录了账号的人第一句话就报错2 comments · 2026-10-24#464考虑多agent协作1 comments · 2026-11-14
Discussions
#474软件的一些问题1 comments · 2026-11-15#472Feature: Multi-worker export setting in OpenFilm Studio UI0 comments · 2026-11-15#462导出很慢,素材需要每帧生成 png1 comments · 2026-11-13#456Feature Request: Add Mobile Notifications for Agent Task Completion (Telegram, Webhooks & Other Providers)1 comments · 2026-11-13#439Openfilm桌面端的智能体选择与制作质量是否挂钩?1 comments · 2026-11-10#436Discord community for faster feedback loop1 comments · 2026-11-09#412content understanding and B-roll search for agent-built films3 comments · 2026-11-08#400我想给大家分享一点Skill,在哪里可以上传呢?2 comments · 2026-11-08
Latest release
v0.3.2 v0.3.2 2026-11-09OpenFilm 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
相关报道 (4)
News & coverage (4)
Hacker NewsShow HN: OpenFilm – Turn any coding agent into a video editor▲ 1 · 0 comments · 2026-10-19bilibiliThis year's most powerful open-source project: openfilm, a god-tier skill in the automatic editing world, the results are truly... Keyframe editing tutorial, video noise ...2026-10-302days클로드 코드로 영상 만들기 OpenFilm 설치와 쇼츠 편집 내보내기2026-10-24bilibiliI asked Codex to make a video with OpenFilm: official sample, actual final cut, and rework review2026-10-24