<h1 id="ace-step-node-suite:">Ace Step Node Suite:</h1><h1 id="audio-prompting-and-save-management">Audio Prompting &amp; Save Management</h1>The AceStep Node Suite for<a target="_blank" rel="ugc" href="https://docs.comfy.org/tutorials/audio/ace-step/ace-step-v1-5"> Ace Step 1.5 - ComfyUI</a> provides tools for dynamic audio prompting and automated file management. It is designed to handle high-volume audio generation by using wildcards, seed-based randomization, and structured archiving.<h2 id="acestep-smart-prompt">🧠 AceStep Smart Prompt</h2>This node processes input strings before they are sent to an audio model.<ul><li>Logic Credits: This node incorporates partial logic from <a target="_blank" rel="ugc" href="https://civarchive.com/models/2358876/smartwildcardloader">SmartWildcardLoader</a>.</li><li>Recursive Wildcards: Automatically scans the <code>/wildcards</code> directory in the ComfyUI base path. Use the <code>__filename__</code> syntax to insert random lines from local text files.</li><li>LLM Integration: For generating complete lyrics locally, you can use the <a target="_blank" rel="ugc" href="https://civarchive.com/models/2370862/kobold-llm-prompter">Kobold-LLM-Prompter</a>. By attaching the <code>sys_msg_prompt.txt</code> content from this suite as a system command, you can generate perfectly structured musical content. (expirimental)</li><li>Automatic Section Splitting: Parses wildcard files containing <code>TAGS:</code> and <code>LYRICS:</code> headers, automatically routing the content to the respective output pins.</li><li>Seed-Based Reproducibility: Uses MD5 hashing to tie random selections to the manual seed, ensuring results can be reproduced exactly.</li><li>Dynamic Selection: Supports <code>{option A | option B}</code> syntax for selecting between variations.</li><li>Smart Filler: Automatically updates the UI text fields with the final resolved prompt after execution.</li><li>History Management: A dropdown menu allows users to reload tags and lyrics from previously saved session metadata.</li></ul><h2 id="acestep-multi-manager">🎵 AceStep Multi-Manager</h2>A specialized saving node designed to organize generated audio and associated metadata.<ul><li>Format Support: Export audio in WAV, FLAC, or MP3 formats.</li><li>Automatic Versioning: Checks the target folder and increments a counter (e.g., <code>Song_01</code>, <code>Song_02</code>) to prevent overwriting files.</li><li>Metadata Pairing: Generates a <code>.json</code> file for every audio track containing the exact tags and lyrics used for that specific generation.</li><li>Batch Handling: Processes multiple waveforms within a single audio batch, saving them as individual files.</li></ul><h2 id="ui-features">🎨 UI Features</h2><ul><li>Audio Preview: Play back generated tracks directly within the node.</li><li>Session Statistics: Displays the track count and total file size (MB) of the current session.</li><li>Clean-Up: A "Clear List" button resets the preview gallery without deleting files from your disk.</li></ul><hr /><h2 id="installation">🛠 Installation</h2><ol><li>Download: Download the <code>AceStep_Nodes</code> folder.</li><li>Copy: Move the folder into your ComfyUI directory under: <code>ComfyUI/custom_nodes/</code></li><li>Wildcards Setup: Create a folder named <code>wildcards</code> directly in your ComfyUI base directory (if it doesn't exist yet): <code>ComfyUI/wildcards/</code></li><li>Requirements: Ensure you have <code>torchaudio</code> installed in your Python environment (usually included in standard ComfyUI portable versions).</li><li>Restart: Restart ComfyUI.</li></ol><h3 id="how-to-use-with-llms:">How to use with LLMs:</h3>To generate high-quality lyrics, copy the content of <code>sys_msg_prompt.txt</code> (found in the node folder) and use it as the "System Message" or "Instruction" for your LLM (like the Kobold-LLM-Prompter). This ensures the LLM outputs the correct <code>TAGS:</code> and <code>LYRICS:</code> format that the Smart Prompt node can split automatically.

Files with SHA256: 184049eaddfe290a4fba5c47213b2e16d6678accb7ad2684b6d3d0be6d88957c