🖼️ Isulion Image Collage

The Isulion Image Collage is the pack's odd one out - it has nothing to do with prompts. You feed it a batch of IMAGE tensors and a seed, and it arranges them into a single collage image, preserving each image's aspect ratio. Think contact sheet with a brain, not a rigid grid.

It's a genuinely handy finishing node. The typical ComfyUI session produces a stream of outputs, and when you want to show someone your 12 style variations without posting a wall of individual files, a collage is the answer. This node does the layout automatically, so you don't spend ten minutes in an image editor manually aligning squares. It's especially nice paired with the pack's prompt generators: generate a subject across 10 themes, collect the outputs, and this turns the batch into one shareable comparison image.

How it works

Two inputs, one output. images is the IMAGE batch - feed it the image-list output of any batch-producing sampler or a Load Images node. seed is an optional INT; when set, it shuffles the order of the incoming images before layout, so the same batch can produce different arrangements. The output is collage_image, a single IMAGE tensor you can preview or save.

The mechanism is where it gets interesting. The node is explicitly "inspired by react-isucollage" - an intelligent-layout approach rather than a naive grid. It distributes the input images into rows, sizing each cell to preserve the source image's aspect ratio, and assembles the result into one canvas. Give it a mix of portrait and landscape images and you get a balanced mosaic, not a grid full of letterboxed gaps. Edge cases are handled: a single image just passes through, an empty batch raises a clear error.

The catch

The honest limitation: it's a node collage. The layout algorithm is deterministic and reasonable, but you don't get fine control - no per-image sizing, no custom ordering (beyond the seed shuffle), no gaps or borders knobs. It produces a serviceable comparison sheet, not a designed graphic. If you need a deliberate composition, you'll still end up in an image editor. If you need a quick "here's the batch" overview, this is perfect.

Also remember it outputs a tensor, so save it with a Save Image node afterward - a collage living only in the preview pane is a collage you can't share. And for reproducibility, note that the seed affects ordering and placement, not image content; the content comes from whatever fed the images input.

Install

Same as the rest of the pack: ComfyUI Manager → search "Isulion", or git clone https://github.com/Isulion/ComfyUI_Isulion into custom_nodes/, then restart. No extra dependencies - it runs on torch and the node's own layout math.

It's a small utility with a narrow job, but it's the rare node in this pack that's about showing your work rather than generating prompts. If you ever share comparison grids from ComfyUI, it'll save you the manual assembly every single time.