SuperScaler Pipeline for ComfyUI
An all-in-one, multi-pass generative upscaling and post-processing node designed to simplify complex workflows and add a professional finish to your images.
This node replaces a complex chain of 10+ nodes, combining a latent refine pass, two generative tiled upscale passes, and a final Post-FX (Sharpen & Grain) stage into a single, convenient, and collapsible unit.
🌟 New Feature: Masked Final Blending
This node now includes an optional mask_in input and a mask_blend_weight slider under “Final Settings”.
This powerful feature allows you to protect specific areas of your image (like skies or smooth surfaces) from the entire generative and post-processing pipeline, preventing unwanted noise or artifacts in those regions.
The mask_blend_weight slider controls the “cleanliness” of the protected areas.
At 1.0 (default), the protected area is 100% replaced by the clean upscale.
At 0.5, the protected area is a 50/50 mix of the clean and processed versions.
At 0.0, the mask has no effect.
🌟 Features
All-in-One Pipeline: A single node to take your image from 1K to 4K+ with generative details, sharpening, and realistic film grain.
Dynamic & Collapsible UI: Tidy up your workflow\! Each major pass can be toggled on or off, hiding its settings to save space.
Multi-Pass Upscaling:
Pass 1: Latent Refine: A subtle img2img-style pass to refine the base image before the main upscale.
Pass 2 & 3: Tiled Generative Upscale: Two independent generative (img2img) passes that use tiling to perform large upscales (e.g., 2x + 2x) on low-VRAM GPUs.
Professional Post-FX Stage:
Frequency-Split Sharpening: A high-quality sharpening method (scipy.ndimage.gaussian_filter) that sharpens details without introducing harsh halos.
Realistic Film Grain: Adds poisson, gaussian, or perlin grain to break up digital smoothness, add texture, and make images feel more realistic and less “plastic.”
Global Seed Control: A single, globally accessible seed controls all three generative passes, ensuring consistent and reproducible results.
⚙️ Node Parameters (The Pipeline)
The node is organized into sections that follow the image processing pipeline.
1\. Latent Pass (Pass 1)
Purpose: A gentle, non-tiled img2img pass.
Use Case: Ideal for slightly modifying or refining the base image *before* the main upscale. Uses a low denoise (e.g., 0.4) and a small upscale_by (e.g., 1.1x).
2\. Tiled Pass 2 (Pass 2)
Purpose: The primary generative upscale pass.
Use Case: This is your main 2x or 3x upscale. It uses tiling, so you can use large tile_size (like 768) with low VRAM. A moderate denoise (e.g., 0.35) will add generative details.
3\. Tiled Pass 3 (Pass 3)
Purpose: A second, optional generative upscale pass.
Use Case: Use this for a 4x \> 8x upscale. It takes the output of Pass 2 and tiles it again. Typically, this pass uses a much lower denoise (e.g., 0.15) to refine details without changing the image.
4\. Post-FX (Pass 4)
This stage is applied in pixel-space at the very end.
Enable Sharpen:
Amount: Strength of the sharpening effect.
Radius: How wide the detail-detection radius is.
Enable Grain:
Grain Intensity: The overall strength/visibility of the grain.
Grain Type: poisson (default, very organic), gaussian, or perlin.
Grain Size: The scale of the grain particles.
Saturation Mix: How colorful the grain is (1.0 = full color, 0.0 = monochrome).
Adaptive Grain: Ties the grain strength to the image’s brightness (more grain in shadows).
5\. Global Seed
Purpose: Controls all three generative passes (Pass 1, 2, and 3) simultaneously for consistent results.
Features: Includes the standard ComfyUI fixed, increment, randomize controls.
