explaingit

gavr728/comfyui_kleintiledupscaler

13PythonAudience · designerComplexity · 2/5Setup · easy

TLDR

A ComfyUI plugin that upscales images by processing them tile by tile so they fit on GPUs with limited memory, with automatic seam prevention, color matching, and detail-aware quality settings designed for the Flux2.Klein model.

Mindmap

mindmap
  root((Klein Tiled Upscaler))
    What It Does
      Tiled image upscaling
      ComfyUI plugin
      Seam prevention
    Features
      Adaptive quality
      Color matching
      Edge softening
    Tech Stack
      Python
      ComfyUI
      Flux2.Klein
    Use Cases
      Low VRAM upscaling
      Batch image upscale
      Print quality output
    Audience
      AI artists
      Designers
Click or tap to explore — scroll the page freely

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

Things people build with this

USE CASE 1

Upscale a low-resolution AI-generated image to print quality on a GPU with limited VRAM using tiled processing instead of one-pass upscaling.

USE CASE 2

Add the Klein Tiled Upscaler node to an existing ComfyUI workflow to remove visible grid seams at tile boundaries in upscaled outputs.

USE CASE 3

Save render time on large upscales by letting the plugin apply fewer processing steps automatically to flat areas like sky and walls.

Tech stack

PythonComfyUI

Getting it running

Difficulty · easy Time to first run · 5min

Requires ComfyUI already installed, the Flux2.Klein model must be downloaded separately before using this plugin.

In plain English

Klein Tiled Upscaler is a custom plugin for ComfyUI, a popular visual interface for running AI image generation workflows. Its purpose is to take a lower-resolution image and enlarge it to a higher resolution while having the AI fill in realistic new detail rather than simply stretching pixels. It is designed specifically for use with a model called Flux2.Klein. The approach it uses is called inpainting-based tiling. Rather than upscaling the entire image at once, which can crash on GPUs with limited memory, the tool divides the image into a grid of smaller sections called tiles and processes each tile individually in sequence. This keeps memory usage low. The challenge with tiling is that the boundaries between tiles can look like visible grid lines or color shifts in the final image. The plugin includes several features aimed at preventing those seams, including automatically calculating tile sizes so every tile is the same dimensions, matching the color and contrast of each tile to the original image, and softening the edges where tiles meet. The plugin also analyzes the image before processing to identify which areas contain fine texture or edge detail, such as fabric or foliage, and which are flat and uniform, such as sky or plain walls. Tiles with rich detail are processed at higher quality settings while flat areas use fewer steps, which saves render time without sacrificing output quality in the areas where it matters. The position information used internally by the AI model is adjusted for each tile's location in the full image, which the README notes is important for the Flux2.Klein model to work correctly. The README includes a candid disclaimer: the author wrote no code themselves. The entire plugin was built by giving instructions to AI assistants, and the author acknowledges they would not be able to fix bugs on their own. Users encountering problems are advised to paste the source file and error messages into an AI assistant for help. Installation involves cloning the repository into ComfyUI's custom nodes folder and restarting the application. The plugin then appears as a draggable node in the ComfyUI workflow editor. The README describes settings for tile size calculation mode, tile processing order strategy, color matching, adaptive step reduction for flat areas, and a tiled decode option for very large output resolutions.

Copy-paste prompts

Prompt 1
I installed comfyui_kleintiledupscaler and added the node to my ComfyUI workflow. What tile size and color matching settings should I use to avoid visible seams on a portrait photo?
Prompt 2
My upscaled image shows visible grid lines at tile boundaries using comfyui_kleintiledupscaler. Which settings control seam blending and edge softening between tiles?
Prompt 3
I want to upscale a 512x512 image to 4K using comfyui_kleintiledupscaler. Walk me through the recommended node settings for a detailed landscape image with lots of foliage.
Prompt 4
Explain how the adaptive step reduction in comfyui_kleintiledupscaler detects flat areas like sky and applies fewer steps there automatically.
Open on GitHub → Explain another repo

← gavr728 on gitmyhub — every repo by this author, as a profile.

Verify against the repo before relying on details.