ComfyUI Node Documentation: XY Input: Checkpoint

Overview

The XY Input: Checkpoint node is part of the Efficiency Nodes for ComfyUI, designed to create dynamic workflows by plotting different models on a grid. This node facilitates the exploration and comparison of multiple model checkpoints in various settings.

Node Functionality

What the Node Does

The XY Input: Checkpoint node allows users to specify a list of model checkpoints (and optionally, their associated clip skips and VAEs) for use in XY Plot scripts. This feature is particularly useful for comparing results across different model configurations, making it easy to visualize differences and optimize outputs.

Inputs

The node accepts the following inputs:

• target_ckpt: Specifies whether the checkpoint is a "Base" model checkpoint or a "Refiner".

• input_mode: Defines the method by which checkpoints are loaded:

  • "Ckpt Names": Only the checkpoint names are considered.
  • "Ckpt Names+ClipSkip": Both checkpoint names and their associated clip skips are considered.
  • "Ckpt Names+ClipSkip+VAE": Checkpoint names, clip skips, and associated VAEs are considered.
  • "Checkpoint Batch": Load checkpoints from a folder based on specific criteria.

• batch_path: Path to the directory containing batch files if using "Checkpoint Batch" mode.

• subdirectories: Boolean flag indicating whether to include subdirectories when loading batch files.

• batch_sort: Determines sorting order of batch files ([ascending, descending]).

• batch_max: Specifies the maximum number of batch files to load. A value of -1 indicates no limit.

• ckpt_count: The number of checkpoints to process when not in batch mode.

• ckpt_name_{i}: The name of each specific checkpoint, where i ranges from 1 to the set ckpt_count.

• clip_skip_{i}: The clip skip value for each checkpoint, available when the input mode supports it.

• vae_name_{i}: The VAE associated with each checkpoint, available when the input mode supports it.

Outputs

The node produces the following output:

• X or Y: A tuple containing the type ("Checkpoint" or "Refiner") and the processed list of checkpoint configurations. This output is used as an input to the XY Plot node to create visual comparisons across models.

Usage in ComfyUI Workflows

In ComfyUI, this node is useful in workflows that require comparing different model checkpoints side-by-side. By connecting the output of this node to an XY Plot node, users can visualize the effects of different checkpoints and configurations within a grid. This visualization can include variations in clip skips and VAEs if specified, providing a comprehensive overview of how different parameters affect output results.

Special Features and Considerations

• Batch Processing: The ability to load checkpoints directly from a directory is powerful for users who manage many models, helping to streamline workflows by avoiding manual entry of each checkpoint.

• Comprehensive Comparison: Users can explore the combined effects of different checkpoints, clip skips, and VAEs together within plots.

• Dynamic Configurations: The node provides several modes for input selection, offering flexibility depending on the user's needs.

When using this node, ensure that all paths and configurations are correctly set to avoid errors in loading and processing files. This node is an integral part of creating advanced and efficient workflows within the ComfyUI ecosystem, especially when used alongside other Efficiency Nodes.