今話題の FramePack-eichi を Ubuntu(WSL2)環境で動かす手順
現在注目されている動画生成フレームワーク FramePack-eichi を、Ubuntu(WSL2)環境で動作させる手順を紹介します。
Windows 上では比較的簡単に動作しますが、今回は WSL2(Ubuntu) 上でのセットアップを試みました。
※ 本記事では、Anaconda3 等で Python 実行環境が整備済みであることを前提とします。
🔍 FramePack-eichi とは?
FramePack-eichi
は、lllyasviel 氏による lllyasviel/FramePack をベースに、nirvash 氏が改良した nirvash/FramePack をさらに拡張したプロジェクトです。
公式 GitHub リポジトリ(英語版):
👉 https://github.com/dijama/FramePack-eichi-eng
✅ Step 1: nirvash/FramePack を動かす
まずは元となる nirvash/FramePack
を導入・確認します。
📥 ダウンロード
以下のいずれかからダウンロード:
ダウンロード後、framepack_cu126_torch26
フォルダを WSL2 の任意の場所に配置します。
🛠 Step 2: 仮想環境のセットアップと動作確認
cd framepack_cu126_torch26/webui
python -m venv venv
source venv/bin/activate
pip install -r requirements.txt
途中で torchvision
が無いというエラーが出た場合は以下を実行:
pip install torchvision
その後、以下のコマンドで Gradio サーバーを起動:
python demo_gradio.py --server 127.0.0.1
初回起動時にはモデルのダウンロードが始まり、完了までに数分〜数十分かかります。
🎬 Step 3: 動作確認
* Running on local URL: http://127.0.0.1:7860
To create a public link, set `share=True` in `launch()`.
と、表示されたら、
ブラウザで以下にアクセス:
(上の utlリンクをctrlキーを押しながタップすると、ブラウザが開きます。)
http://127.0.0.1:7860/
左上の「Image」欄に画像をドロップし、プロンプトを入力して「Start Generation」を押すと、処理が開始されます。
生成完了後、「Finished Frames」欄にアニメーションが表示されれば成功です。
🚀 Step 4: FramePack-eichi を導入
リポジトリをクローン
cd ~/your_workspace
git clone https://github.com/git-ai-code/FramePack-eichi.git
ファイルを上書きコピー
FramePack-eichi/webui
以下のファイルをすべて framepack_cu126_torch26/webui/
にコピーします:
cp -r FramePack-eichi/webui/* framepack_cu126_torch26/webui/
▶ Step 5: FramePack-eichi の起動
python endframe_ichi.py
以下のように表示されたら成功です:
* Running on local URL: http://127.0.0.1:8001
ブラウザでアクセスして、FramePack-eichi のインターフェースが表示されれば完了です。
(上の utlリンクをctrlキーを押しながタップすると、ブラウザが開きます。)
✅ まとめ
- WSL2(Ubuntu)でも FramePack-eichi の導入・動作は可能
-
torchvision
など一部依存関係は手動インストールが必要 - Gradio UI で簡単に画像〜動画生成が可能