ComfyUI Node: TagFilter

TagFilter:

The TagFilter node is designed to help you manage and refine your tags by filtering out unwanted tags based on specific criteria. This node is particularly useful for AI artists who need to organize and clean up their tag lists, ensuring that only relevant tags are included in their projects. By using the TagFilter node, you can streamline your workflow, improve the accuracy of your tag-based searches, and maintain a more organized and efficient tagging system. The node works by taking a list of tags and applying filters to exclude certain tags based on predefined categories or criteria, making it easier to focus on the tags that matter most to your work.

TagFilter Input Parameters:

tags

This parameter accepts a string of tags separated by commas. It represents the initial list of tags that you want to filter. Each tag should be separated by a comma, and the node will process these tags to determine which ones to keep and which ones to exclude. There is no minimum or maximum value for this parameter, but it is recommended to provide a well-defined list of tags for optimal results.

pose

This boolean parameter determines whether tags related to poses should be included in the filtering process. If set to True, pose-related tags will be considered; if set to False, they will be excluded. The default value is True.

gesture

This boolean parameter controls the inclusion of gesture-related tags. When set to True, tags associated with gestures will be included in the filtering process. If set to False, they will be excluded. The default value is True.

action

This boolean parameter specifies whether action-related tags should be included. Setting this parameter to True will include action tags, while setting it to False will exclude them. The default value is True.

emotion

This boolean parameter determines the inclusion of emotion-related tags. If True, emotion tags will be included in the filtering process; if False, they will be excluded. The default value is True.

expression

This boolean parameter controls whether expression-related tags should be included. When set to True, expression tags will be included; if set to False, they will be excluded. The default value is True.

camera

This boolean parameter specifies whether camera-related tags should be included. Setting this parameter to True will include camera tags, while setting it to False will exclude them. The default value is True.

angle

This boolean parameter determines the inclusion of angle-related tags. If True, angle tags will be included in the filtering process; if False, they will be excluded. The default value is True.

sensitive

This boolean parameter controls the inclusion of sensitive tags. When set to True, sensitive tags will be included; if set to False, they will be excluded. The default value is True.

liquid

This boolean parameter specifies whether liquid-related tags should be included. Setting this parameter to True will include liquid tags, while setting it to False will exclude them. The default value is True.

include_categories

This parameter accepts a string of categories separated by commas that you want to include in the filtering process. Tags that fall under these categories will be included in the final result. The default value is an empty string, which means no specific categories are included by default.

exclude_categories

This parameter accepts a string of categories separated by commas that you want to exclude from the filtering process. Tags that fall under these categories will be excluded from the final result. The default value is an empty string, which means no specific categories are excluded by default.

TagFilter Output Parameters:

result

The output parameter result is a string that contains the filtered list of tags, separated by commas. This output represents the final list of tags after applying the specified filters and criteria. It is important for understanding which tags have been retained and can be used for further processing or analysis.

TagFilter Usage Tips:

• To effectively use the TagFilter node, start by providing a comprehensive list of tags that you want to filter. Ensure that the tags are well-defined and relevant to your project.
• Adjust the boolean parameters (pose, gesture, action, etc.) based on the specific criteria you want to apply. For example, if you are only interested in emotion-related tags, set the other boolean parameters to False.
• Use the include_categories and exclude_categories parameters to fine-tune the filtering process. Specify the categories that are most relevant to your work to ensure that only the desired tags are included in the final result.

TagFilter Common Errors and Solutions:

Invalid tag format

• Explanation: The tags provided are not in the correct format (e.g., missing commas or extra spaces).
• Solution: Ensure that the tags are separated by commas and do not contain extra spaces. For example, use "tag1, tag2, tag3" instead of "tag1 tag2 tag3".

Missing required parameters

• Explanation: One or more required parameters are missing or not provided.
• Solution: Check that all required parameters (tags, pose, gesture, etc.) are provided and have valid values. Refer to the input parameter descriptions for guidance.

Invalid category format

• Explanation: The categories provided in include_categories or exclude_categories are not in the correct format.
• Solution: Ensure that the categories are separated by commas and do not contain extra spaces. For example, use "category1, category2" instead of "category1 category2".