AlperKTS commited on
Commit
265534f
Β·
verified Β·
1 Parent(s): cef3308

Add README and model card

Browse files
Files changed (1) hide show
  1. README.md +46 -0
README.md ADDED
@@ -0,0 +1,46 @@
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
1
+ ---
2
+ license: other
3
+ license_name: qwen-research
4
+ license_link: https://huggingface.co/Qwen/Qwen-Image-2.1/blob/main/LICENSE
5
+ tags:
6
+ - comfyui
7
+ - gguf
8
+ - diffusion-single-file
9
+ - text-to-image
10
+ base_model:
11
+ - Qwen/Qwen-Image-2.1
12
+ ---
13
+
14
+ # Qwen-Image-2.1-GGUF
15
+
16
+ Direct GGUF conversion of [Qwen/Qwen-Image-2.1](https://huggingface.co/Qwen/Qwen-Image-2.1) ([Comfy-Org repackaged weights](https://huggingface.co/Comfy-Org/Qwen-Image-2.1)).
17
+
18
+ These model files are optimized for use in [ComfyUI](https://github.com/comfyanonymous/ComfyUI) using the [ComfyUI-GGUF](https://github.com/city96/ComfyUI-GGUF) custom node ().
19
+
20
+ ## Models
21
+
22
+ | File Name | Quantization | Size | Description |
23
+ | :--- | :--- | :--- | :--- |
24
+ | `qwen_image_2.1_Q8_0.gguf` | Q8_0 | ~7.10 GB | 8-bit quantized model preserving 99.9% quality, with F32 1D norms and BF16 sensitive I/O projection layers |
25
+
26
+ ## Setup & File Placement in ComfyUI
27
+
28
+ Place the downloaded files in your ComfyUI directory:
29
+
30
+ ```
31
+ πŸ“‚ ComfyUI/
32
+ └── πŸ“‚ models/
33
+ β”œβ”€β”€ πŸ“‚ diffusion_models/ (or models/unet/)
34
+ β”‚ └── qwen_image_2.1_Q8_0.gguf
35
+ β”œβ”€β”€ πŸ“‚ text_encoders/
36
+ β”‚ └── qwen3vl_8b_bf16.safetensors (or quantized variant)
37
+ └── πŸ“‚ vae/
38
+ └── qwen_image_2.1_vae_bf16.safetensors
39
+ ```
40
+
41
+ ## Usage in ComfyUI
42
+
43
+ 1. Install [ComfyUI-GGUF](https://github.com/city96/ComfyUI-GGUF).
44
+ 2. Use the **`Unet Loader (GGUF)`** node instead of the standard `UNETLoader` or `DiffusionModelLoader`.
45
+ 3. Select `qwen_image_2.1_Q8_0.gguf`.
46
+ 4. Connect the MODEL output to your KSampler / Guider pipeline.