---
title: "ComfyUI-HunyuanImage2.1 を試す | grasys blog"
url: "https://blog.grasys.io/post/t-watanabe/comfyui-hunyuanimage2-1/"
description: "はじめに こんにちは！ grasys でデータ周りの仕事をしている t.watanabe です 今回は Tencent が開発した HunyuanImage-2.1 を ComfyUI で扱えるようにした、ComfyUI-HunyuanImage2.1 を試してきましたのでインストール方法と使い方をレポートしたいと思…"
---

# ComfyUI-HunyuanImage2.1 を試す

-   ![](/_astro/noicon.CTHOhNiB_1HMs6A.webp)[t.watanabe](/authors/t-watanabe/)
-   公開日：2025年10月8日
-   カテゴリー：[Tech](/categories/tech/)
-   タグ：[#comfyui](/tags/comfyui/)[#Python](/tags/python/)

![ComfyUI-HunyuanImage2.1 を試す](/_astro/hero.CVwOr91L_1kosAA.webp)

## はじめに

こんにちは！

grasys でデータ周りの仕事をしている t.watanabe です

今回は Tencent が開発した [HunyuanImage-2.1](https://github.com/Tencent-Hunyuan/HunyuanImage-2.1) を [ComfyUI](https://www.comfy.org/) で扱えるようにした、[ComfyUI-HunyuanImage2.1](https://github.com/KimbingNg/ComfyUI-HunyuanImage2.1) を試してきましたのでインストール方法と使い方をレポートしたいと思います

## 前提環境

環境は以下のものにインストールしていきます

-   CPU: Ryzen 9 3900X
    
-   Memory: DDR4 64GiB
    
-   OS: Ubuntu 20.04
    
-   GPU: RTX 5090 VRAM 32GiB
    
-   Driver: nvidia-driver-580-open
    

cuda, uv までインストール済みの環境とします

## インストール

まずはコードを pull していきます。

Plain textcontent\_copy

```
git clone http://github.com/KimbingNg/ComfyUI-HunyuanImage2.1
```

任意のディレクトリに pull したあとで環境を作っていきます

Plain textcontent\_copy

```
cd ComfyUI-HunyuanImage2.1
```

今回は uv を使って環境を作っていきます

Plain textcontent\_copy

```
uv init pyproject
```

pyproject.toml がすでにあるので、pyproject をつけて uv init を通るようにします

README.md の構築手順に従ってモデルをインストールします

以下を ./models/text\_encoders 下に配置

-   [qwen\_2.5\_vl\_7b.safetensors](https://huggingface.co/Comfy-Org/HunyuanImage_2.1_ComfyUI/blob/main/split_files/text_encoders/qwen_2.5_vl_7b.safetensors)
    
-   [byt5\_small\_glyphxl\_fp16.safetensors](https://huggingface.co/Comfy-Org/HunyuanImage_2.1_ComfyUI/blob/main/split_files/text_encoders/byt5_small_glyphxl_fp16.safetensors)
    

./models/vae 下に配置

-   [hunyuan\_image\_2.1\_vae\_fp16.safetensors](https://huggingface.co/Comfy-Org/HunyuanImage_2.1_ComfyUI/blob/main/split_files/vae/hunyuan_image_2.1_vae_fp16.safetensors)
    
-   **Optional (for refiner):** [hunyuan\_image\_refiner\_vae\_fp16.safetensors](https://huggingface.co/Comfy-Org/HunyuanImage_2.1_ComfyUI/blob/main/split_files/vae/hunyuan_image_refiner_vae_fp16.safetensors)
    

./models/diffusion\_models 下に配置

-   [diffusion models](https://huggingface.co/Comfy-Org/HunyuanImage_2.1_ComfyUI/tree/main/split_files/diffusion_models)

## つまずきポイント

1.  flash-attn パッケージがインストールできない
    
    -   なくても動きます、スキップしましょう
2.  インストールする必須のパッケージがわからない
    
    -   ガイドに従ってインスールしましょう
3.  VRAM
    
    -   32GiB程度必須です…..
4.  意図した画像が生成されない
    
    -   プロンプトはLLMが解釈します
        
    -   プロンプトを文章のようにする、情景をわかりやすくするなどしてみましょう
        

## 実行

[hunyuan\_image\_2.1\_workflow.json](https://github.com/KimbingNg/ComfyUI-HunyuanImage2.1/blob/hunyuan-image/HunyuanImage-2.1.json) はお試し用のプロンプトです

ペンギンが出力されれば動いています

![HunyuanImage 2.1のサンプルワークフローで生成されたペンギン](/_astro/01-image-4a2707ff.C19S1X1l_1kCDou.webp)

↑ 公式サイトの生成例

VRAM の消費は激しいですがローカル環境で高品質な画像が生成できます

## 結びと付録

他にも 3D model を作成できる [Hunyuan3D-2.1](https://github.com/Tencent-Hunyuan/Hunyuan3D-2.1) 、

video を生成する [HunyuanVideo](https://github.com/Tencent-Hunyuan/HunyuanVideo) などもリリースされています

今後も楽しみですね！

## この記事を書いた人

[![](/_astro/noicon.CTHOhNiB_Z24aAgM.webp)](/authors/t-watanabe/)

### [t.watanabe](/authors/t-watanabe/)

t.watanabeのプロフィールと執筆記事をご覧いただけます。

[プロフィールと記事一覧](/authors/t-watanabe/)