Text-to-Image
Diffusers
English
image-editing
SVDQuant
Qwen-Image-Edit-2509
Diffusion
Quantization
ICLR2025
Instructions to use yqb741115/nunchaku-qwen-image-edit-2509 with libraries, inference providers, notebooks, and local apps. Follow these links to get started.
- Libraries
- Diffusers
How to use yqb741115/nunchaku-qwen-image-edit-2509 with Diffusers:
pip install -U diffusers transformers accelerate
import torch from diffusers import DiffusionPipeline # switch to "mps" for apple devices pipe = DiffusionPipeline.from_pretrained("yqb741115/nunchaku-qwen-image-edit-2509", dtype=torch.bfloat16, device_map="cuda") prompt = "Astronaut in a jungle, cold color palette, muted colors, detailed, 8k" image = pipe(prompt).images[0] - Notebooks
- Google Colab
- Kaggle
- Local Apps Settings
- Draw Things
- DiffusionBee
File size: 11,389 Bytes
e3bd4e0 | 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 103 104 105 106 107 108 109 110 111 112 113 114 115 116 117 118 119 120 121 122 123 124 125 126 127 128 129 130 131 132 133 134 135 136 137 138 139 140 | ---
base_model: Qwen/Qwen-Image-Edit-2509
base_model_relation: quantized
datasets:
- mit-han-lab/svdquant-datasets
language:
- en
library_name: diffusers
license: apache-2.0
pipeline_tag: text-to-image
tags:
- image-editing
- SVDQuant
- Qwen-Image-Edit-2509
- Diffusion
- Quantization
- ICLR2025
---
<p align="center" style="border-radius: 10px">
<img src="https://huggingface.co/datasets/nunchaku-tech/cdn/resolve/main/nunchaku/assets/nunchaku_v2.png" width="30%" alt="Nunchaku Logo"/>
</p>
<div align="center">
<a href=https://discord.gg/Wk6PnwX9Sm target="_blank"><img src=https://img.shields.io/badge/dynamic/json?url=https%3A%2F%2Fdiscord.com%2Fapi%2Finvites%2FWk6PnwX9Sm%3Fwith_counts%3Dtrue&query=%24.approximate_member_count&logo=discord&logoColor=white&label=Discord&color=green&suffix=%20total height=22px></a>
<a href=https://huggingface.co/datasets/nunchaku-tech/cdn/resolve/main/nunchaku/assets/wechat.jpg target="_blank"><img src=https://img.shields.io/badge/WeChat-07C160?logo=wechat&logoColor=white height=22px></a>
</div>
# Model Card for nunchaku-qwen-image-edit-2509

This repository contains Nunchaku-quantized versions of [Qwen-Image-Edit-2509](https://huggingface.co/Qwen/Qwen-Image-Edit-2509), an image-editing model based on [Qwen-Image](https://huggingface.co/Qwen/Qwen-Image), advances in complex text rendering. It is optimized for efficient inference while maintaining minimal loss in performance.
## News
- [2025-11-15] ๐ Release new quantized qwen-image-edit-2509 4/8-step lightning models, fused with [lightx2v Qwen-Image-Edit-2509 lightning lora](https://huggingface.co/lightx2v/Qwen-Image-Lightning/tree/main/Qwen-Image-Edit-2509). All models are available in the [`lightning-251115`](./lightning-251115) folder.
- [2025-09-25] ๐ฅ Release **4-bit [4/8-step lightning Qwen-Image-Edit](https://huggingface.co/lightx2v/Qwen-Image-Lightning)**!
- [2025-09-24] ๐ Release 4-bit SVDQuant quantized Qwen-Image-Edit-2509 model with rank 32 and 128!
## Model Details
### Model Description
- **Developed by:** Nunchaku Team
- **Model type:** image-to-image
- **License:** apache-2.0
- **Quantized from model:** [Qwen-Image-Edit-2509](https://huggingface.co/Qwen/Qwen-Image-Edit-2509)
### Model Files
**Data Type**: `INT4` for non-Blackwell GPUs (pre-50-series), `NVFP4` for Blackwell GPUs (50-series).
**Rank**: `r32` for faster inference, `r128` for better quality but slower inference.
### Base Models
Standard inference speed models for general use
| Data Type | Rank | Model Name | Comment |
|-----------|------|----------|---------|
| INT4 | r32 | [`svdq-int4_r32-qwen-image-edit-2509.safetensors`](./svdq-int4_r32-qwen-image-edit-2509.safetensors) | |
| | r128 | [`svdq-int4_r128-qwen-image-edit-2509.safetensors`](./svdq-int4_r128-qwen-image-edit-2509.safetensors) | |
| NVFP4 | r32 | [`svdq-fp4_r32-qwen-image-edit-2509.safetensors`](./svdq-fp4_r32-qwen-image-edit-2509.safetensors) | |
| | r128 | [`svdq-fp4_r128-qwen-image-edit-2509.safetensors`](./svdq-fp4_r128-qwen-image-edit-2509.safetensors) | |
### 4-Step Distilled Models
4-step distilled models fused with [Qwen-Image-Lightning-4steps-V2.0 LoRA](https://huggingface.co/lightx2v/Qwen-Image-Lightning/blob/main/Qwen-Image-Lightning-4steps-V2.0-bf16.safetensors) or [Qwen-Image-Edit-2509-Lightning-4steps-V1.0 LoRA](https://huggingface.co/lightx2v/Qwen-Image-Lightning/blob/main/Qwen-Image-Edit-2509/Qwen-Image-Edit-2509-Lightning-4steps-V1.0-bf16.safetensors) using LoRA strength = 1.0
| Data Type | Rank | Model Name | Comment |
|-----------|------|----------|---------|
| INT4 | r32 | [`svdq-int4_r32-qwen-image-edit-2509-lightning-4steps-251115.safetensors`](./lightning-251115/svdq-int4_r32-qwen-image-edit-2509-lightning-4steps-251115.safetensors) | ๐ฅ New: Fused with [Qwen-Image-Edit-2509-Lightning-4steps-V1.0 LoRA](https://huggingface.co/lightx2v/Qwen-Image-Lightning/blob/main/Qwen-Image-Edit-2509/Qwen-Image-Edit-2509-Lightning-4steps-V1.0-bf16.safetensors) |
| | r128 | [`svdq-int4_r128-qwen-image-edit-2509-lightning-4steps-251115.safetensors`](./lightning-251115/svdq-int4_r128-qwen-image-edit-2509-lightning-4steps-251115.safetensors) | ๐ฅ New: Fused with [Qwen-Image-Edit-2509-Lightning-4steps-V1.0 LoRA](https://huggingface.co/lightx2v/Qwen-Image-Lightning/blob/main/Qwen-Image-Edit-2509/Qwen-Image-Edit-2509-Lightning-4steps-V1.0-bf16.safetensors) |
| NVFP4 | r32 | [`svdq-fp4_r32-qwen-image-edit-2509-lightning-4steps-251115.safetensors`](./lightning-251115/svdq-fp4_r32-qwen-image-edit-2509-lightning-4steps-251115.safetensors) | ๐ฅ New: Fused with [Qwen-Image-Edit-2509-Lightning-4steps-V1.0 LoRA](https://huggingface.co/lightx2v/Qwen-Image-Lightning/blob/main/Qwen-Image-Edit-2509/Qwen-Image-Edit-2509-Lightning-4steps-V1.0-bf16.safetensors) |
| | r128 | [`svdq-fp4_r128-qwen-image-edit-2509-lightning-4steps-251115.safetensors`](./lightning-251115/svdq-fp4_r128-qwen-image-edit-2509-lightning-4steps-251115.safetensors) | ๐ฅ New: Fused with [Qwen-Image-Edit-2509-Lightning-4steps-V1.0 LoRA](https://huggingface.co/lightx2v/Qwen-Image-Lightning/blob/main/Qwen-Image-Edit-2509/Qwen-Image-Edit-2509-Lightning-4steps-V1.0-bf16.safetensors) |
| INT4 | r32 | [`svdq-int4_r32-qwen-image-edit-2509-lightningv2.0-4steps.safetensors`](./svdq-int4_r32-qwen-image-edit-2509-lightningv2.0-4steps.safetensors) | Fused with [Qwen-Image-Lightning-4steps-V2.0 LoRA](https://huggingface.co/lightx2v/Qwen-Image-Lightning/blob/main/Qwen-Image-Lightning-4steps-V2.0-bf16.safetensors) |
| | r128 | [`svdq-int4_r128-qwen-image-edit-2509-lightning`](./svdq-int4_r128-qwen-image-edit-2509-lightning) | Fused with [Qwen-Image-Lightning-4steps-V2.0 LoRA](https://huggingface.co/lightx2v/Qwen-Image-Lightning/blob/main/Qwen-Image-Lightning-4steps-V2.0-bf16.safetensors) |
| NVFP4 | r32 | [`svdq-fp4_r32-qwen-image-edit-2509-lightningv2.0-4steps.safetensors`](./svdq-fp4_r32-qwen-image-edit-2509-lightningv2.0-4steps.safetensors) | Fused with [Qwen-Image-Lightning-4steps-V2.0 LoRA](https://huggingface.co/lightx2v/Qwen-Image-Lightning/blob/main/Qwen-Image-Lightning-4steps-V2.0-bf16.safetensors) |
| | r128 | [`svdq-fp4_r128-qwen-image-edit-2509-lightningv2.0-4steps.safetensors`](./svdq-fp4_r128-qwen-image-edit-2509-lightningv2.0-4steps.safetensors) | Fused with [Qwen-Image-Lightning-4steps-V2.0 LoRA](https://huggingface.co/lightx2v/Qwen-Image-Lightning/blob/main/Qwen-Image-Lightning-4steps-V2.0-bf16.safetensors) |
### 8-Step Distilled Models
8-step distilled models fused with [Qwen-Image-Lightning-8steps-V2.0 LoRA](https://huggingface.co/lightx2v/Qwen-Image-Lightning/blob/main/Qwen-Image-Lightning-8steps-V2.0-bf16.safetensors) or [Qwen-Image-Edit-2509-Lightning-8steps-V1.0 LoRA](https://huggingface.co/lightx2v/Qwen-Image-Lightning/blob/main/Qwen-Image-Edit-2509/Qwen-Image-Edit-2509-Lightning-8steps-V1.0-bf16.safetensors) using LoRA strength = 1.0
| Data Type | Rank | Model Name | Comment |
|-----------|------|----------|---------|
| INT4 | r32 | [`svdq-int4_r32-qwen-image-edit-2509-lightning-8steps-251115.safetensors`](./lightning-251115/svdq-int4_r32-qwen-image-edit-2509-lightning-8steps-251115.safetensors) | ๐ฅ New: Fused with [Qwen-Image-Edit-2509-Lightning-8steps-V1.0 LoRA](https://huggingface.co/lightx2v/Qwen-Image-Lightning/blob/main/Qwen-Image-Edit-2509/Qwen-Image-Edit-2509-Lightning-8steps-V1.0-bf16.safetensors) |
| | r128 | [`svdq-int4_r128-qwen-image-edit-2509-lightning-8steps-251115.safetensors`](./lightning-251115/svdq-int4_r128-qwen-image-edit-2509-lightning-8steps-251115.safetensors) | ๐ฅ New: Fused with [Qwen-Image-Edit-2509-Lightning-8steps-V1.0 LoRA](https://huggingface.co/lightx2v/Qwen-Image-Lightning/blob/main/Qwen-Image-Edit-2509/Qwen-Image-Edit-2509-Lightning-8steps-V1.0-bf16.safetensors) |
| NVFP4 | r32 | [`svdq-fp4_r32-qwen-image-edit-2509-lightning-8steps-251115.safetensors`](./lightning-251115/svdq-fp4_r32-qwen-image-edit-2509-lightning-8steps-251115.safetensors) | ๐ฅ New: Fused with [Qwen-Image-Edit-2509-Lightning-8steps-V1.0 LoRA](https://huggingface.co/lightx2v/Qwen-Image-Lightning/blob/main/Qwen-Image-Edit-2509/Qwen-Image-Edit-2509-Lightning-8steps-V1.0-bf16.safetensors) |
| | r128 | [`svdq-fp4_r128-qwen-image-edit-2509-lightning-8steps-251115.safetensors`](./lightning-251115/svdq-fp4_r128-qwen-image-edit-2509-lightning-8steps-251115.safetensors) | ๐ฅ New: Fused with [Qwen-Image-Edit-2509-Lightning-8steps-V1.0 LoRA](https://huggingface.co/lightx2v/Qwen-Image-Lightning/blob/main/Qwen-Image-Edit-2509/Qwen-Image-Edit-2509-Lightning-8steps-V1.0-bf16.safetensors) |
| INT4 | r32 | [`svdq-int4_r32-qwen-image-edit-2509-lightningv2.0-8steps.safetensors`](./svdq-int4_r32-qwen-image-edit-2509-lightningv2.0-8steps.safetensors) | Fused with [Qwen-Image-Lightning-8steps-V2.0 LoRA](https://huggingface.co/lightx2v/Qwen-Image-Lightning/blob/main/Qwen-Image-Lightning-8steps-V2.0-bf16.safetensors) |
| | r128 | [`svdq-int4_r128-qwen-image-edit-2509-lightningv2.0-8steps.safetensors`](./svdq-int4_r128-qwen-image-edit-2509-lightningv2.0-8steps.safetensors) | Fused with [Qwen-Image-Lightning-8steps-V2.0 LoRA](https://huggingface.co/lightx2v/Qwen-Image-Lightning/blob/main/Qwen-Image-Lightning-8steps-V2.0-bf16.safetensors) |
| NVFP4 | r32 | [`svdq-fp4_r32-qwen-image-edit-2509-lightningv2.0-8steps.safetensors`](./svdq-fp4_r32-qwen-image-edit-2509-lightningv2.0-8steps.safetensors) | Fused with [Qwen-Image-Lightning-8steps-V2.0 LoRA](https://huggingface.co/lightx2v/Qwen-Image-Lightning/blob/main/Qwen-Image-Lightning-8steps-V2.0-bf16.safetensors) |
| | r128 | [`svdq-fp4_r128-qwen-image-edit-2509-lightningv2.0-8steps.safetensors`](./svdq-fp4_r128-qwen-image-edit-2509-lightningv2.0-8steps.safetensors) | Fused with [Qwen-Image-Lightning-8steps-V2.0 LoRA](https://huggingface.co/lightx2v/Qwen-Image-Lightning/blob/main/Qwen-Image-Lightning-8steps-V2.0-bf16.safetensors) |
### Model Sources
- **Inference Engine:** [nunchaku](https://github.com/nunchaku-tech/nunchaku)
- **Quantization Library:** [deepcompressor](https://github.com/nunchaku-tech/deepcompressor)
- **Paper:** [SVDQuant: Absorbing Outliers by Low-Rank Components for 4-Bit Diffusion Models](http://arxiv.org/abs/2411.05007)
- **Demo:** [demo.nunchaku.tech](https://demo.nunchaku.tech)
## Usage
- Diffusers Usage: See [qwen-image-edit-2509.py](https://github.com/nunchaku-tech/nunchaku/blob/main/examples/v1/qwen-image-edit-2509.py). Check this [tutorial](https://nunchaku.tech/docs/nunchaku/usage/qwen-image-edit.html) for more advanced usage.
- ComfyUI Usage: See [nunchaku-qwen-image-edit-2509.json](https://nunchaku.tech/docs/ComfyUI-nunchaku/workflows/qwenimage.html#nunchaku-qwen-image-edit-2509-json).
## Performance

## Citation
```bibtex
@inproceedings{
li2024svdquant,
title={SVDQuant: Absorbing Outliers by Low-Rank Components for 4-Bit Diffusion Models},
author={Li*, Muyang and Lin*, Yujun and Zhang*, Zhekai and Cai, Tianle and Li, Xiuyu and Guo, Junxian and Xie, Enze and Meng, Chenlin and Zhu, Jun-Yan and Han, Song},
booktitle={The Thirteenth International Conference on Learning Representations},
year={2025}
}
``` |