ComfyUI Node: EZ Tag Loader

EZ Tag Loader:

The EZ_Tag_Loader node is designed to streamline the process of loading and managing tags from a text file, making it an invaluable tool for AI artists who need to organize and utilize tags efficiently. This node allows you to select tags from a specified text file, offering flexibility in how these tags are chosen and applied. Whether you need to select a single tag, multiple tags, or even randomize the selection, the EZ_Tag_Loader provides the functionality to accommodate these needs. It also includes options to filter tags based on specific text criteria and append additional text to each tag, enhancing the customization and control over the tag selection process. By integrating this node into your workflow, you can significantly enhance your ability to manage and apply tags, ultimately improving the efficiency and effectiveness of your AI art projects.

EZ Tag Loader Input Parameters:

tags_file

This parameter specifies the text file from which tags will be loaded. It is crucial as it defines the source of the tags that will be processed and selected. The file must be a text file located within the designated directory, and it should contain the tags you wish to use. The node will search for tags within this file, making it the foundational input for the tag loading process.

selection_mode

This parameter determines how tags are selected from the file. It offers three options: single, multiple, and random. The single mode allows for the selection of one tag at a time, multiple mode enables the selection of several tags with the output being comma-separated, and random mode randomly selects one of the visible (filtered) tags each time the node is executed. The default mode is single, and the choice of mode impacts how tags are outputted and used in your project.

selected_tags

This optional parameter allows you to specify tags that should be pre-selected. It is useful when you have a set of tags you frequently use and want to ensure they are included in the selection process. By default, this parameter is an empty string, meaning no tags are pre-selected unless specified.

filter_text

This optional parameter enables you to filter the tags based on a specific text string. It helps in narrowing down the list of tags to those that contain the specified text, making it easier to find and select relevant tags. The default value is an empty string, indicating no filtering is applied unless a text string is provided.

add_after

This optional parameter allows you to append a text string after each selected tag. It is particularly useful for adding context or additional information to tags, ensuring they are formatted according to your needs. The default value is an empty string, meaning no additional text is appended unless specified.

opt_seed

This optional parameter is used in the random selection mode to control the randomness of the tag selection. It accepts an integer value, with a default of 0, and a range from 0 to 0xffffffffffffffff. If connected, it ensures consistent random selections based on the seed value; if not connected, the node will re-execute on each prompt, providing different random selections each time.

EZ Tag Loader Output Parameters:

STRING

This output provides the selected tag(s) as a string. If multiple tags are selected, they are delimited by commas. This output is essential for integrating the selected tags into your AI art projects, allowing you to apply them as needed.

OPT_FILEPATH

This output returns the path to the currently selected text file containing the tags. It is useful for verifying the source of the tags and ensuring that the correct file is being used in the selection process.

BATCH_SELECTED

This output provides a list of all selected items. If no items or only a single item is selected, it outputs all visible (filtered) items. This output is particularly useful for batch processing or when you need to apply multiple tags simultaneously.

EZ Tag Loader Usage Tips:

• Use the filter_text parameter to quickly narrow down tags to those that are most relevant to your current project, saving time and improving efficiency.
• When using the random selection mode, connect the opt_seed parameter to ensure consistent results across different executions, which is useful for reproducibility in your projects.
• Take advantage of the add_after parameter to automatically format tags with additional context or information, streamlining the process of preparing tags for use.

EZ Tag Loader Common Errors and Solutions:

"No tags file found"

• Explanation: This error occurs when the specified text file cannot be found in the designated directory.
• Solution: Ensure that the file path is correct and that the file exists in the specified directory. Double-check the file name and location.

"No tags found in file"

• Explanation: This error indicates that the specified text file does not contain any tags.
• Solution: Verify that the file is not empty and that it contains the tags you intend to use. Add tags to the file if necessary.

"No matching tags found"

• Explanation: This error occurs when no tags match the specified filter_text.
• Solution: Adjust the filter_text to broaden the search criteria or ensure that the text string accurately reflects the tags you are looking for.