ComfyUI-Quick-Latent

ComfyUI Quick Latent

English | 繁體中文

A streamlined ComfyUI custom node for creating latent tensors from direct output-size presets.

Quick Latent lets you choose an orientation, ratio family, curated output size, or custom width and height, then outputs the matching width, height, latent tensor, and batch size.

V3.0 Breaking Change

V3.0 replaces the preset sizes and the saved option values. V2 workflows are not migrated: delete old Quick Latent nodes and add a new one after upgrading.

Features

| Feature | Description | | --- | --- | | Direct presets | Three sizes per ratio with a long edge of 1536, 1920, or 2560, such as 1280 x 1920 or 1440 x 2560. 1:1 uses 1024, 1536, or 2048. | | Ratio families | Supports 1:1, 2:3, 3:4, and 9:16, plus a custom size. | | Orientation | Switches labels and swaps preset/custom width and height between portrait and landscape. | | Custom size | Enter direct output width and height. Input values are preserved, clamped to 512 through 4096, then rounded down to multiples of 16 for the actual output. | | Batch size | Create latent batches from 1 to 64. | | Custom UI | Uses a compact canvas UI in the classic node view, and an HTML panel in Nodes 2.0. |

Installation

Via ComfyUI Manager

Search for comfyui-quick-latent in ComfyUI Manager and click Install.

Restart ComfyUI after installation.

Manual Installation

Clone this repository into your ComfyUI custom nodes directory:

cd ComfyUI/custom_nodes
git clone https://github.com/Zhen-Bo/comfyui-quick-latent.git

Restart ComfyUI after installation.

Usage

Add the Quick Latent node from the QuickLatent category.

Use the node controls to select:

• Orientation: Portrait, Landscape, or Custom
• Aspect ratio: 1:1, 2:3, 3:4, or 9:16
• Preset resolution or custom width and height
• Batch size

The node returns a zero-filled latent tensor and matching dimension values for downstream ComfyUI workflows. Output width and height are the direct 16-aligned latent image dimensions used by the sampler.

For the full preset table, see Dimension Reference.

Outputs

| Output | Type | Description | | --- | --- | --- | | OUTPUT_WIDTH | INT | Actual 16-aligned latent image width. | | OUTPUT_HEIGHT | INT | Actual 16-aligned latent image height. | | LATENT | LATENT | Zero-filled latent tensor. | | BATCH_SIZE | INT | Selected batch size. |

License

MIT License. See LICENSE.