ComfyUI > Nodes > ComfyUI > Resolution Bucket

ComfyUI Node: Resolution Bucket

Class Name

ResolutionBucket

Category
dataset
Author
ComfyAnonymous (Account age: 763days)
Extension
ComfyUI
Latest Updated
2026-05-13
Github Stars
112.77K

How to Install ComfyUI

Install this extension via the ComfyUI Manager by searching for ComfyUI
  • 1. Click the Manager button in the main menu
  • 2. Select Custom Nodes Manager button
  • 3. Enter ComfyUI in the search bar
After installation, click the Restart button to restart ComfyUI. Then, manually refresh your browser to clear the cache and access the updated list of nodes.

Visit ComfyUI Online for ready-to-use ComfyUI environment

  • Free trial available
  • 16GB VRAM to 80GB VRAM GPU machines
  • 400+ preloaded models/nodes
  • Freedom to upload custom models/nodes
  • 200+ ready-to-run workflows
  • 100% private workspace with up to 200GB storage
  • Dedicated Support

Run ComfyUI Online

Resolution Bucket Description

Efficiently organizes data for batch training by grouping latent representations based on resolution, streamlining processing and training.

Resolution Bucket:

The ResolutionBucket node is designed to efficiently organize and manage data for batch training by grouping latent representations and their corresponding conditions based on resolution. This node is particularly beneficial in scenarios where you have a diverse set of image data with varying resolutions and need to streamline the training process. By categorizing data into resolution-specific buckets, it allows for more efficient processing and training, as each batch can be optimized for the specific resolution it contains. This method not only enhances the training efficiency but also ensures that the model can handle a wide range of resolutions effectively. The primary goal of the ResolutionBucket node is to facilitate the handling of large datasets with varying resolutions, making it an essential tool for AI artists working with complex image datasets.

Resolution Bucket Input Parameters:

latents

This parameter is a list of latent dictionaries that need to be organized by resolution. Each latent dictionary represents a set of features or encoded information derived from images, which are crucial for training models. The function of this parameter is to provide the raw data that will be sorted into resolution-specific buckets. There are no explicit minimum, maximum, or default values for this parameter, as it depends on the dataset being used. However, it is important that the list of latents is comprehensive and accurately represents the dataset to ensure effective bucketing.

conditioning

This parameter is a list of conditioning lists that must match the length of the latents list. Each conditioning list contains conditions or additional information that corresponds to the latent data, which can influence the training process. The conditioning parameter ensures that each latent is paired with the correct set of conditions, maintaining the integrity of the data during the bucketing process. Like the latents parameter, there are no specific minimum, maximum, or default values, but it is crucial that the conditioning lists are correctly aligned with the latents to avoid mismatches.

Resolution Bucket Output Parameters:

latents

This output parameter provides a list of batched latent dictionaries, with each batch corresponding to a specific resolution bucket. The function of this output is to deliver the organized latent data, now grouped by resolution, which can be directly used for training models. This organization allows for more efficient processing and training, as each batch is tailored to a specific resolution, optimizing the model's performance.

conditioning

This output parameter offers a list of condition lists, each associated with a specific resolution bucket. The purpose of this output is to ensure that the conditions are correctly aligned with the batched latents, maintaining the data's integrity and relevance during training. By providing conditions in a resolution-specific manner, the node ensures that the model can effectively utilize the additional information during the training process.

Resolution Bucket Usage Tips:

  • Ensure that the list of latents and conditioning lists are of the same length to avoid mismatches during the bucketing process.
  • Use the ResolutionBucket node when dealing with datasets that have a wide range of resolutions to optimize the training process and improve model performance.
  • Regularly check the logs to understand how many samples are being processed in each resolution bucket, which can help in fine-tuning the dataset for better results.

Resolution Bucket Common Errors and Solutions:

Mismatched Latents and Conditioning Length

  • Explanation: This error occurs when the number of latents does not match the number of conditioning lists, leading to a mismatch during the bucketing process.
  • Solution: Ensure that both the latents and conditioning lists are of the same length before passing them to the node.

Empty Buckets

  • Explanation: This issue arises when there are no latents available for a specific resolution, resulting in empty buckets.
  • Solution: Verify that your dataset includes a diverse range of resolutions and that the data is correctly pre-processed to avoid empty buckets.

Incorrect Data Format

  • Explanation: If the latents or conditioning lists are not in the expected format, the node may fail to process them correctly.
  • Solution: Double-check the format of your input data to ensure it matches the expected structure for latents and conditioning lists.

Resolution Bucket Related Nodes

Go back to the extension to check out more related nodes.
ComfyUI
RunComfy
Copyright 2025 RunComfy. All Rights Reserved.

RunComfy is the premier ComfyUI platform, offering ComfyUI online environment and services, along with ComfyUI workflows featuring stunning visuals. RunComfy also provides AI Models, enabling artists to harness the latest AI tools to create incredible art.

Resolution Bucket