Nodes/ComfyUI-aihub-workflow-exposer/AIHub Expose Project Image Batch
ComfyUI Node

AIHub Expose Project Image Batch

Read back the image batch the project stored, with slice-and-dice indexing

By otavanopisto·Created about a year ago·Updated 22 days ago· 7
AIHub Expose Project Image Batch
  • normalizer
  • IMAGE
  • MASK
  • WIDTH
  • HEIGHT
idexposed_image_batch
file_nameexposed_image_batch.png
indexes

AIHub Expose Project Image Batch is the storage-side version of AIHubExposeImageBatch: it reads a series of images that were previously stored in the project and packs them into a batched IMAGE tensor (plus MASKS, WIDTH, HEIGHT). The README's guidance is blunt and worth quoting: "Use this whenever while using an action to create an image you used append" - in other words, this node is the read end of the append-based batch actions. If a workflow wrote frames with AIHubActionNewImageBatch (or called AIHubActionNewImage in APPEND mode repeatedly), this is how a later workflow gets that whole batch back.

Mechanically it works like every project node: the client resolves the stored files, the server injects their paths, and this node loads each one through ComfyUI's image loader before stacking them. Two details make it more useful than a plain batch read.

First, indexing. The indexes input is a comma-separated list with range support: 0,1,2 loads the first three images, 0-4 loads the first five, and negative indexes work, so -1 grabs just the last frame. That's your tool for "only re-process frames 5 to 8" without loading everything.

Second, normalization. Batches of mixed sizes will break a video model. The node's optional normalizer input takes an AIHUB_NORMALIZER from AIHub Utils New Normalizer; leave it empty and it defaults to targeting the image with the most megapixels using a nearest-exact upscaler. That's a reasonable floor, but for video work you'll usually want to set an explicit width/height.

The inputs that matter

  • file_name - the batch filename without the number counter (e.g. exposed_image_batch.png); the client appends the per-file numbers.
  • indexes - which images to load (see above).
  • normalizer - optional; ties to the New Normalizer utility.

Plus id. Outputs are IMAGE, MASK, WIDTH, HEIGHT.

Install & gotchas

Standard pack install: ComfyUI Manager → search ComfyUI-aihub-workflow-exposer, or git clone https://github.com/otavanopisto/ComfyUI-aihub-workflow-exposer into custom_nodes, then restart. No requirements.txt, no model downloads.

The gotcha that bites most people: file_name is the stem - the number counter is added by the client, and you must give the base name without it or the files won't match up. Second: if the batch was stored with REPLACE (or the writing workflow never ran in append mode), there may be exactly one file and indexes pointing past it will find nothing. If the node complains "no valid images found," first check that the writer actually stored the files as a numbered batch in the project, not that the node is broken.

Categoryaihub/expose/config

Inputs (4)

NameTypeDefaultDescription
idSTRINGexposed_image_batchA unique custom ID for this workflow.
file_nameSTRINGexposed_image_batch.pngThe filename of the image batch as stored in the project files, including extension, without the number counter
indexesSTRINGA comma separated list of indexes to load from the image batch For example: '0,1,2' to load the first three images, or a range like '0-4' to load the first five images; negative indexes are supported as well
normalizeroptAIHUB_NORMALIZERThe method to use for normalizing the images in the batch, if not specified it will use the image with the most megapixels as the target size with a nearest-exact upscaler

Outputs (4)

NameTypeDescription
IMAGEIMAGE
MASKMASK
WIDTHINT
HEIGHTINT