公開したてで細々とした調整や不具合修正をしています。
Update.bat で問題が解決したり、このREADMEに重要なことが追記されたりしますので、ご注意ください。
Hunyuan Video を簡単に試せる環境です。
- 簡単インストールで Kijai 版 や Native 版 のモデルや LoRA も一式ダウンロード
- SageAttention, FastVideo, TeaChache の併用で Geforce RTX 3060 でも高速・省 VRAM 生成
- 日本語プロンプトや LLM・TIPO プロンプト拡張に対応
- アップスケール、フレーム補間、自動・手動モザイクに対応
- MMAudio による音声生成に対応
動作確認環境: NVIDIA Geforce 3060 12GB 搭載の Windows PC (RAM 64GB, ストレージ 100GB 程度)
- EasyHunyuanVideoInstaller.bat を右クリックから保存します。
- インストール先の空フォルダを
C:/EasyHunyuan/などの浅いパスに用意して、ここにEasyHunyuanVideoInstaller.batを移動して実行します。WindowsによってPCが保護されましたと表示されたら、詳細表示から実行します。
- インストール先の
EasyHunyuanVideo/vs_BuildTools.exeを実行して、Microsoft の Visual Studio Build Tools のC++ によるデスクトップ開発をインストールします。
EasyHunyuanVideo/cuda_12.6.3_windows_network.exeを実行して、NVIDIA の CUDA Toolkit をインストールします。- CUDA Toolkit に対応したドライバや Geforce Experience も同時にインストールされます。
Geforce Experience が不要な場合は、インストールオプションのカスタムから変更します。
- CUDA Toolkit に対応したドライバや Geforce Experience も同時にインストールされます。
Download.batを実行して、モデルや LoRA をダウンロードします。
ComfyUi.bat で EasyHunyuanVideo が起動し、Update.bat で更新できます。
- アバストなどの Windows Defender でないセキュリティソフトが有効だと、インストールに失敗する場合があります。
- Windows PC の管理者権限がないと、インストールに失敗する場合があります。
- ダウンロード中にエラーが発生する場合は、
EasyTools/Download/Aria_UseCurl.batを実行してから再インストールします。- または、PC の管理者権限で
EasyTools/EnableLongPaths.batを実行してから再インストールします。
- または、PC の管理者権限で
- VPN を利用していると、インストールに失敗する場合があります。
- プロキシ環境でインストールに失敗する場合は、Git for Windows と Python 3.10.x に パスを通してから 再インストールします。
チュートリアルは高速な Kijai 版 で解説していますが、Kijai 版は動作環境がシビアです。
動作しない場合は以下を試してみてください。
HunyuanVideo Model Loaderのattention_modeをspdaにする。
- ComfyUI ネイティブ版の
Easy/20_HunyuanVideo_Nativeを利用する。
ComfyUi.batを実行するとブラウザで ComfyUI が起動します。- インストール先の
Sample/から好みの*.png画像を選んで、ComfyUI にドラッグ＆ドロップします。 実行で動画の生成を開始します。初回はモデルの追加ダウンロードで時間が掛かります。- プロンプト入力欄左側の
SeedノードでRandomize Each Timeすると、バリエーションを生成できます。
- プロンプト入力欄左側の
- 生成した動画は
Output/にあります。*.mp4は通常の動画で、*.webpは加工用の劣化しない動画（ただし大きくて重い）です。*.pngはワークフロー保存用の画像です。
- 気に入った動画が生成できたら、左側ツールバーの
📂からEasy/40_Upscale.jsonワークフローを開きます。画像を読み込むで*.webpをドラッグ＆ドロップなどで読み込んで実行するとアップスケールします。
- 同様に
Easy/50_Refine_NoobEで、img2img で書き加えた*.webp動画を生成します。- フレーム間のちらつきは
Tile ControlNetの強度を上げたり、Kサンプラーのノイズ除去を下げたりして抑え、フレーム補間でも滑らかにします。
- フレーム間のちらつきは
- 同様に
Easy/60_Detail_NoobEで、顔などを拡大して img2img で書き加えた*.webp動画を生成します。- フレーム間のちらつきは
Tile ControlNetの強度を上げたり、Kサンプラーのノイズ除去を下げたりして抑え、フレーム補間でも滑らかにします。
- フレーム間のちらつきは
- 同様に
Easy/70_Interpolateで、フレーム補間によって滑らかにした*.mp4動画を生成します。 - 最後に
Easy/80_MMAudioで滑らかにした*.mp4を読み込んで音声を生成します。Seed違いの生成や、プロンプトの工夫で当たり音声を引いてください。
Easy/ 以下のワークフローは更新 (Update.bat) で最新状態になります。
編集したワークフローを残したい場合は別名で保存してください。
- VRAM 不足のエラーの後に、そのまま再度
実行すると正常に動作する場合があります。 - 上部メニューの
Managerの右にあるUnload Modelsした後に実行すると正常に動作する場合があります。 HunyuanVideo Samplerノードでwidth,height(384 x 512など),num_frames（73 や 97 など） を下げます。
widthやheightを下げた場合はflow_shiftも下げたほうがよいかもしれません。HunyuanVideo Decodeノードで止まる場合は、spatial_tile_sample_min_sizeを128にします。Easy/20_HunyuanVideo_Nativeワークフローを使用すると、生成は遅くなりますが低 VRAM や低 RAM でも生成できる場合があります。
- プロンプト入力欄左の
ControlPanelでいろいろな機能の有効無効を切り替えられます。 - 通常のプロンプト入力欄である
Promptでは、Dynamic Promptを使用できます。TIPOを有効にすると、少量のプロンプトからプロンプトのバリエーションを生成できます。
- LoRA は
ControlPanelで LoRA 1-5 を有効にして、LoRA を選択してトリガーワードを指定します。- 左にある通常の LoRA 読み込みノードで LoRA を選択し、右クリックから
View Lora Info...でトリガーワードや Civitai ページを確認できます。
Civitai の LoRA 作者のプロンプトをぜひ参考にしてください（画像生成よりプロンプトがシビアです）。
- LoRA の影響が強すぎる場合に、
Get_LbwDobleと LoRA ノードを繋ぐと影響を軽減できる場合があります。
- 左にある通常の LoRA 読み込みノードで LoRA を選択し、右クリックから
LLM Promptでは日本語プロンプトを英訳したり、さらにプロンプトの続きを生成したりできます。TranslateJaを有効にすると、生成用プロンプトの日本語訳を確認できます。Shape Mosaicでは手動で指定した丸や四角のモザイクを、Segm Mosaicでは自動検出でモザイクをかけられます。*.webpのロスレス出力を30_Mosaicワークフローで読み込んで、後からモザイク処理をすることもできます。*.webpをネットで共有する場合は、ロスレスをfalseにしてください。
Upscale,Interpolateも同様に、後から処理できます。
- 動画の解像度や長さなどのパラメータは
HunyuanVideo Samplerノードで編集できます。- num＿frames は 73（3秒）～ 145 (6秒) ぐらいがオススメです。
- 解像度や LoRA との相性？で、flow_shift を
6.0~20.0ぐらいに変更すると、結果が良くなる場合があります。
- NVIDIA Cosmos 対応を追加しました。
Download/Cosmos.batで必要なファイルをダウンロードしてから、ワークフローのEasy/Cosmos_ImageToVideoやEasy/Cosmos_TextToVideoで生成できます。- Geforce RTX 3060 で 1280x704 の 121フレーム生成に 45分程度掛かります。
- リファイン・アップスケール・フレーム補間などは Hunyuan 用のワークフローを流用できます。
- Flux example の ImageToVideo 例
- NoobAI Epsilon Prediction v1.1 と ControlNet Tile で、動画を詳細にする
Easy/50_Refine_NoobEとEasy/60_Detail_NoobEのワークフローを追加しました。- フレーム間のちらつきは
Tile ControlNetの強度を上げたり、Kサンプラーのノイズ除去を下げたりして抑え、フレーム補間でも滑らかにします。
- フレーム間のちらつきは
- サンプルを 4種追加しました。
- Python がインストールされていない環境で、Kijai 版ワークフローが動作しない不具合を修正しました。
- サンプルを 1 種追加しました。
- LoRA を 5 種追加しました。
Easy/20_HunyuanVideo_Nativeワークフローに First Block Cache のノードを追加しました。- ComfyUI の起動時に
--use-sage-attentionオプションを追加するComfyUi_SageAttention.batを追加しました。 Easy/のワークフローで webp 保存のロスレスを無効にしました。ComfyUI/user/default/workflowsへのリンクをWorkflow/に作成しました。- アンインストール について追記しました。
Easy/20_HunyuanVideo_Nativeワークフローで TeaChache による高速化に対応しました。- LoRA を 8 種追加しました。
- EasyHunyuanVideo を公開しました。
- サンプルのダウンロードの不具合を修正しました。
- 各種ノードによる HuggingFace からのダウンロードに失敗する一部環境のために、
Download.batでダウンロードするファイルを増やしました。
- インストール先のフォルダを削除します。
- 容量の多くをインストール先のフォルダが占めていますので、これでアンインストール完了とするのがオススメです。
- Visual Studio Build Tools と CUDA Toolkit は Windows の
アプリ-インストールされているアプリからアンインストールできます。- ただし、CUDA Toolkit といっしょにインストールされる
NVIDIA グラフィックス ドライバー、NVIDIA オーディオ ドライバー、PhysX システム ソフトウェアあたりはアンインストールすると PC が正常に動作しなくなる可能性があります。 - Visual Studio Build Tools のアンインストールで問題が起こる可能性は低い想定です。
- ただし、CUDA Toolkit といっしょにインストールされる
このリポジトリの内容は MIT License です。
別途ライセンスファイルがあるフォルダ以下は、そのライセンスです。