Qwen-Image-2.1-DiT-GGUF

Qwen-Image-2.1 DiT — GGUF (Q8_0 · Q6_K · Q4_K_M)

Not affiliated with, or endorsed by, Alibaba / Qwen. Quantized redistribution of the Qwen/Qwen-Image-2.1 diffusion transformer under the Qwen Research License (copy included as LICENSE). Non-commercial use only.

[!IMPORTANT] Loads in stock city96/ComfyUI-GGUF — no patch, no extra nodes. These files carry general.architecture = qwen_image, so UnetLoaderGGUF recognises them directly (GGUFs without that field fail with Unknown model architecture!).

Text encoder: our Qwen-Image-2.1 Text Encoder GGUF works with this DiT, but it needs one extra node first — ComfyUI-GGUF-Qwen3VL-TE (stock ComfyUI-GGUF doesn't load Qwen3-VL text encoders yet). With a safetensors text encoder (bf16 / int8 / FP8 from the same repo family) nothing extra is needed.

Made with a simple node

The sample / showcase images in this repo were generated with the technique behind ComfyUI-QwenImage-PhotoStyles — a small ComfyUI node (17 photographic styles; one short prompt becomes a full styled prompt via the PE-T2I rewriter). If you're interested in how the images are made, the node and its recipe are there.

Where are the prompts? The node is applied up front as the PE-T2I step — you type one short line and it expands it into the full prompt. The exact short prompts live in that repo's Gallery: the line printed under each image there is the literal prompt (copy it verbatim), not a description of the picture.

📥 Files

Put one in ComfyUI/models/diffusion_models/ (or models/unet/) and load it with UnetLoaderGGUF. Needs ComfyUI 0.36.0 or newer (for TextEncodeQwenImage21).

🖼️ Showcase

<table> <tr><td width="33%"><a href="https://huggingface.co/pottokao/Qwen-Image-2.1-DiT-GGUF/blob/main/showcase_assets/01.jpg"><img src="https://huggingface.co/pottokao/Qwen-Image-2.1-DiT-GGUF/resolve/main/showcase_assets/01.jpg" width="100%"></a><br>_{Warm Documentary}</td><td width="33%"><a href="https://huggingface.co/pottokao/Qwen-Image-2.1-DiT-GGUF/blob/main/showcase_assets/02.jpg"><img src="https://huggingface.co/pottokao/Qwen-Image-2.1-DiT-GGUF/resolve/main/showcase_assets/02.jpg" width="100%"></a><br>_{Candid B&W Street}</td><td width="33%"><a href="https://huggingface.co/pottokao/Qwen-Image-2.1-DiT-GGUF/blob/main/showcase_assets/04.jpg"><img src="https://huggingface.co/pottokao/Qwen-Image-2.1-DiT-GGUF/resolve/main/showcase_assets/04.jpg" width="100%"></a><br>_{Vivid Everyday Color}</td></tr> <tr><td width="33%"><a href="https://huggingface.co/pottokao/Qwen-Image-2.1-DiT-GGUF/blob/main/showcase_assets/05.jpg"><img src="https://huggingface.co/pottokao/Qwen-Image-2.1-DiT-GGUF/resolve/main/showcase_assets/05.jpg" width="100%"></a><br>_{Black Fury}</td><td width="33%"><a href="https://huggingface.co/pottokao/Qwen-Image-2.1-DiT-GGUF/blob/main/showcase_assets/06.jpg"><img src="https://huggingface.co/pottokao/Qwen-Image-2.1-DiT-GGUF/resolve/main/showcase_assets/06.jpg" width="100%"></a><br>_{Geometry of Light}</td><td width="33%"><a href="https://huggingface.co/pottokao/Qwen-Image-2.1-DiT-GGUF/blob/main/showcase_assets/07.jpg"><img src="https://huggingface.co/pottokao/Qwen-Image-2.1-DiT-GGUF/resolve/main/showcase_assets/07.jpg" width="100%"></a><br>_{Frozen Film Still}</td></tr> <tr><td width="33%"><a href="https://huggingface.co/pottokao/Qwen-Image-2.1-DiT-GGUF/blob/main/showcase_assets/08.jpg"><img src="https://huggingface.co/pottokao/Qwen-Image-2.1-DiT-GGUF/resolve/main/showcase_assets/08.jpg" width="100%"></a><br>_{Deadpan Large-Format}</td><td width="33%"><a href="https://huggingface.co/pottokao/Qwen-Image-2.1-DiT-GGUF/blob/main/showcase_assets/09.jpg"><img src="https://huggingface.co/pottokao/Qwen-Image-2.1-DiT-GGUF/resolve/main/showcase_assets/09.jpg" width="100%"></a><br>_{White Leap}</td><td width="33%"><a href="https://huggingface.co/pottokao/Qwen-Image-2.1-DiT-GGUF/blob/main/showcase_assets/10.jpg"><img src="https://huggingface.co/pottokao/Qwen-Image-2.1-DiT-GGUF/resolve/main/showcase_assets/10.jpg" width="100%"></a><br>_{Corner Elegance}</td></tr> <tr><td width="33%"><a href="https://huggingface.co/pottokao/Qwen-Image-2.1-DiT-GGUF/blob/main/showcase_assets/11.jpg"><img src="https://huggingface.co/pottokao/Qwen-Image-2.1-DiT-GGUF/resolve/main/showcase_assets/11.jpg" width="100%"></a><br>_{Raw B&W Fashion}</td><td width="33%"><a href="https://huggingface.co/pottokao/Qwen-Image-2.1-DiT-GGUF/blob/main/showcase_assets/12.jpg"><img src="https://huggingface.co/pottokao/Qwen-Image-2.1-DiT-GGUF/resolve/main/showcase_assets/12.jpg" width="100%"></a><br>_{Color Behind Glass}</td><td width="33%"><a href="https://huggingface.co/pottokao/Qwen-Image-2.1-DiT-GGUF/blob/main/showcase_assets/13.jpg"><img src="https://huggingface.co/pottokao/Qwen-Image-2.1-DiT-GGUF/resolve/main/showcase_assets/13.jpg" width="100%"></a><br>_{High-Contrast Reportage}</td></tr> <tr><td width="33%"><a href="https://huggingface.co/pottokao/Qwen-Image-2.1-DiT-GGUF/blob/main/showcase_assets/14.jpg"><img src="https://huggingface.co/pottokao/Qwen-Image-2.1-DiT-GGUF/resolve/main/showcase_assets/14.jpg" width="100%"></a><br>_{Lyrical Landscape}</td><td width="33%"><a href="https://huggingface.co/pottokao/Qwen-Image-2.1-DiT-GGUF/blob/main/showcase_assets/15.jpg"><img src="https://huggingface.co/pottokao/Qwen-Image-2.1-DiT-GGUF/resolve/main/showcase_assets/15.jpg" width="100%"></a><br>_{Hyper Chic East}</td><td width="33%"><a href="https://huggingface.co/pottokao/Qwen-Image-2.1-DiT-GGUF/blob/main/showcase_assets/16.jpg"><img src="https://huggingface.co/pottokao/Qwen-Image-2.1-DiT-GGUF/resolve/main/showcase_assets/16.jpg" width="100%"></a><br>_{Street in the Mirror}</td></tr> <tr><td width="33%"><a href="https://huggingface.co/pottokao/Qwen-Image-2.1-DiT-GGUF/blob/main/showcase_assets/18.jpg"><img src="https://huggingface.co/pottokao/Qwen-Image-2.1-DiT-GGUF/resolve/main/showcase_assets/18.jpg" width="100%"></a><br>_{Plain Portrait}</td><td width="33%"><a href="https://huggingface.co/pottokao/Qwen-Image-2.1-DiT-GGUF/blob/main/showcase_assets/19.jpg"><img src="https://huggingface.co/pottokao/Qwen-Image-2.1-DiT-GGUF/resolve/main/showcase_assets/19.jpg" width="100%"></a><br>_{Melancholy B&W}</td><td width="33%"><a href="https://huggingface.co/pottokao/Qwen-Image-2.1-DiT-GGUF/blob/main/showcase_assets/20.jpg"><img src="https://huggingface.co/pottokao/Qwen-Image-2.1-DiT-GGUF/resolve/main/showcase_assets/20.jpg" width="100%"></a><br>_{Fairytale Giants}</td></tr> <tr><td width="33%"><a href="https://huggingface.co/pottokao/Qwen-Image-2.1-DiT-GGUF/blob/main/showcase_assets/21.jpg"><img src="https://huggingface.co/pottokao/Qwen-Image-2.1-DiT-GGUF/resolve/main/showcase_assets/21.jpg" width="100%"></a><br>_{Cold Power}</td><td width="33%"><a href="https://huggingface.co/pottokao/Qwen-Image-2.1-DiT-GGUF/blob/main/showcase_assets/22.jpg"><img src="https://huggingface.co/pottokao/Qwen-Image-2.1-DiT-GGUF/resolve/main/showcase_assets/22.jpg" width="100%"></a><br>_{Cold Power}</td><td width="33%"><a href="https://huggingface.co/pottokao/Qwen-Image-2.1-DiT-GGUF/blob/main/showcase_assets/23.jpg"><img src="https://huggingface.co/pottokao/Qwen-Image-2.1-DiT-GGUF/resolve/main/showcase_assets/23.jpg" width="100%"></a><br>_{Hyper Chic East}</td></tr> <tr><td width="33%"><a href="https://huggingface.co/pottokao/Qwen-Image-2.1-DiT-GGUF/blob/main/showcase_assets/24.jpg"><img src="https://huggingface.co/pottokao/Qwen-Image-2.1-DiT-GGUF/resolve/main/showcase_assets/24.jpg" width="100%"></a><br>_{Fairytale Giants}</td><td width="33%"><a href="https://huggingface.co/pottokao/Qwen-Image-2.1-DiT-GGUF/blob/main/showcase_assets/25.jpg"><img src="https://huggingface.co/pottokao/Qwen-Image-2.1-DiT-GGUF/resolve/main/showcase_assets/25.jpg" width="100%"></a><br>_{Hyper Chic East}</td><td width="33%"><a href="https://huggingface.co/pottokao/Qwen-Image-2.1-DiT-GGUF/blob/main/showcase_assets/26.jpg"><img src="https://huggingface.co/pottokao/Qwen-Image-2.1-DiT-GGUF/resolve/main/showcase_assets/26.jpg" width="100%"></a><br>_{White Leap}</td></tr> </table>

This is what Q4_K_M across the board looks like — every image above was made with:

_{AI-generated. Style homage only — not affiliated with or endorsed by the photographers.}

🍱 All-GGUF Qwen-Image-2.1

The whole pipeline can run on GGUF — useful on Macs and smaller GPUs:

Prefer no patch at all? Use a safetensors text encoder instead (e.g. bf16 or int8-convrot) with the stock CLIPLoader.

⚙️ Recommended sampler settings

25 steps, euler / simple. For images with text (signs, posters, labels), switch cfg partway through with two KSamplerAdvanced nodes — the first 15 steps at cfg 1 lock in composition and materials, the last 10 at cfg 3 with a negative prompt redraw the lettering:

Example negative prompt: oversaturated, overexposed, gibberish text. Without text, a single KSampler at cfg 1.0 is fine.

Quantization

Standard ComfyUI-GGUF image-model rules — no per-layer sensitivity scan:

How it was made (reproducible)

Converted from the official bf16 weights (ComfyUI layout, 265 tensors) with ComfyUI-GGUF's own tooling. Neither its convert.py nor its patched llama.cpp knew Qwen-Image, so both got a small addition — the patches are in tools/:

• tools/convert-qwen_image.patch — adds a qwen_image template to convert.py (7 lines)
• tools/llama.cpp-b3962-qwen_image.patch — ComfyUI-GGUF's lcpp.patch plus a qwen_image architecture and its keep-in-BF16 list

# ComfyUI-GGUF's tools/ with tools/convert-qwen_image.patch applied
python tools/convert.py --src qwen_image_2.1_bf16.safetensors --dst qwen_image_2.1-BF16.gguf
# llama.cpp at tag b3962 with tools/llama.cpp-b3962-qwen_image.patch applied
llama-quantize qwen_image_2.1-BF16.gguf qwen_image_2.1-Q4_K_M.gguf Q4_K_M   # also Q6_K, Q8_0

Verified

On ComfyUI 0.36.0 + ComfyUI-GGUF 6ea2651 (NVIDIA GPU):

• Stock loader — ComfyUI started with only ComfyUI-GGUF enabled (every other custom node disabled): all three files load through UnetLoaderGGUF with no compatibility-mode warning and generate normally. In that test (one prompt, one seed), they give near-identical images; Q6_K and Q8_0 are almost indistinguishable, Q4_K_M differs in small details. Rendered Chinese text (shop sign and a handwritten price menu) came out correct in all three.
• All-GGUF pipeline — Q4_K_M together with the Q4_K_M GGUF text encoder and the GGUF prompt rewriter.

Not tested on a Mac. Not tested: a numeric quality comparison against bf16.