62 lines
2.3 KiB
Markdown
62 lines
2.3 KiB
Markdown
# Installation and Features
|
|
|
|
## 🎉 MAJOR UPDATE: v1.60 - Simplified Installation (No Integration Required!)
|
|
|
|
**As of v1.60, manual integration with ComfyUI-nunchaku's `__init__.py` is completely unnecessary.**
|
|
|
|
The node now operates as a fully independent custom node that works out-of-the-box. Simply clone the repository into your `custom_nodes` folder and restart ComfyUI. The nodes will automatically appear in ComfyUI's node menu through ComfyUI's built-in automatic node loading mechanism.
|
|
|
|
### What Changed in v1.60
|
|
- ✅ **Removed dependency on ComfyUI-nunchaku integration** - The LoRA loader is now a standalone plugin
|
|
- ✅ **Simplified installation** - No batch scripts or manual file editing required
|
|
- ✅ **Cleaner architecture** - Node registration happens automatically
|
|
- ✅ **Backward compatible** - All existing LoRA files and workflows continue to work
|
|
|
|
For a detailed technical explanation of why integration is no longer needed, see [v1.60 Release Notes](https://github.com/ussoewwin/ComfyUI-QwenImageLoraLoader/releases/tag/v1.60)
|
|
|
|
## Features
|
|
|
|
- **NunchakuQwenImageLoraLoader**: Load and apply single LoRA to Qwen Image models
|
|
- **NunchakuQwenImageLoraStack**: Apply multiple LoRAs with dynamic UI control
|
|
- **NunchakuQwenImageDiffsynthControlnet**: Apply diffsynth ControlNet to Nunchaku Qwen Image models (v2.0)
|
|
- **Dynamic VRAM Management**: Automatic CPU offloading based on available VRAM
|
|
- **LoRA Composition**: Efficient LoRA stacking and composition
|
|
- **ComfyUI Integration**: Seamless integration with ComfyUI workflows
|
|
|
|
## Installation
|
|
|
|
### Quick Installation (v1.60 - Simplified!)
|
|
|
|
**Prerequisites:**
|
|
- ComfyUI-nunchaku must be installed
|
|
|
|
1. Clone this repository to your ComfyUI custom_nodes directory:
|
|
|
|
```bash
|
|
cd ComfyUI/custom_nodes
|
|
git clone https://github.com/ussoewwin/ComfyUI-QwenImageLoraLoader.git
|
|
```
|
|
|
|
2. Restart ComfyUI
|
|
|
|
**That's it!** The nodes will automatically appear in ComfyUI's node menu.
|
|
|
|
### Manual Installation (Alternative)
|
|
|
|
If you prefer to install manually or are using macOS/Linux:
|
|
|
|
```bash
|
|
cd /path/to/ComfyUI/custom_nodes
|
|
git clone https://github.com/ussoewwin/ComfyUI-QwenImageLoraLoader.git
|
|
```
|
|
|
|
Then restart ComfyUI.
|
|
|
|
## Requirements
|
|
|
|
- Python 3.11+
|
|
- ComfyUI (latest version recommended)
|
|
- ComfyUI-nunchaku (required)
|
|
- CUDA-capable GPU (optional, but recommended for performance)
|
|
|