<h1 id="comfyui-custom-node:-prompt-list-json-05mu81iq8">ComfyUI Custom Node: Prompt List JSON</h1>This repository provides a custom node for <a rel="ugc" href="https://github.com/comfyanonymous/ComfyUI">ComfyUI</a> that allows managing positive and negative prompts in a structured JSON format. The node supports creating new prompt lists, random prompt selection, and logging prompt details to the console for seamless integration into your workflow.<h2 id="features-e8gduxz0w">Features</h2>- 📂 JSON-based prompt management: Prompts are stored in individual JSON files for easy editing and retrieval.- 🔄 Add or update prompts: Supports creating new prompt lists, updating existing prompts, and overwriting as needed.- 🎲 Random prompt selection: Choose a random prompt from an existing list with ease.- 🖥️ Console logging: Optionally logs prompt details with formatted outputs for debugging or verification.- 🛠️ Automatic file management: Ensures required directories and files are created automatically.<h2 id="installation-1eku0njj1">Installation</h2>1. Clone or download this repository to your ComfyUI custom node directory:<pre><code> git clone https://github.com/TKRLAB/ComfyUI_Prompt_List_JSON.git</code></pre>2. Restart ComfyUI to load the custom node.<h2 id="alternative-method-lqj8g0sbm">Alternative Method</h2>1. Install using the ComfyUI manager.<img src="https://image.civitai.com/xG1nkqKTMzGDvpLrqFT7WA/1f0f377e-ee9d-4a05-8a02-df95f819ba0e/width=525/1f0f377e-ee9d-4a05-8a02-df95f819ba0e.jpeg" /><h2 id="usage-wxi0koez4">Usage</h2><img src="https://image.civitai.com/xG1nkqKTMzGDvpLrqFT7WA/5e9d6c47-c9a7-4f18-91fe-c2e047cd66a5/width=525/5e9d6c47-c9a7-4f18-91fe-c2e047cd66a5.jpeg" />Node Inputs- Prompt List: Select an existing prompt list or create a new one.- New List Name: Specify the name for a new list (used when creating a new list).- Prompt Name (required): A unique name for the prompt.- Positive Prompt (required for new prompts): The positive description of the prompt.- Negative Prompt (optional): The negative description of the prompt.- Random (boolean, default <code>False</code>): Enable random selection of prompts from the list.- Overwrite (boolean, default <code>False</code>): Whether to overwrite an existing prompt with the same name.- Console Log (boolean, default <code>False</code>): Prints prompt details to the console for debugging.<h3 id="node-outputs-ks4zjwrt8">Node Outputs</h3>- Positive Prompt: The saved or retrieved positive prompt.- Negative Prompt: The saved or retrieved negative prompt.- Full List: The entire prompt list as a JSON string.<h3 id="example-workflow-wp05dguvg">Example Workflow</h3>1. Add or update a prompt with the following inputs: - Prompt List: <code>test.json</code> - New List Name: <code>test</code> - Prompt Name: <code>girl on helmet</code> - Positive Prompt: <code>concept art Girl in black thin, oily latex, black motorcycle helmet, black glass on helmet, pours a bucket of yellow paint on himself, paint dripping down his body, yellow silk long scarf, sexy, dynamics. Black mirrors in the background, reflections. digital artwork, illustrative, painterly, matte painting, highly detailed</code> - Negative Prompt: <code>photo, photorealistic, realism, ugly</code> - Overwrite: <code>True</code> - Console Log: <code>True</code> - Random: <code>True</code><img src="https://image.civitai.com/xG1nkqKTMzGDvpLrqFT7WA/223bb85f-64eb-42ce-b83f-d5c915a8e821/width=525/223bb85f-64eb-42ce-b83f-d5c915a8e821.jpeg" />2. The prompt will be saved to the specified JSON file, and its details will appear in the console if logging is enabled.<h3 id="file-structure-pw2msgnfk"><img src="https://image.civitai.com/xG1nkqKTMzGDvpLrqFT7WA/91d48e2c-876e-48d9-bf33-666f0ce17420/width=525/91d48e2c-876e-48d9-bf33-666f0ce17420.jpeg" />File Structure</h3>Prompts are stored in individual JSON files in the following format:<pre><code>{
 "SunsetScene": {
 "positive": "A breathtaking sunset over the mountains",
 "negative": "Low quality, blurry"
 }
}</code></pre><h3 id="adding-prompts-programmatically-zx85a5ygf">Adding Prompts Programmatically</h3>You can also use this node programmatically. Here's an example:<pre><code>from your_module import ComfyUI_Prompt_JSON
manager = ComfyUI_Prompt_JSON()
positive, negative, full_list = manager.process(
 **{
 "Prompt List": "New List",
 "New List Name": "NaturePrompts",
 "Prompt Name": "SunsetScene",
 "Positive Prompt": "A breathtaking sunset over the mountains",
 "Negative Prompt": "Low quality, blurry",
 "Random": False,
 "Overwrite": True,
 "Console Log": True
 }
)</code></pre><h3 id="error-handling-nyvxw43ur">Error Handling</h3>- Raises a <code>ValueError</code> if a required field (e.g., <code>Prompt Name</code> or <code>Positive Prompt</code>) is missing.- Displays detailed error messages for debugging in the console.<img src="https://image.civitai.com/xG1nkqKTMzGDvpLrqFT7WA/2f8106d7-5e6f-4a3b-ac45-78216f230de3/width=525/2f8106d7-5e6f-4a3b-ac45-78216f230de3.jpeg" /><img src="https://image.civitai.com/xG1nkqKTMzGDvpLrqFT7WA/7db75655-7220-4e43-86a7-b26371346f28/width=525/7db75655-7220-4e43-86a7-b26371346f28.jpeg" /><img src="https://image.civitai.com/xG1nkqKTMzGDvpLrqFT7WA/12b92199-0eef-488b-9bb2-4aeb2a64d9a6/width=525/12b92199-0eef-488b-9bb2-4aeb2a64d9a6.jpeg" /><h2 id="license-eio88tv12">License</h2>This project is licensed under the GNU General Public License v3.0. See the <a rel="ugc" href="https://github.com/TKRLAB/ComfyUI_Prompt_List_JSON/blob/master/LICENSE">LICENSE</a>Enjoy using the Prompt List JSON node with ComfyUI! 🎨

Files with SHA256: 21add1309ce07a87818db7090b9ac20cf848b55f4a5f12f006ae94c04ffcf35f