ComfyUI > Nodes > Comfyui-ZiT-Lora-loader

ComfyUI Extension: Comfyui-ZiT-Lora-loader

Repo Name

Comfyui-ZiT-Lora-loader

Author
capitan01R (Account age: 86 days)
Nodes
View all nodes(4)
Latest Updated
2026-03-21
Github Stars
0.03K

How to Install Comfyui-ZiT-Lora-loader

Install this extension via the ComfyUI Manager by searching for Comfyui-ZiT-Lora-loader
  • 1. Click the Manager button in the main menu
  • 2. Select Custom Nodes Manager button
  • 3. Enter Comfyui-ZiT-Lora-loader in the search bar
After installation, click the Restart button to restart ComfyUI. Then, manually refresh your browser to clear the cache and access the updated list of nodes.

Visit ComfyUI Online for ready-to-use ComfyUI environment

  • Free trial available
  • 16GB VRAM to 80GB VRAM GPU machines
  • 400+ preloaded models/nodes
  • Freedom to upload custom models/nodes
  • 200+ ready-to-run workflows
  • 100% private workspace with up to 200GB storage
  • Dedicated Support

Run ComfyUI Online

Comfyui-ZiT-Lora-loader Description

Comfyui-ZiT-Lora-loader is an architecture-aware LoRA loader for Z-Image Turbo (Lumina2) in ComfyUI. It resolves silent key mismatches by auto-fusing separate Q/K/V into Z-Image's fused QKV format and remaps output projections.

Comfyui-ZiT-Lora-loader Introduction

The Comfyui-ZiT-Lora-loader is an extension designed to enhance the functionality of the Z-Image Turbo (Lumina2) within the ComfyUI framework. This extension provides architecture-aware loading of LoRA (Low-Rank Adaptation) models, which are commonly used in AI art generation to fine-tune large models with minimal computational resources. The primary feature of this extension is its ability to automatically calibrate the strength of each layer based on forensic weight analysis, ensuring that the LoRA models are optimally integrated into the Z-Image Turbo architecture. This solves the common problem of mismatched attention weights, which can lead to suboptimal performance in AI-generated art.

How Comfyui-ZiT-Lora-loader Works

At its core, the Comfyui-ZiT-Lora-loader works by converting the standard LoRA format, which includes separate to_q, to_k, and to_v projections, into a format compatible with the Z-Image Turbo's native architecture. This architecture uses a single fused QKV matrix for attention, which is more efficient and effective for processing. The extension performs a block-diagonal fusion of these projections at load time, ensuring that the attention weights are correctly mapped and utilized by the model. Additionally, it remaps naming conventions and provides per-layer control over the LoRA strength, allowing for fine-tuned adjustments that can significantly impact the quality of the generated art.

Comfyui-ZiT-Lora-loader Features

  • Automatic QKV Fusion: Automatically converts separate Q/K/V projections into a fused QKV format, ensuring compatibility with Z-Image Turbo.
  • Per-Layer Strength Calibration: Uses an interactive graph widget to adjust the strength of each transformer layer individually, providing precise control over the model's behavior.
  • Global and Layer-Specific Strength Control: Offers both global strength settings and per-layer adjustments, allowing for nuanced control over the LoRA's influence.
  • Auto Strength Calculation: Analyzes the LoRA's weight tensors to compute optimal per-layer strengths, dynamically adjusting based on the training signal.
  • LoRA Stack Application: Supports applying up to 10 LoRAs in sequence, each with independent strength settings and QKV fusion options.

Comfyui-ZiT-Lora-loader Models

The extension does not introduce new models but enhances the integration of existing LoRA models with the Z-Image Turbo architecture. By ensuring that the LoRA models are correctly loaded and calibrated, it allows artists to leverage the full potential of their models without needing to manually adjust complex settings.

Troubleshooting Comfyui-ZiT-Lora-loader

If you encounter issues while using the Comfyui-ZiT-Lora-loader, consider the following solutions:

  • Problem: LoRA not loading correctly Solution: Ensure that the LoRA files are in the correct directory (models/loras) and that the file names match the expected format.

  • Problem: Unexpected output quality Solution: Use the interactive graph widget to adjust per-layer strengths. Start with the auto-calibration feature to get a baseline and then fine-tune as needed.

  • Problem: Extension not functioning Solution: Verify that the extension is correctly installed in the ComfyUI/custom_nodes directory and that there are no conflicts with other extensions.

Learn More about Comfyui-ZiT-Lora-loader

To further explore the capabilities of the Comfyui-ZiT-Lora-loader, consider the following resources:

  • Community Forums: Engage with other AI artists and developers to share experiences and solutions.
  • Tutorials and Documentation: Look for online tutorials that provide step-by-step guides on using the extension effectively.
  • GitHub Repository: Visit the GitHub repository for the latest updates and to contribute to the project. By utilizing these resources, you can maximize the potential of the Comfyui-ZiT-Lora-loader and enhance your AI art projects with greater precision and creativity.

Comfyui-ZiT-Lora-loader Related Nodes

RunComfy
Copyright 2025 RunComfy. All Rights Reserved.

RunComfy is the premier ComfyUI platform, offering ComfyUI online environment and services, along with ComfyUI workflows featuring stunning visuals. RunComfy also provides AI Models, enabling artists to harness the latest AI tools to create incredible art.