ComfyUI Node: Wildcards

Wildcards:

The Wildcards node is designed to dynamically replace keywords in a text with randomly selected entries from a specified text file. This functionality is particularly useful for AI artists who want to introduce variability and creativity into their text-based prompts or conditioning inputs. By leveraging wildcards, you can generate diverse and unique text outputs, which can be further processed or used as inputs for other nodes. The node supports optional integration with CLIP for tokenization and encoding, enhancing its utility in text-to-image generation workflows.

Wildcards Input Parameters:

textfile

This parameter specifies the text file from which random entries will be selected. The file should be located in the "chibi-wildcards" folder. The entries in this file will be used to replace the keyword in the provided text. The list of available text files is sorted and presented for selection.

keyword

The keyword parameter defines the placeholder in your text that will be replaced by the randomly selected entries from the text file. The default value is "wildcard", but you can customize it to any string that matches the placeholder in your text.

entries_returned

This parameter determines the number of random entries to be selected from the text file. The selected entries will be concatenated with spaces. The minimum value is 1, the maximum is 10, and the default is 1. Adjusting this value allows you to control the amount of variability introduced into your text.

clip

An optional parameter that accepts a CLIP model. If provided, the node will tokenize and encode the generated text using the CLIP model, returning conditioning data that can be used in subsequent nodes. This enhances the integration of text and image generation workflows.

seed

An optional integer parameter that sets the seed for the random number generator. Providing a seed ensures reproducibility of the random selections. If not provided, the random selections will vary each time the node is executed.

text

An optional string parameter that contains the text in which the keyword will be replaced by the selected entries. If this parameter is not provided, the node will simply return the selected entries without any replacement.

Wildcards Output Parameters:

CONDITIONING

If the clip parameter is provided, this output will contain the conditioning data generated by tokenizing and encoding the text with the CLIP model. This data can be used in subsequent nodes to influence image generation or other processes.

text

This output contains the final text after the keyword has been replaced by the selected entries. If the text parameter was provided, it will be the modified text; otherwise, it will be the concatenated entries from the text file.

Wildcards Usage Tips:

• To introduce more variability in your prompts, increase the entries_returned parameter to concatenate multiple random entries.
• Use the seed parameter to ensure reproducibility when you need consistent results across different runs.
• Integrate a CLIP model using the clip parameter to generate conditioning data that can be used for more advanced text-to-image generation tasks.
• Customize the keyword parameter to match specific placeholders in your text, allowing for more flexible text manipulation.

Wildcards Common Errors and Solutions:

FileNotFoundError: [Errno 2] No such file or directory

• Explanation: This error occurs when the specified text file is not found in the "chibi-wildcards" folder.
• Solution: Ensure that the text file exists in the correct folder and that the file name is spelled correctly.

ValueError: entries_returned must be between 1 and 10

• Explanation: This error occurs when the entries_returned parameter is set to a value outside the allowed range.
• Solution: Adjust the entries_returned parameter to a value between 1 and 10.

TypeError: 'NoneType' object is not callable

• Explanation: This error may occur if the clip parameter is not provided correctly.
• Solution: Ensure that a valid CLIP model is passed to the clip parameter if you intend to use CLIP for tokenization and encoding.

KeyError: 'keyword not found in text'

• Explanation: This error occurs when the specified keyword is not found in the provided text.
• Solution: Verify that the keyword parameter matches the placeholder in your text exactly.