Skip to content

Commit 07371d0

Browse files
authored
Update Hidream E1.1 docs (#261)
1 parent bc75302 commit 07371d0

File tree

3 files changed

+186
-102
lines changed

3 files changed

+186
-102
lines changed
1.05 MB
Loading

tutorials/image/hidream/hidream-e1.mdx

Lines changed: 91 additions & 50 deletions
Original file line numberDiff line numberDiff line change
@@ -1,74 +1,53 @@
11
---
2-
title: "ComfyUI Native HiDream-e1 Workflow Example"
2+
title: "ComfyUI Native HiDream-e1 e1.1 Workflow Example"
33
sidebarTitle: "HiDream-e1"
44
description: "This guide will help you understand and complete the ComfyUI native HiDream-I1 text-to-image workflow example"
55
---
66

7+
import UpdateReminder from '/snippets/tutorials/update-reminder.mdx'
8+
79
![HiDream-E1 Demo](https://raw.githubusercontent.com/HiDream-ai/HiDream-E1/refs/heads/main/assets/demo.jpg)
810

9-
HiDream-E1 is an interactive image editing large model officially open-sourced by HiDream-ai on April 28, 2025, built based on HiDream-I1.
11+
HiDream-E1 is an interactive image editing large model officially open-sourced by HiDream-ai, built based on HiDream-I1.
1012

1113
It allows you to edit images using natural language. The model is released under the [MIT License](https://github.com/HiDream-ai/HiDream-E1?tab=MIT-1-ov-file), supporting use in personal projects, scientific research, and commercial applications.
1214
In combination with the previously released [hidream-i1](/tutorials/image/hidream/hidream-i1), it enables **creative capabilities from image generation to editing**.
1315

14-
**ComfyUI now natively supports HiDream E1**. In this guide, we will help you complete the workflow example of using HiDream E1 in ComfyUI.
15-
16-
<Note>
17-
For reference, this workflow takes about 500s for the first run and 370s for the second run with 28 sampling steps on Google Colab L4 with 22.5GB VRAM.
18-
</Note>
19-
20-
### HiDream-E1 Information
16+
| Name | Update Date | Inference Steps | Resolution | HuggingFace Repository |
17+
|-------------------|-------------------|-----------------|------------------------|-------------------------------|
18+
| HiDream-E1-Full | 2025-4-28 | 28 | 768x768 | 🤗 [HiDream-E1-Full](https://huggingface.co/HiDream-ai/HiDream-E1-Full) |
19+
| HiDream-E1.1 | 2025-7-16 | 28 | Dynamic (1 Megapixel) | 🤗 [HiDream-E1.1](https://huggingface.co/HiDream-ai/HiDream-E1-1) |
2120

22-
**HiDream-E1 Model Download**
23-
Currently, HiDream provides a full version. Here is the model information:
21+
[HiDream E1 - Github](https://github.com/HiDream-ai/HiDream-E1)
2422

25-
| Name | Inference Steps | Resolution | HuggingFace Repository |
26-
|-----------------|----------------|------------|------------------------------------------------------------------------|
27-
| HiDream-E1-Full | 28 | 768x768 | [🤗 HiDream-E1-Full](https://huggingface.co/HiDream-ai/HiDream-E1-Full) |
23+
<UpdateReminder/>
2824

25+
## HiDream E1 and E1.1 Workflow Related Models
2926

30-
-[Github](https://github.com/HiDream-ai/HiDream-E1)
27+
All the models involved in this guide can be found [here](https://huggingface.co/Comfy-Org/HiDream-I1_ComfyUI/tree/main/split_files). Except for the Diffusion model, E1 and E1.1 use the same models.
28+
The corresponding workflow files also include the relevant model information. You can choose to manually download and save the models, or follow the workflow prompts to download them after loading the workflow. It is recommended to use E1.1.
3129

32-
## ComfyUI Native HiDream-e1 Workflow Example
33-
34-
<Tip>
35-
Please upgrade your ComfyUI to the latest version (latest commit) before starting to ensure your ComfyUI has the relevant support.
36-
</Tip>
37-
38-
### 1. Download HiDream-e1 Workflow and Related Files
39-
40-
#### 1.1 Download Workflow File
41-
42-
Please download the image below and drag it into ComfyUI. The workflow already contains model download information, and after loading, it will prompt you to download the corresponding models.
43-
44-
![ComfyUI Native HiDream-e1 Workflow](https://raw.githubusercontent.com/Comfy-Org/example_workflows/main/hidream_e1/hidream_e1_full.png)
30+
This model requires a large amount of VRAM to run. Please refer to the relevant sections for specific VRAM requirements.
4531

46-
#### 1.2 Download Input Image
32+
**Diffusion Model**
4733

48-
Please download the image below, which we will use as input
34+
You do not need to download both models. Since E1.1 is an iterative version based on E1, our tests show that its quality and performance are significantly improved compared to E1.
35+
- [hidream_e1_1_bf16.safetensors (Recommended)](https://huggingface.co/Comfy-Org/HiDream-I1_ComfyUI/resolve/main/split_files/diffusion_models/hidream_e1_1_bf16.safetensors) 34.2GB
36+
- [hidream_e1_full_bf16.safetensors](https://huggingface.co/Comfy-Org/HiDream-I1_ComfyUI/resolve/main/split_files/diffusion_models/hidream_e1_full_bf16.safetensors) 34.2GB
4937

50-
![ComfyUI Native HiDream-e1 Workflow Input Image](https://raw.githubusercontent.com/Comfy-Org/example_workflows/main/hidream_e1/input.webp)
38+
**Text Encoder**:
5139

52-
### 2. Manual Model Installation for HiDream-e1 Related Models
53-
54-
All models mentioned in this guide can be found [here](https://huggingface.co/Comfy-Org/HiDream-I1_ComfyUI/tree/main/split_files). Please download the corresponding files and save them to the appropriate folders.
55-
56-
The following model files are shared models that we will use. Please click the corresponding links to download and save according to the model file storage location. We will guide you to download the corresponding **diffusion models** in the workflow.
57-
58-
**text_encoders**:
59-
60-
- [clip_l_hidream.safetensors](https://huggingface.co/Comfy-Org/HiDream-I1_ComfyUI/blob/main/split_files/text_encoders/clip_l_hidream.safetensors)
61-
- [clip_g_hidream.safetensors](https://huggingface.co/Comfy-Org/HiDream-I1_ComfyUI/blob/main/split_files/text_encoders/clip_g_hidream.safetensors)
62-
- [t5xxl_fp8_e4m3fn_scaled.safetensors](https://huggingface.co/Comfy-Org/HiDream-I1_ComfyUI/blob/main/split_files/text_encoders/t5xxl_fp8_e4m3fn_scaled.safetensors) This model has been used in many workflows, you may have already downloaded this file.
63-
- [llama_3.1_8b_instruct_fp8_scaled.safetensors](https://huggingface.co/Comfy-Org/HiDream-I1_ComfyUI/blob/main/split_files/text_encoders/llama_3.1_8b_instruct_fp8_scaled.safetensors)
40+
- [clip_l_hidream.safetensors](https://huggingface.co/Comfy-Org/HiDream-I1_ComfyUI/blob/main/split_files/text_encoders/clip_l_hidream.safetensors) 236.12MB
41+
- [clip_g_hidream.safetensors](https://huggingface.co/Comfy-Org/HiDream-I1_ComfyUI/blob/main/split_files/text_encoders/clip_g_hidream.safetensors) 1.29GB
42+
- [t5xxl_fp8_e4m3fn_scaled.safetensors](https://huggingface.co/Comfy-Org/HiDream-I1_ComfyUI/blob/main/split_files/text_encoders/t5xxl_fp8_e4m3fn_scaled.safetensors) 4.8GB
43+
- [llama_3.1_8b_instruct_fp8_scaled.safetensors](https://huggingface.co/Comfy-Org/HiDream-I1_ComfyUI/blob/main/split_files/text_encoders/llama_3.1_8b_instruct_fp8_scaled.safetensors) 8.46GB
6444

6545
**VAE**
66-
- [ae.safetensors](https://huggingface.co/Comfy-Org/HiDream-I1_ComfyUI/blob/main/split_files/vae/ae.safetensors) This is Flux's VAE model. If you have used Flux workflows before, you may have already downloaded this file.
46+
- [ae.safetensors](https://huggingface.co/Comfy-Org/HiDream-I1_ComfyUI/blob/main/split_files/vae/ae.safetensors) 319.77MB
47+
> This is the VAE model for Flux. If you have used the Flux workflow before, you may have already downloaded this file.
6748
68-
**diffusion models**
69-
- [hidream_e1_full_bf16.safetensors](https://huggingface.co/Comfy-Org/HiDream-I1_ComfyUI/resolve/main/split_files/diffusion_models/hidream_e1_full_bf16.safetensors)
49+
Model Save Location
7050

71-
Model file storage location
7251
```
7352
📂 ComfyUI/
7453
├── 📂 models/
@@ -80,9 +59,72 @@ Model file storage location
8059
│ └── 📂 vae/
8160
│ │ └── ae.safetensors
8261
│ └── 📂 diffusion_models/
83-
│ └── hidream_e1_full_bf16.safetensors
62+
│ ├── hidream_e1_1_bf16.safetensors
63+
│ └── hidream_e1_full_bf16.safetensors
8464
```
85-
### 3. Complete the HiDream-e1 Workflow Step by Step
65+
66+
67+
## HiDream E1.1 ComfyUI Native Workflow Example
68+
69+
E1.1 is an updated version released on July 16, 2025. This version supports dynamic 1-megapixel resolution, and the workflow uses the `Scale Image to Total Pixels` node to dynamically adjust the input image to 1 million pixels.
70+
71+
<Tip>
72+
Here are the VRAM usage references during testing:
73+
1. A100 40GB (VRAM usage 95%): First generation: 211s, second generation: 73s
74+
75+
2. 4090D 24GB (VRAM usage 98%)
76+
- Full version: Out of memory
77+
- FP8_e4m3fn_fast (VRAM 98%) First generation: 120s, second generation: 91s
78+
</Tip>
79+
80+
### 1. HiDream E1.1 Workflow and Related Materials
81+
82+
Download the image below and drag it into ComfyUI with the corresponding workflow and models loaded:
83+
![HiDream E1.1 Workflow](https://raw.githubusercontent.com/Comfy-Org/example_workflows/refs/heads/main/image/hidream/e1.1/hidream_e1_1.png)
84+
85+
Download the image below as input:
86+
![HiDream E1.1 Workflow Input](https://raw.githubusercontent.com/Comfy-Org/example_workflows/refs/heads/main/image/hidream/e1.1/input.webp)
87+
88+
### 2. Step-by-step Guide to Running the HiDream-e1 Workflow
89+
![hidream_e1_1_guide](/images/tutorial/image/hidream/hidream-e1-1-guide.jpg)
90+
91+
Follow these steps to run the workflow:
92+
1. Make sure the `Load Diffusion Model` node loads the `hidream_e1_1_bf16.safetensors` model.
93+
2. Make sure the four corresponding text encoders in `QuadrupleCLIPLoader` are loaded correctly:
94+
- clip_l_hidream.safetensors
95+
- clip_g_hidream.safetensors
96+
- t5xxl_fp8_e4m3fn_scaled.safetensors
97+
- llama_3.1_8b_instruct_fp8_scaled.safetensors
98+
3. Make sure the `Load VAE` node uses the `ae.safetensors` file.
99+
4. In the `Load Image` node, load the provided input or your desired image.
100+
5. In the `Empty Text Encoder(Positive)` node, enter **the modifications you want to make to the image**.
101+
6. In the `Empty Text Encoder(Negative)` node, enter **the content you do not want to appear in the image**.
102+
7. Click the `Run` button, or use the shortcut `Ctrl(cmd) + Enter` to execute image generation.
103+
104+
### 3. Additional Notes on the Workflow
105+
106+
- Since HiDream E1.1 supports dynamic input with a total of 1 million pixels, the workflow uses `Scale Image to Total Pixels` to process and convert all input images, which may cause the aspect ratio to differ from the original input image.
107+
- When using the fp16 version of the model, in actual tests, the full version ran out of memory on both A100 40GB and 4090D 24GB, so the workflow is set by default to use `fp8_e4m3fn_fast` for inference.
108+
109+
110+
## HiDream E1 ComfyUI Native Workflow Example
111+
112+
E1 is a model released on April 28, 2025. This model only supports 768*768 resolution.
113+
114+
<Tip>
115+
For reference, this workflow takes about 500s for the first run and 370s for the second run with 28 sampling steps on Google Colab L4 with 22.5GB VRAM.
116+
</Tip>
117+
118+
### 1. HiDream-e1 workflow
119+
120+
Please download the image below and drag it into ComfyUI. The workflow already contains model download information, and after loading, it will prompt you to download the corresponding models.
121+
122+
![ComfyUI Native HiDream-e1 Workflow](https://raw.githubusercontent.com/Comfy-Org/example_workflows/main/hidream_e1/hidream_e1_full.png)
123+
124+
Download this image below as input:
125+
![ComfyUI Native HiDream-e1 Workflow Input](https://raw.githubusercontent.com/Comfy-Org/example_workflows/main/hidream_e1/input.webp)
126+
127+
### 2. Complete the HiDream-e1 Workflow Step by Step
86128

87129
![hidream_e1_full_step_guide](/images/tutorial/advanced/hidream/hidream_e1_full_step_guide.jpg)
88130

@@ -98,7 +140,6 @@ Follow these steps to complete the workflow:
98140
5. (Important) Enter **the prompt for how you want to modify the image** in the `Empty Text Encoder(Positive)` node
99141
6. Click the `Run` button, or use the shortcut `Ctrl(cmd) + Enter` to generate the image
100142

101-
102143
### Additional Notes on ComfyUI HiDream-e1 Workflow
103144

104145
- You may need to modify the prompt multiple times or generate multiple times to get better results

0 commit comments

Comments
 (0)