0
1

Delete article

Deleted articles cannot be recovered.

Draft of this article would be also deleted.

Are you sure you want to delete this article?

今話題のFramePack-eichi をwsl2(ubuntu)環境で実行

Last updated at Posted at 2025-05-04

今話題の 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

初回起動時にはモデルのダウンロードが始まり、完了までに数分〜数十分かかります。

スクリーンショット 2025-05-04 191436.png


🎬 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」欄にアニメーションが表示されれば成功です。

スクリーンショット 2025-05-04 203959.png


🚀 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 で簡単に画像〜動画生成が可能
0
1
0

Register as a new user and use Qiita more conveniently

  1. You get articles that match your needs
  2. You can efficiently read back useful information
  3. You can use dark theme
What you can do with signing up
0
1

Delete article

Deleted articles cannot be recovered.

Draft of this article would be also deleted.

Are you sure you want to delete this article?