ComfyUI-Gtsuya-Nodes
ComfyUI-GTSuya-Nodes
ComfyUI-GTSuya-Nodes is a ComfyUI extension designed to add several wildcards supports into ComfyUI. Wildcards allow you to use \_\_name__ syntax in your prompt to get a random line from a file named name.txt in a wildcards directory.
Installation
To install ComfyUI-GTSuya-Nodes in addition to an existing installation of ComfyUI, you can follow the following steps:
How to Use
Wildcards / Simple wildcards (Dir.)
This node allows you to choose any directory on your hard drive containing your wildcards files. Those wildcards files don’t need to be specifically into the ComfyUI root directory. To add Simple wildcards (Dir.) node: Right-click > Add Node > GtsuyaStudio > Wildcards > Simple wildcards (Dir.).
Enter your prompt into the text box. Wildcard words must be indicated with double underscore around them. For example, if your wildcards file is named country.txt, the corresponding wildcard word must be \_\_country__. You can add as many wildcards as you want. Then indicate the path of the directory where your wildcards files are stored.
New Features:
wildcard_depth parameter (default: 50, range: 2-256) to control the maximum recursion depth and prevent infinite loops.# in your wildcards files are now ignored as comments.seed parameter now ensures consistent random selections across runs.__missing__) and trigger a warning in the console. This makes it easier to identify and fix missing wildcard files during debugging.Example of Nested Wildcards:
If you have a file weather.txt containing:
sunny day
__temperature__ weather
rainy afternoonAnd a file temperature.txt containing:
cold
warm
hotUsing \_\_weather__ in your prompt might result in “warm weather” through nested wildcard resolution.
Wildcards / Simple wildcards
This node provides the same functionality as Simple wildcards (Dir.) but automatically uses the wildcards directory in the ComfyUI root folder. This node is kept for backward compatibility with existing workflows. For new workflows, we recommend using Simple wildcards (Dir.) for more flexibility.
To use this node, create a directory named wildcards into the ComfyUI root folder and put all your wildcards text files into it. Add a Simple wildcards node: Right-click > Add Node > GtsuyaStudio > Wildcards > Simple wildcards.
Enter your prompt into the text box. Wildcard words must be indicated with double underscore around them. For example, if your wildcards file is named country.txt, the corresponding wildcard word must be \_\_country__. You can add as many wildcards as you want.
This node supports all the features listed above for Simple wildcards (Dir.): nested wildcards, wildcard depth control, comment support, reproducible results, and automatic filtering of empty lines.
Wildcards / Wildcards Nodes
This node allows to manage wildcards lists and values directly from ComfyUI workflows. It is not dependent anymore on external text files. This node must work in conjunction with Random Line nodes from Hakkun-ComfyUI-nodes which return a random string from a list. To add Wildcards Nodes node: Right-click > Add Node > GtsuyaStudio > Wildcards > Wildcards Nodes.
Enter your prompt into the text box. Wildcard entries (str#) must be indicated with double underscore around them and must correspond to the Random Line nodes linked to this entry. For example, if a Random Line node is linked to str3, the corresponding wildcard word must be \_\_str3__. You can actually use a maximum of 5 wildcards at the same time.
Downloads / Danbooru (ID)
This node allows to automatically get image url and tags list from a post hosted on Danbooru website. This node could work in conjunction with Load Image From URL node from comfyui-art-venture nodes to import the corresponding image directly into ComfyUI. The tags list could be directly used as a prompt, or part of a prompt. To add Danbooru (ID) node: Right-click > Add Node > GtsuyaStudio > Downloads > Danbooru (ID).
The node can be used by indicating the ID number of the Danbooru post website.
Downloads / Danbooru (Random)
This node allows to automatically get image url and tags list from a random post hosted on Danbooru website. It is also possible to restrict obtained results to a specific tag query. This node could work in conjunction with Load Image From URL node from comfyui-art-venture nodes to import the corresponding image directly into ComfyUI. The tags list could be directly used as a prompt, or part of a prompt. To add Danbooru (Random) node: Right-click > Add Node > GtsuyaStudio > Downloads > Danbooru (Random).
To use this node, you need a valid API key from Danbooru website. To obtain such API key, you need first to have a Danbooru account, then ask for a unique API key, and then give permission to use posts:random data. Once it is done, finally indicate your Danbooru login and API key number. The node is ready. The node can be used directly with the default settings. If you want to restrict results and obtain a tags list containing a specific tag, indicate this tag into the tag_query field. This tag must be a valid Danbooru tag website.
Tools / Replace Strings
This node allows to automatically delete or replace some specific strings into a text or a prompt. To add Replace Strings node: Right-click > Add Node > GtsuyaStudio > Tools > Replace Strings.
To use this node, you need to link inputs to 2 text nodes: text entry corresponds to the text where you want to replace or delete strings, and replace_list entry corresponds to the list of words that would be replaced. You have to set one string replacement per line. String replacement line must be like this: string1|string2, where string1 is the string that will be replaced, and string2 is the replacement string. If string2 is not specified, string1 will be deleted from the text.
Tools / Random File From Path
This is a simple node that returns a random file path from a directory. In case of images, this node could work in conjunction with Load Image From URL node from comfyui-art-venture nodes to import the corresponding image directly into ComfyUI. To add Random File From Path node: Right-click > Add Node > GtsuyaStudio > Tools > Random File From Path.
To use this node you just have to indicate a directory path where the files you want to randomly select are located.
Changelog
Version 1.2.0
wildcard_depth parameter to prevent infinite loops (default: 50, range: 2-256)# are now treated as comments and ignored