ComfyUI-SplitImage
A collection of custom nodes for ComfyUI to split an image into overlapping tiles and stitch them back together seamlessly.
Nodes (5)
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):
- Split: Use
Split Image into Tiles. It outputs a List of tiles. - 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.
- 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
- Navigate to your ComfyUI
custom_nodesdirectory. - Clone this repository:
git clone https://github.com/QuigleyDown/ComfyUI-SplitImage.git - Restart ComfyUI.