ComfyUI Node: Prompt Shuffle ♻️ (Advanced)

Prompt Shuffle ♻️ (Advanced):

PromptShuffleAdvanced is a sophisticated node designed to shuffle prompt tags in a progressive, seedable, and direction-aware manner. This node is particularly beneficial for AI artists who want to introduce variability and randomness into their prompts while maintaining control over the shuffling process. By leveraging different algorithms and modes, PromptShuffleAdvanced allows you to customize how prompt tags are rearranged, whether through complete randomization or more controlled, step-by-step movements. The node's ability to preserve the original tokens without altering whitespace or dropping empty tokens ensures that the integrity of the input is maintained. This makes it an essential tool for generating diverse and creative outputs in AI art projects.

Prompt Shuffle ♻️ (Advanced) Input Parameters:

string

This parameter represents the input string containing the prompt tags you wish to shuffle. It is crucial as it serves as the base content that will be manipulated by the node. The default value is an empty string.

separator

The separator is a string that defines how the input string is split into individual tokens or tags. By default, it is set to a comma (,), but you can adjust it to match the delimiter used in your input string, such as ", " if your input uses spaced commas.

shuffle_amount_start

This integer parameter sets the initial amount of shuffling to be applied. It determines the starting point for the shuffling process, with a default value of 0. The minimum value is 0, and the maximum is 999.

shuffle_amount_end

This integer parameter defines the final amount of shuffling to be applied, allowing for a range of shuffling intensity from the start to the end. The default value is 10, with a minimum of 0 and a maximum of 999.

mode

The mode parameter specifies the method of shuffling, offering options such as "WALK", "WALK_FORWARD", "WALK_BACKWARD", and "JUMP". Each mode provides a different approach to rearranging the tags, from step-by-step movements to complete randomization. This parameter allows you to control the direction and style of the shuffle.

algorithm

This parameter determines the algorithm used for shuffling, with options like "RANDOM", "LINEAR_IN", "LINEAR_OUT", "SHUFFLE_DECAY", and "SHUFFLE_DECAY_REVERSE". Each algorithm offers a unique way to influence the shuffling process, affecting how the tags are rearranged over time.

limit

The limit parameter sets the maximum number of single-item moves to perform during the shuffling process. A value of 0 indicates a full shuffle, completely randomizing the order. The default value is 0, with a minimum of 0 and a maximum of 1,000,000.

seed

This integer parameter is used to initialize the random number generator, ensuring that the shuffling process is repeatable and consistent across runs. The default value is 0, with a minimum of 0 and a maximum of 18,446,744,073,709,551,615.

Prompt Shuffle ♻️ (Advanced) Output Parameters:

shuffled_string

The output parameter is a string that represents the shuffled version of the input prompt tags. This output reflects the rearrangement of the original tags based on the specified parameters, providing a new order that can be used for creative AI art generation.

Prompt Shuffle ♻️ (Advanced) Usage Tips:

• To achieve a completely random shuffle, set the limit parameter to 0, which allows the node to fully randomize the order of the tags.
• Use the seed parameter to ensure consistent results across multiple runs, which is particularly useful when you want to reproduce specific shuffling outcomes.
• Experiment with different mode and algorithm combinations to explore various shuffling styles and effects, enhancing the diversity of your AI-generated art.

Prompt Shuffle ♻️ (Advanced) Common Errors and Solutions:

Invalid separator

• Explanation: The separator provided does not match the delimiter used in the input string, leading to incorrect tokenization.
• Solution: Ensure that the separator parameter matches the delimiter used in your input string, such as using ", " if your input uses spaced commas.

Shuffle amount out of range

• Explanation: The values for shuffle_amount_start or shuffle_amount_end are outside the allowed range.
• Solution: Adjust the shuffle_amount_start and shuffle_amount_end parameters to be within the range of 0 to 999.

Seed value too large

• Explanation: The seed value exceeds the maximum allowed limit.
• Solution: Ensure that the seed parameter is within the range of 0 to 18,446,744,073,709,551,615.