1.0

2026-01-26 04:23:24 -03:00
commit cfa8a8efb3
3 changed files with 232 additions and 0 deletions
@@ -0,0 +1,92 @@
+# KSampler DF (with Refiner)
+
+A custom ComfyUI node that splits sampling steps between a main sampler and a refiner sampler, with independent denoise control for each phase.
+
+## Features
+
+- **Split Steps**: Divide total steps between main sampler and refiner sampler
+- **Dual Sampler Support**: Use different samplers/schedulers for main and refiner phases
+- **Independent Denoise Control**: Separate denoise parameters for main and refiner phases
+- **Refiner Intensity**: Control how much the refiner affects the final result (0.0 to 1.0)
+
+## Installation
+
+### Method 1: Git Clone (Recommended)
+
+1. Open a terminal/command prompt
+2. Navigate to your ComfyUI custom nodes folder:
+   ```bash
+   cd ComfyUI/custom_nodes
+   ```
+3. Clone this repository:
+   ```bash
+   git clone https://github.com/YOUR_USERNAME/ksamplerwithrefiner.git
+   ```
+4. Restart ComfyUI
+
+### Method 2: Manual Installation
+
+1. Download this repository as a ZIP file
+2. Extract the contents to `ComfyUI/custom_nodes/ksamplerwithrefiner/`
+3. Restart ComfyUI
+
+## Usage
+
+Find the node in the **Add Node** menu under: `sampling` → `KSampler DF (with Refiner)`
+
+### Parameters
+
+| Parameter | Description |
+|-----------|-------------|
+| **model** | The model used for denoising |
+| **positive** | Positive conditioning (prompt) |
+| **negative** | Negative conditioning (negative prompt) |
+| **latent_image** | The latent image to denoise |
+| **seed** | Random seed for noise generation |
+| **steps** | Total number of steps (split between main and refiner) |
+| **cfg** | Classifier-Free Guidance scale |
+| **sampler_name** | Sampler algorithm for the main phase |
+| **scheduler** | Scheduler for the main phase |
+| **denoise** | Denoise amount for the main phase (0.0 to 1.0) |
+| **refiner_at_step** | Step at which to switch from main to refiner |
+| **sampler_refiner** | Sampler algorithm for the refiner phase |
+| **scheduler_refiner** | Scheduler for the refiner phase |
+| **denoise_refiner** | Denoise amount for the refiner phase (0.0 to 1.0) |
+
+### Example
+
+With these settings:
+- **steps**: 20
+- **refiner_at_step**: 12
+
+The node will:
+1. Run **12 steps** with the main sampler/scheduler
+2. Run **8 steps** with the refiner sampler/scheduler
+
+### Refiner Denoise Control
+
+The `denoise_refiner` parameter controls how much the refiner phase affects the image:
+
+| Value | Effect |
+|-------|--------|
+| `0.0` | Refiner is skipped (only main sampler runs) |
+| `0.5` | Refiner applies 50% denoising |
+| `1.0` | Refiner applies full denoising |
+
+## File Structure
+
+```
+ksamplerwithrefiner/
+├── __init__.py
+├── nodes.py
+└── README.md
+```
+
+## Requirements
+
+- ComfyUI (latest version recommended)
+- No additional dependencies required
+
+## License
+
+MIT License - Feel free to use and modify as needed.