<h1 id="comfy-prompt-iterator-comfyui-custom-node">Comfy Prompt Iterator — ComfyUI Custom Node</h1><p>A ComfyUI node that automatically steps through prompts in a text file on each generation run, so you can test multiple prompt variations without touching the graph between runs.</p><p><a target="_blank" rel="ugc" href="https://www.theoath.studio/projects/comfy-prompt-iterator">https://www.theoath.studio/projects/comfy-prompt-iterator</a></p><h1 id="install"><br />Install</h1><pre><code>cp ComfyUI/custom_nodes/
git clone git@github.com:OATH-Studio/comfy-prompt-iterator.git
# restart ComfyUI</code></pre><p></p><p>The node appears in the node browser under <strong>utils/prompt → Prompt Iterator</strong>.</p><hr /><h2 id="inputs">Inputs</h2><p>InputTypeDescription<code>prompt_file</code>DropdownThe text file containing prompts (one per line) from prompt_texts folder<code>control_after_generate</code>DropdownHow to advance the prompt selection after each run</p><hr /><h2 id="outputs">Outputs</h2><p>OutputTypeDescription<code>prompt_text</code>STRINGThe current prompt text (useful for connecting to PromptString nodes)<code>current_index</code>INTOne-based index of the current prompt in the file<code>total_prompts</code>INTTotal prompts in the selected file</p><hr /><h2 id="control_after_generate">control_after_generate</h2><p>This is the key feature. After each generation completes, the node advances its internal prompt selection according to the chosen mode:</p><p>ModeBehaviour<code>fixed</code>Always uses the same prompt — nothing changes between runs<code>increment</code>Moves forward one prompt each run. Wraps back to 0 after the last one<code>decrement</code>Moves backward one prompt each run. Wraps to the last one after index 0<code>randomize</code>Picks a random prompt from the list each run</p><p><strong>Example:</strong> You have 10 prompts in your <code>variations.txt</code> file. Set <code>control_after_generate</code> to <code>increment</code>. Queue 10 runs — each generation automatically uses the next prompt with zero manual intervention.</p><hr /><h2 id="file-organisation">File organisation</h2><p>Create a <code>prompt_texts</code> folder <strong>inside this custom node directory</strong>:</p><pre><code>ComfyUI/custom_nodes/comfy-prompt-iterator/prompt_texts/
    base_prompts.txt
        a beautiful portrait of a woman, detailed face, cinematic lighting

        a beautiful landscape, sunset, mountains in background
    variations.txt
        add blur effect to the image
        add grainy film texture
        add vibrant colors and high contrast</code></pre><h3 id="adding-your-own-prompt-files">Adding your own prompt files</h3><ol><li><p> Create a new <code>.txt</code> file inside <code>prompt_texts/</code> (e.g., <code>my_prompts.txt</code>) </p></li><li><p>Add one prompt per line:</p><pre><code>first prompt variation here
second prompt variation here
third prompt variation here</code></pre></li><li><p> Empty lines are automatically ignored </p></li><li><p> Restart ComfyUI or refresh the node list to see new files in the dropdown </p></li></ol><p>Each <code>.txt</code> file should contain one prompt per line. The node will read all <code>.txt</code> files from <code>prompt_texts/</code> and display them in a dropdown.</p><hr /><h2 id="typical-workflow">Typical workflow</h2><pre><code>Prompt Iterator → Prompt (or CLIPTextEncode) → KSampler → SaveImage
      ↑
  set control_after_generate = increment
  queue N runs (one per prompt variation)</code></pre><p>Connect the <code>prompt_text</code> output to a <strong>Prompt</strong> node or directly to a <strong>CLIPTextEncode</strong> node's text input. This lets you automatically test multiple prompts without manually changing them between generations.</p><hr /><h2 id="using-with-filename-prefix">Using with filename prefix</h2><p>Combine with a Filename Prefix node to organize outputs:</p><pre><code>Filename Prefix (text from prompt_text output) → Save Image</code></pre><p>This embeds the current prompt variation in your saved filenames for easy tracking of which prompt produced which result.</p><pre><code></code></pre><p></p>

Files with SHA256: e3824ec6a436ea4ecb36e52b279cb736026686e3f2da7e1a3d249c73d95033ab