ComfyUI Node: Prompt Replace 🔁

Prompt Replace 🔁:

The PromptReplace node is designed to facilitate dynamic text manipulation by replacing specified target strings within a given input string with alternative text. This node is particularly useful for AI artists who want to create adaptive and varied prompts by leveraging wildcard expansions and controlled randomness. By using a seeded random generator, PromptReplace ensures that the replacements can be deterministic, allowing for consistent results across different runs with the same seed. This feature is beneficial for generating creative content where variability is desired, yet reproducibility is also important. The node processes the input by normalizing the context, expanding wildcards, and applying regex-based replacements, making it a powerful tool for text customization and prompt generation.

Prompt Replace 🔁 Input Parameters:

string

This parameter represents the input text in which replacements will be made. It is the base content that you want to modify by replacing certain parts with new text. The input string can be multiline, allowing for complex and extensive text manipulations.

target_string

The target_string specifies the text or pattern you want to replace within the input string. It can include wildcards, which will be expanded once to determine the exact targets for replacement. This allows for flexible and dynamic identification of text segments to be replaced.

replace_string

This parameter defines the text that will replace the occurrences of the target_string in the input. Like the target_string, it can also include wildcards, which are expanded for each replacement, enabling varied and context-sensitive substitutions.

seed

The seed parameter is an integer that initializes the random number generator used for wildcard expansion and replacement selection. By setting a specific seed, you can ensure that the replacements are consistent across different executions, which is useful for reproducibility.

limit

This parameter sets the maximum number of replacements to perform. If set to zero, there is no limit, and all occurrences of the target_string will be replaced. This allows you to control the extent of modifications applied to the input string.

category

The category parameter is optional and can be used to specify a particular category for wildcard resolution. This helps in organizing and managing different sets of wildcards, ensuring that the replacements are contextually appropriate.

context

The context parameter provides additional information that can be used during wildcard expansion. It is a dictionary of dictionaries, where each key-value pair represents a specific context that influences how wildcards are resolved, allowing for more tailored and precise replacements.

Prompt Replace 🔁 Output Parameters:

result

The result is the modified version of the input string after all specified replacements have been applied. It reflects the changes made by substituting the target_string with the replace_string, providing the final output of the node's operation.

normalized_context

This output provides the normalized context used during the replacement process. It is a dictionary that shows how the input context was interpreted and applied, offering insights into the wildcard resolution and replacement logic.

Prompt Replace 🔁 Usage Tips:

• Use a consistent seed value to ensure reproducibility of results, which is particularly useful when you need to generate the same output across different sessions.
• Leverage wildcards in both target_string and replace_string to create dynamic and varied text outputs, enhancing creativity and adaptability in your prompts.

Prompt Replace 🔁 Common Errors and Solutions:

Invalid regex pattern

• Explanation: This error occurs when the target_string contains invalid characters or patterns that cannot be compiled into a regular expression.
• Solution: Ensure that the target_string is correctly formatted and does not include unsupported regex syntax. Use escape characters if necessary.

Replacement limit exceeded

• Explanation: This error happens when the number of replacements exceeds the specified limit.
• Solution: Increase the limit parameter if you want more replacements to occur, or set it to zero for unlimited replacements.

Context normalization failure

• Explanation: This error indicates that the provided context could not be normalized into the expected format.
• Solution: Verify that the context is a dictionary of dictionaries and that all keys and values are correctly structured.