ComfyUI-SplitImage

A collection of custom nodes for ComfyUI to split an image into overlapping tiles and stitch them back together seamlessly. This is particularly useful for processing high-resolution images in smaller chunks (tiles) to save VRAM or for specialized image-to-image workflows.

Features

• Seamless Stitching: Uses a weight-normalized blending algorithm with linear ramps to eliminate visible seams in overlapping regions.
• VRAM Efficient Processing: Split images into tiles and process them one-by-one to handle massive resolutions.
• Automatic Upscaling Support: The stitching node automatically detects if tiles have been upscaled and adjusts the overlap and final image dimensions accordingly.
• Flexible Grid: Split images or latents into any number of rows and columns.
• Collector Pattern: The stitching node automatically collects tiles from lists or batches for reassembly.

Nodes (Category: SplitImage)

1. Split Image into Tiles

Divides an image into a List of multiple overlapping tiles.

2. Split Latent into Tiles

Divides a latent batch into a List of multiple overlapping tiles.

3. Calculate Tiling Spec

Calculates a tiling configuration without needing an image.

4. Stitch Image Tiles

Reassembles a list or batch of tiles into a single image. Acts as a Collector: It waits for all items in a list to finish processing before stitching.

5. Merge Image Batches

Combines multiple image batches into one larger batch.

Advanced Workflow: The "Collector" Pattern

To process large images without running out of VRAM (OOM):

1. Split: Use Split Image into Tiles. It outputs a List of tiles.
2. Process Sequential: Connect the list to your VAE Encode/KSampler/VAE Decode. ComfyUI will execute these nodes one by one for each tile in the list, keeping VRAM usage low.
3. Stitch (Collect): Connect the final list of processed images to Stitch Image Tiles. It will collect all tiles and stitch them into the final result.

Installation

1. Navigate to your ComfyUI custom_nodes directory.
2. Clone this repository:

   git clone https://github.com/QuigleyDown/ComfyUI-SplitImage.git
   

3. Restart ComfyUI.