ComfyUI Node: Danbooru Related Tags

Danbooru Related Tags:

The DanbooruRelated node is designed to enhance your creative process by providing co-occurrence recommendations for tags. This node takes the top tag from each segment of a search result and uses it as a seed to query a co-occurrence table. The purpose is to identify related tags that frequently appear together with the seed tags, thereby expanding the pool of tags available for further processing. This expanded pool can then be used for downstream tasks, such as filtering by a language model (LLM). By leveraging co-occurrence data, DanbooruRelated helps you discover new and relevant tags that you might not have considered, enriching your creative projects with a broader range of ideas and associations.

Danbooru Related Tags Input Parameters:

search_result

The search_result parameter is a required input that represents the output from a previous DanbooruTagSearch operation. It serves as the foundation for identifying related tags, as it contains the initial set of tags from which the top tags per segment are selected as seeds for co-occurrence analysis.

limit

The limit parameter controls the maximum number of co-occurrence recommendations that the node will generate. It allows you to specify how many related tags you want to retrieve, with a default value of 50. The minimum value is 10, and the maximum is 200, adjustable in steps of 10. This parameter helps manage the breadth of the tag pool expansion, balancing between comprehensiveness and specificity.

show_nsfw

The show_nsfw parameter is a boolean option that determines whether or not to include tags that are considered not safe for work (NSFW) in the recommendations. By default, this is set to True, allowing NSFW tags to be part of the results. This parameter gives you control over the content sensitivity of the tags being recommended, ensuring that the output aligns with your project's requirements.

Danbooru Related Tags Output Parameters:

related_tags

The related_tags output provides a string of tags that are related to the initial search result. These tags are derived from the co-occurrence analysis and represent additional concepts or themes that frequently appear with the seed tags. This output is valuable for expanding your creative palette with new and potentially inspiring tag combinations.

combined_tags

The combined_tags output is a string that merges the original search result tags with the newly identified related tags. This comprehensive list offers a broader set of tags for further exploration or filtering, enhancing the richness and diversity of your creative work.

debug_info

The debug_info output is a string containing detailed information about the co-occurrence analysis process. It includes data such as tag scores, sources, and other metrics that can help you understand how the related tags were determined. This output is particularly useful for troubleshooting or refining the tag recommendation process.

Danbooru Related Tags Usage Tips:

• To maximize the effectiveness of the DanbooruRelated node, start with a well-defined search result from the DanbooruTagSearch node, as this will provide a strong foundation for identifying meaningful related tags.
• Adjust the limit parameter based on your project's needs; a higher limit can provide more diverse tag suggestions, while a lower limit can help maintain focus on the most relevant tags.
• Use the show_nsfw parameter to control the inclusion of sensitive content, ensuring that the tag recommendations align with your project's content guidelines.

Danbooru Related Tags Common Errors and Solutions:

No related tags found

• Explanation: This error occurs when the node is unable to find any tags that co-occur with the seed tags from the search result.
• Solution: Ensure that the search_result input is correctly provided and contains valid tags. You may also try increasing the limit parameter to allow for a broader search.

Invalid search_result input

• Explanation: This error indicates that the search_result input is not in the expected format or is missing.
• Solution: Verify that the search_result is correctly generated by the DanbooruTagSearch node and is properly passed to the DanbooruRelated node.