ComfyUI Node: Prompt Sequence Loader

Prompt Sequence Loader:

The mbmPromptSequenceLoader is a specialized node designed to facilitate the loading of prompt sequences from JSON input files, specifically for use in MBM's Music Visualizer. This node is integral for users who wish to automate or sequence their prompt inputs, allowing for a streamlined workflow when working with complex visualizations. By leveraging this node, you can efficiently manage and utilize a series of prompts, which are essential for generating dynamic and responsive visual content. The node reads the JSON file, validates its structure, and processes the prompt data to ensure that each sequence is correctly interpreted and ready for use. This capability is particularly beneficial for artists and creators who need to handle multiple prompts in a structured and organized manner, enhancing their creative process and output quality.

Prompt Sequence Loader Input Parameters:

filepath

The filepath parameter specifies the location of the JSON file containing the prompt sequence data. It is crucial as it directs the node to the correct file to load and process the prompts. The available options for this parameter are dynamically generated based on the files present in the designated input directory, filtered by supported extensions. This ensures that only valid files are selectable, minimizing errors and streamlining the workflow.

clip

The clip parameter refers to the CLIP model used for encoding the text prompts. This parameter is essential as it determines how the text prompts are transformed into a format that can be utilized by the visualizer. The CLIP model is a powerful tool for understanding and processing text, and its integration into this node allows for more nuanced and effective prompt handling. The parameter is fixed to the "CLIP" option, ensuring compatibility and consistency in the encoding process.

Prompt Sequence Loader Output Parameters:

PROMPTS

The PROMPTS output parameter provides a list of processed prompts, each encapsulated in an MbmPrompt object. This output is crucial as it represents the final, ready-to-use sequence of prompts that can be fed into the visualizer for generating the desired visual effects. Each prompt in the list has been encoded and packaged with any additional data extracted from the JSON file, ensuring that all necessary information is included for optimal performance.

Prompt Sequence Loader Usage Tips:

• Ensure that your JSON file is correctly formatted and includes all necessary fields, such as defaults and sequence, to avoid processing errors.
• Regularly update the list of supported file extensions in the PROMPT_SEQ_EXTENSIONS to accommodate any new file types you may want to use.

Prompt Sequence Loader Common Errors and Solutions:

No prompts provided in the sequence for: <jsonPath>

• Explanation: This error occurs when the JSON file does not contain any prompts in the sequence field, which is required for processing.
• Solution: Check the JSON file to ensure that the sequence field is populated with at least one prompt. If necessary, add prompts to the sequence to resolve this issue.

File not found or unsupported file type

• Explanation: This error indicates that the specified file path does not exist or the file type is not supported by the node.
• Solution: Verify that the file path is correct and that the file extension is included in the PROMPT_SEQ_EXTENSIONS list. Adjust the file path or update the list of supported extensions as needed.