From af613f13d60ffdf1db06ad4fb60332838f32e5f4 Mon Sep 17 00:00:00 2001
From: Your Name <your@email.com>
Date: Sun, 14 Dec 2025 16:57:08 +0900
Subject: [PATCH] Add Issue #29 link and clarify LoKR limitation applies to
 Nunchaku quantization models

---
 README.md | 3 +++
 1 file changed, 3 insertions(+)

diff --git a/README.md b/README.md
index d1dad13..e78ec89 100644
--- a/README.md
+++ b/README.md
@@ -223,6 +223,7 @@ def __init__(self, model, load_device, offload_device, size=0, weight_inplace_up
 ### LoKR (Lycoris) LoRA Support
 - **Status**: ❌ **Not Supported**
 - **Issue**: LoRAs in LoKR format (created by Lycoris) are **not supported**.
+  - **Important Note**: This limitation applies specifically to **Nunchaku quantization models**. LoKR format LoRAs may work with standard (non-quantized) Qwen Image models, but this node is designed for Nunchaku models only.
   - LoKR weights are automatically skipped when detected (experimental conversion code is disabled).
   - Converting to Standard LoRA using SVD approximation (via external tools or scripts) has also been tested and **found to result in noise/artifacts** when applied to Nunchaku quantization models.
 - **Conclusion**: At this time, we have not found a way to successfully apply LoKR weights to Nunchaku models. Please use Standard LoRA formats.
@@ -237,6 +238,8 @@ def __init__(self, model, load_device, offload_device, size=0, weight_inplace_up
   - ❌ **LoKR (Lycoris)**: Not supported (Keys like `lokr_w1`, `lokr_w2`)
   - ❌ **LoHa**: Not supported (Keys like `hada_w1`, `hada_w2`)
   - ❌ **IA3**: Not supported
+- **Related Issues**: 
+  - [Issue #29](https://github.com/ussoewwin/ComfyUI-QwenImageLoraLoader/issues/29) - LyCORIS / LoKr Qwen Image LoRA not recognized by ComfyUI – clarification on "Standard LoRA" format?
 
 ### RES4LYF Sampler Compatibility Issue
 - **Status**: ✅ Fixed in ComfyUI-nunchaku v1.0.2