A custom ComfyUI node that loads images from a ZIP archive and outputs them as modern batched IMAGE and MASK objects. This node reads the archive in-memory, sorts the images alphabetically by filename, and stacks them into standard 4D tensors, maintaining a predictable order for batch processing.

Features

Direct ZIP Loading: Reads .zip files from the ComfyUI input directory without manual extraction.
Alphabetical Sorting: Ensures images are loaded in a predictable order based on filenames (e.g., 000_image.png, 010_image.png).
Batched Outputs: Outputs standard ComfyUI 4D tensors for both RGB images and Grayscale masks.
Dimension Validation: Configurable behavior for handling images of varying sizes within the same archive.

Installation

Via Comfy CLI (Recommended)

If you have the Comfy CLI installed, you can install this node by running:

comfy node install ComfyUI-ZipBatchLoader

Via ComfyUI Manager

Open the Manager in ComfyUI.
Click on Custom Nodes Manager.
Search for ZipBatchLoader or ComfyUI-ZipBatchLoader.
Click Install.

Manual Installation

Navigate to your ComfyUI custom_nodes directory.

Clone this repository:

git clone https://github.com/Charlweed/ComfyUI-ZipBatchLoader.git

Restart ComfyUI.

Usage

The node will appear in the ComfyUI node browser under Load Image Batch From Zip. Place your .zip archives into the ComfyUI input directory.

Inputs

zip_file: Select a .zip file from the ComfyUI input directory.
heterogeneous_dimensions (Default: False):
- If False, all images in the ZIP must have the exact same dimensions. An error is thrown if a mismatch occurs.
- If True, images that do not match the dimensions of the first image in the archive will be skipped, and a warning will be logged.

Outputs

IMAGE: Batched tensor of RGB data [B, H, W, 3].
MASK: Batched tensor of Mask/Grayscale data [B, H, W].
COUNT: The total number of images successfully loaded in the batch.