【自分用】FramePackインストール完全ガイド（Windows）

![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/4006596/4f52cf5a-11a9-436a-b889-17e40213009d.png)


## はじめに
**FramePack** は 6 GB VRAM で 1 分以上の動画を生成できる次世代ビデオ拡散モデルです。RTX 30/40/50 系 GPU と Windowsを公式サポートし、13 B パラメータでもノート PC で動作します。  

### FramePack のポイント  
1. FramePack の要求スペック  
   * FramePack は 6 GBで済むが、従来の他のモデルは VRAM 12 GB 以上を要求するなど一般ユーザーには敷居が高かった
2. 高解像度・長尺が可能
   * Frame Packing により時系列コンテキスト長を固定化  
   * 動画尺が伸びると計算負荷が線形増大する “drifting” を回避  
   * メモリ不足と計算遅延の対処ができれば高解像度・長尺生成が可能  

---

## 前提条件

| 項目 | 必須要件 | 代替策・注意 |
| ---- | -------- | ------------ |
| GPU | RTX 30/40/50 系、FP16/BF16 対応、6 GB VRAM 以上 | 6 GB 未満は解像度・尺を削減するかクラウド GPU |
| OS | Windows 10/11 |  |
| Python | 3.10 (推奨) | 3.9/3.11 などその他のバージョンは自己責任で|
| ストレージ | 40 GB 以上 (モデル + キャッシュ) | 外付け SSD でも可 |
| ネットワーク | 初回に 30 GB 以上 DL | 回線が細い場合は事前 DL 推奨 |

---


## インストール手順

### Windows (ワンクリックパッケージ)
 - 公式 GitHub の「Installation」Windows からファイルをダウンロードし解凍  
　　https://github.com/lllyasviel/FramePack?tab=readme-ov-file

　　![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/4006596/175f8b94-f601-47b5-ae7e-47cd8f629424.png)

　　ファイルは1.7GB、展開すると5.7GBほど。
 　　※2025/05/11現在


 - モデル更新

        .\update.bat

   ![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/4006596/7e04be1e-4c7b-41b2-bbf9-1662f4ab59fb.png)
   *update.bat を省略すると旧バージョンで GUI がクラッシュすることがあります。*

   Microsoft Defender でポップアップが出る場合、詳細情報から実行ボタンをクリックします。
![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/4006596/71fb04c6-1a9b-40cf-a5df-8c62b50cce3f.png)

   ![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/4006596/0d5d6976-51f9-4ba5-bc00-822a5632462c.png)

   アップデートをかけると、コマンドプロンプトで進行状況が表示されるので、終了まで待ちます。
![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/4006596/b25a0dbe-d4f6-4276-8cf5-25bde8384b90.png)


 - GUI 起動 (初回のみモデルを自動 DL)  

        .\run.bat

   ![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/4006596/5c446454-d592-48a8-887d-343cd9a7a289.png)

   大きなファイルが続くので、気長に待ちましょう。
   最終的には50GB程度になります。
![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/4006596/1d7cbed8-50d4-4f7e-ae8e-84fe5c405ce3.png)


---

## 動作確認 (Sanity Check)
1. README にあるサンプル画像を DL  
2. プロンプト例  

        The man dances energetically, leaping mid-air with fluid arm swings and quick footwork.

3. デフォルト設定で 5 秒生成
4. 生成が止まったように見えても Section 単位で進むのでログを確認  

---
## 動作例
1. Stable Diffusion で生成した画像を用意
　![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/4006596/0dba98af-6a02-4b5b-a47f-c6a7d758f1e8.png)
 <br>
2. プロンプト例

        The girl dances gracefully, with clear movements, full of charm.

 <br>
3. 指が気になるので TeaCache をオフ

 ![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/4006596/60dc1316-8f47-45ca-9fa3-73438f49fccb.png)

 <br>
4. 気長に待ちます
私の環境では、最終フレームから1.1秒分のフレームを生成し、動画ファイルにつなげていっているようです。５秒分なら、このサイクルと５回繰り返してMP4ファイルを生成しています。

![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/4006596/872b33bb-e503-465d-8c91-30b41da9fb7f.png)

![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/4006596/a65a0fd3-01a8-4e16-8b59-b76303e1236e.png)

 <br>
5. できあがりをチェックします


![Videotogif.gif](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/4006596/f06b9c9b-f39d-4887-b317-57a9c8b58480.gif)
※こちらの映像は、生成した動画をアニメーションgifに変換しています。


---

## よくあるハマりどころ

| 症状 | 原因1 | 原因2 | 原因3 | 根本原因 | 対策 |
| ---- | ---- | ---- | ---- | ---------------- | ---- |
| GUI が起動しない | DLL エラー | 依存不一致 | venv 未作成 | グローバルに古い PyTorch | venv 再構築・`pip list` で衝突確認 |
| 起動直後に OOM | VRAM 枯渇 | デフォルト解像度が高過ぎ | GPU 6 GB 未満 | ハード不足 | 解像度 512→256、フレーム数削減 |
| 画質が荒い | TeaCache ON | キャッシュ不足 | 差分誤差蓄積 | 圧縮処理による劣化 | 最終出力は TeaCache OFF |

---

## 次のアクション / 示唆
* bnb 量子化や GGUF でモデル軽量化し VRAM 圧縮 → 画質差を A/B テスト  
* xformers / flash-attn で 1.3–1.7× 高速化  
* 60 秒超の長尺生成時、drifting を抑制するハイパラ最適化  
* Docker 化で再現性を担保し、CI で nightly build を自動テスト  

---

## 参考リンク
* GitHub – [lllyasviel/FramePack](https://github.com/lllyasviel/FramePack)  
* ASCII×AI – [ローカル動画生成AIの革命児「FramePack」の使い方](https://ascii.jp/elem/000/004/264/4264570/)

> 公式 GitHub 以外の “framepack.＊” ドメインは詐欺報告があります。
金銭支払い・ファイル DL は厳禁です。仮に使用した場合でも、個人情報などのセンシティブなテキストは入力しないようにしましょう。

---

FramePack 導入の一助となれば幸いです。
質問や改善提案はコメントでお知らせください 🙌