「動画をコードで書く」と聞くと身構える人は多いでしょう。ただ、AIコーディングエージェントはコードを書けても、動画編集ソフトのタイムラインをドラッグできません。ならば動画のほうをコードにしてしまえ、という発想で作られたのが hyperframes(hyper frames) です。
hyperframesは、AIアバター動画で知られる HeyGen(heygen-com) が公開した動画フレームワークです。一言でいえば「Write HTML. Render video. Built for agents.」。HTML・CSS・アニメーションで書いたシーンを、ヘッドレスChromeとFFmpegで 決定論的なMP4 に変換します。ライセンスはApache-2.0、言語はTypeScript、GitHubスターは執筆時点で 35,145 です。エージェント側の設計はAIエージェントフレームワーク比較2026|LangGraph・CrewAI・Dify等9種をStar数・実コードで検証も参考になります。
VIDEO AS CODE動画の作り方
タイムラインをドラッグする代わりに、HTMLで書く
従来の動画編集ソフト
GUIで素材を並べる
- タイムラインを手で操作する
- 同じ結果の再現は保証されない
- AIエージェントは直接触れない
hyperframes
HTMLを書いてMP4にする
- HTML・CSS・GSAPでシーンを記述
- 同じ入力なら毎回同じMP4
- エージェントがスキル経由で操作
HTML・CSS・GSAPなどで書いたシーンを、1フレームずつ時刻を指定して描画し、FFmpegでMP4にします。出力が毎回同じなので、エージェントが「作る→確認する→直す」を安心して回せます。スキルは公開時点で約20、2026-10-11の実測では34本でした。導入は npx skills add heygen-com/hyperframes --full-depth --yes の1行です。
hyperframes(hyper frames)とは何か:HTMLを書くとMP4になる
hyperframesは動画編集ツールではなく、動画をコードで書くための基盤です。Webページを作る感覚でシーンを記述し、動画として書き出します。公式は使い方を3通りに整理しています。
・① ローカルのCLI:手元でコマンドを叩き、HTMLのシーンをMP4にします。
・② エージェントからスキル経由:Claude CodeやCursorにスキルを足し、自然言語で「製品紹介動画を60秒で」と頼みます。
・③ 描画コアとして組み込む:Open Designのような別アプリが、内部の動画エンジンとして使います。
対応するアニメーションのランタイムは、GSAP / Lottie / Three.js / Anime.js / CSS / WAAPI / TypeGPU のアダプタです。新しい動画専用言語を覚えず、既に知っているWeb技術で書けるのが学習コストの低さにつながります。
hyperframesの仕組み:決定論的MP4ができるまで
hyperframesの核心はレンダリングパイプラインです。ここを押さえると、なぜ「決定論的」で「エージェント向き」なのかが分かります。
画面を実時間で録画する方式は、マシンが重いとコマ落ちし、速いと間延びします。実行環境で結果が変わるわけです。hyperframesは再生せず、「この時刻の画面を描いて」とChromeに フレーム単位で時刻を指定(シーク) します。マシンの速さが違っても、指定時刻の見た目は同じです。
RENDER PIPELINEレンダリングの流れ
実時間で録画せず、1フレームずつ時刻を指定して描く
-
シーン記述
HTML・CSS・GSAPなど
-
Chrome
各フレームの時刻へシーク
-
フレーム列
1コマずつ静止画で取得
-
FFmpeg
動画ストリームに結合
-
MP4
同じ入力なら同じ出力
この方式には条件があります。任意のフレームを正確に描くには、アニメーションが「時刻を与えれば状態が一意に決まる」ものでなければなりません。実時間やランダム性に依存する書き方は、シークすると破綻します。そのため、シーク安全なキーフレームの書き方を扱う hyperframes-keyframes スキルが用意されています。
1フレームずつ描いた静止画をFFmpegが1本に結合し、MP4として書き出します。入力(HTML・CSS・素材・設定)が同じなら途中のフレームも最終のMP4も毎回同じになります。これが公式のいう「決定論的MP4」の中身です。
エージェントは「作る→確認する→直す」を高速で回して品質を上げます。出力がぶれると、自分の修正が効いたのか偶然なのかを判別できず、改善が空回りします。さらにシーク可能なので、動画全体を描かなくても問題のフレームだけを確認でき、デバッグの単位が細かくなります。
決定論的であることの実利は3つあります。
・エージェントの反復が成立する:出力がぶれないので、修正が効いたかどうかを判別できます。
・Git管理とCIに乗る:動画のソースがテキストなので、差分でレビューでき、CIでもローカルと同じ結果になります。
・分散レンダリングの正しさを担保する:どのマシンで描いても同じなので、複数のLambdaにフレームを分けて並列描画できます。
スキルは公開時約20、2026-10-11の実測で34本
hyperframesを「エージェント向け」にしているのがスキル群です。入口は意図ルーターの /hyperframes で、依頼内容を読んで適切なスキルに振り分けます。必要なスキルだけを読み込むため、コンテキストを圧迫しません。
| 種類 | 主なスキル | 用途 |
|---|---|---|
| 作成ワークフロー | /product-launch-video /website-to-video /pr-to-video |
製品紹介、Webサイトからの動画化、PRの変更点解説 |
| 作成ワークフロー | /motion-graphics /slideshow /faceless-explainer /embedded-captions |
モーション、スライド、解説動画、字幕の焼き込み |
| 移行 | /remotion-to-hyperframes |
Remotionからの一方向の移行 |
| ドメイン | /hyperframes-keyframes /hyperframes-animation /media-use |
シーク安全なキーフレーム、アニメーション、BGM・画像の組み込み |
入口の /hyperframes は「能力マップ」と「意図ルーター」を兼ねます。「この目的ならこのワークフロー」と振り分けるので、30以上のスキルを一度にエージェントへ渡す必要がありません。これは、スキルをオンデマンドで読み込んでコンテキストを節約するという、エージェント設計の定石を動画制作に当てはめた形です。
動画生成系のスキルをまとめて調べた記事は動画生成Agent Skill 20本を全部cloneした|ライセンスとスキル数を実測にあります。デザインは公式テンプレートが土台になります。
テンプレートは見た目の出発点です。ゼロから配色やレイアウトを組まなくても、テンプレートを土台にして hyperframes-creative や hyperframes-animation のスキルで崩していけば、安定感と独自の表現を両立できます。たとえば「Creative Mode」は、定型から離れて自由に表現したいときのプリセットです。
使い方:導入・CLI・クラウド
前提は Node.js 22以上 です。レンダリングにはヘッドレスChromeとFFmpegも使います。導入コマンドは次のとおりです。
npx skills add heygen-com/hyperframes --full-depth --yes
--full-depth を省くと、skills add はskills.shレジストリのキャッシュから取得し、これが main より数時間古いことがあります。公式は --full-depth 付きを推奨しています。対応エージェントはClaude Code・Cursor・Gemini CLI・Codexなどです。
実体として動くのはCLIです。ローカルでは次の順に進めます。
CLI FLOWローカルの手順
ビルドと同じ順で進む。doctorで環境を先に確かめる
-
init
プロジェクトの雛形を作る
-
doctor
Node・Chrome・FFmpegを診断
-
lint / check
シーンの静的検査と妥当性確認
-
render
本番のMP4を生成(preview で部分確認も可)
CLIは npx でインストールなしに呼べます。環境診断はこの1行です。
npx -y hyperframes@0.8.149 doctor
ほかに snapshot(特定フレームの見た目を固定して差分検出)、publish(書き出し)があります。ソフトウェア開発の「init→lint→test→build」によく似た体系で、動画がビルドパイプラインとして扱われていると分かります。規模を広げたいときは、HeyGenのホスト型 cloud render と、AWS Lambdaで分散描画する lambda deploy / render / progress が使えます。
2026-10-11にcloneして測り直しました。npx -y hyperframes@0.8.149 --help は exit 0 でコマンド一覧を返しました。リポジトリ内のCLIパッケージ名は @hyperframes/cli ですが、この名前はnpmに存在せず(npm view は404)、公開名はスコープなしの hyperframes です。npx @hyperframes/cli と打つと失敗します。確認コマンドは次のとおりです。
npx -y hyperframes@0.8.149 --help # exit 0 でコマンド一覧
npm view @hyperframes/cli # E404(未公開)
| 確認項目 | 2026-10-11の実測 |
|---|---|
| ライセンス | Apache-2.0 |
| 追跡ファイル | 9,260本 |
| ユニークなSKILL.md | 34本(公開時は約20) |
| npm上のCLI | hyperframes 0.8.149(@hyperframes/cli は未公開) |
Remotion・従来の編集ソフトとの違い
| 観点 | hyperframes | Remotion | 従来の動画編集ソフト |
|---|---|---|---|
| 作り方 | HTML・CSS+GSAP/Lottie/Three.jsなど | Reactコンポーネントで記述 | GUIのタイムライン |
| 再現性 | 同じ入力なら毎回同じMP4 | プログラム的で再現性は高い | 手作業に依存 |
| エージェント連携 | 意図ルーターとスキル群 | ライブラリとして呼べる | GUI前提で直接操作は困難 |
| ソース管理 | テキストでGit管理・CI可能 | コードなのでGit管理可能 | バイナリ寄りで差分が見にくい |
| ライセンス | Apache-2.0(HeyGen製) | 独自ライセンス(用途により有償) | 多くは商用製品 |
動画はフレームごとに独立して描けるため、Lambdaのように複数の関数へ分割すれば長尺や高解像度でも描画時間を縮められます。決定論的であることが、この分割描画の正しさを支えています。
差は3点です。素のHTML/CSSと複数アダプタで書けること、エージェントが迷わないようスキルまで作り込んでいること、決定論を明示的な設計目標にしていることです。「ライブラリとして呼べる」ことと「エージェントが迷わず使える」ことは別物です。
向いている人と注意点
特に向くのは、AIエージェントで動画制作を自動化したいチームです。すでにClaude CodeやCursorを使っているなら、スキルを1つ足すだけで動画を作る能力が手に入ります。pr-to-video のように開発フローに直結したスキルがあるのは、開発者向けツールとしての性格をよく表しています。
向くのは、リリースごとの紹介動画やPRごとの解説動画を依頼文だけで回したいチーム、動画をコード資産としてGit管理したい開発者、GSAPやThree.jsの経験があるフロントエンド開発者です。
- 実行環境:Node.js 22以上、ヘッドレスChrome、FFmpegが必要です。まず
doctorで診断します。 - シーク可能性:実時間やランダム性に依存する書き方は破綻します。
- クラウド利用:
cloud renderとLambdaはHeyGenやAWSの利用料が別途かかります。 - 素材の権利:BGM・画像・フォントは各素材のライセンスに従います。
- 向かない領域:実写映像の切り貼りや色補正が中心の編集は守備範囲外です。
実写素材をエージェントで編集したいなら、VideoAgent 解説|動画の理解・編集・リメイクを自律化するAIエージェントのようなツールが向きます。
hyperframesは、HTMLを書いて決定論的なMP4にするエージェント向けOSSです。シーク描画で出力が固定されるため、エージェントの反復、Git管理、CI、分散レンダリングが成り立ちます。スキルは実測34本、CLIの公開名は hyperframes です。
参照ソース
・heygen-com/hyperframes(公式リポジトリ) — 仕様・スキル・CLI・アダプタ
・hyperframes — npm — 配布されているCLI。2026-10-11に 0.8.149 を実行して確認
・Remotionのライセンス条件は変わりうるため、利用前に公式で要確認





