<a target="_blank" rel="ugc" href="https://github.com/ace-step/ACE-Step-1.5">ACE-Step 1.5</a> is an open-source music model similar to Suno, Udio, Mureka, Lyria, etc.<h1 id="workflows-are-embedded-in-the-videos">Workflows are embedded in the videos</h1>Just drag and drop them into ComfyUI to import it (it includes an optional group of nodes to load a static image and turn it into a video along with the generated song).<hr /><h1 id="features">Features</h1><ul><li>Lightweight: The model runs locally with less than 4GB of VRAM.</li><li>Fast: a 2 minutes song can be generated in a minute or so in a low-end GPU (&lt;= 8GB VRAM).</li><li>Uncensored: you can prompt any lyrics you want.</li><li>Multiple languages: over 50 languages are supported officially.</li></ul><h1 id="models">Models</h1><h2 id="sft-1.7b-aio-checkpoint">SFT 1.7B AIO checkpoint</h2>I've merged the following models into a single checkpoint file:<ul><li><a target="_blank" rel="ugc" href="https://huggingface.co/ACE-Step/acestep-v15-sft/blob/main/model.safetensors">acestep-v15-sft.safetensors</a>: the SFT model, which sounds better than the Turbo version, while requiring only a few more steps.</li><li><a target="_blank" rel="ugc" href="https://huggingface.co/Comfy-Org/ace_step_1.5_ComfyUI_files/blob/main/split_files/text_encoders/qwen_0.6b_ace15.safetensors">qwen_0.6b_ace15.safetensors</a>: mandatory text encoder.</li><li><a target="_blank" rel="ugc" href="https://huggingface.co/Comfy-Org/ace_step_1.5_ComfyUI_files/blob/main/split_files/text_encoders/qwen_1.7b_ace15.safetensors">qwen_1.7b_ace15.safetensors</a>: additional 1.7B text encoder, which is many times faster than the <a target="_blank" rel="ugc" href="https://huggingface.co/Comfy-Org/ace_step_1.5_ComfyUI_files/blob/main/split_files/text_encoders/qwen_4b_ace15.safetensors">4B alternative</a> while being almost as good in my own experiments).</li><li><a target="_blank" rel="ugc" href="https://huggingface.co/Comfy-Org/ace_step_1.5_ComfyUI_files/blob/main/split_files/vae/ace_1.5_vae.safetensors">ace_1.5_vae.safetensors</a>: the VAE.</li></ul>Simply download it to your <code>ComfyUI/models/checkpoints</code> folder.<h1 id="tips">Tips</h1><h2 id="prompts">Prompts</h2>The model expects 2 optional prompts: caption/tags and lyrics/structure.<h3 id="captiontags">Caption/tags</h3><ul><li>Guide the model to what kind of genre and instruments you want in your music, as well vocals, mood, era, mixing style, etc.<ul><li>Genres: <code>jazz</code>, <code>rap</code>, <code>rock</code>, <code>metal</code>, <code>hip hop</code>, <code>bossa nova</code>, <code>electronic</code>, <code>synthwave</code>, <code>blues</code>, <code>reggae</code>, etc. A potential list of all 178k genres used during training can be found <a target="_blank" rel="ugc" href="https://raw.githubusercontent.com/ace-step/ACE-Step-1.5/refs/heads/main/acestep/genres_vocab.txt">here</a>.</li><li>Instruments: <code>acoustic guitar</code>, <code>piano</code>, <code>drums</code>, <code>bass</code>, <code>synths</code>, <code>electric guitar</code>, <code>violin</code>, etc</li><li>Vocals: <code>raspy male vocal</code>, <code>young female vocal</code>, <code>duet harmonies</code>, <code>whispering child</code>, etc</li><li>See more tags in the <a target="_blank" rel="ugc" href="https://github.com/ace-step/ACE-Step-1.5/blob/main/docs/en/Tutorial.md#about-caption-the-most-important-input">official tutorial</a>.</li></ul></li><li>Either comma-separated tags, or natural language.</li><li>Multiple genres may be provided, but conflicts will likely harm the quality.</li><li>Even small changes will impact the result substantially.</li></ul><h3 id="lyricsstructure">Lyrics/structure</h3><ul><li>The model will sing better if each line contains between 6 and 10 syllables.</li><li>It's recommended to provide structure tags to organise your lyrics. Examples:<ul><li><code>[Intro]</code>, <code>[Verse]</code>, <code>[Chorus]</code>, <code>[Bridge]</code>, <code>[Instrumental]</code>, <code>[End]</code>, etc.</li></ul></li><li>Add an empty line between structure blocks.</li><li>Inside a structure tag, you may add other hints. Examples:<ul><li><code>[Intro - Dreamy]</code>, <code>[Chorus - Layered vocals]</code>, <code>[Instrumental - Guitar solo]</code>, <code>[Bridge - Whispering]</code>, etc.</li></ul></li><li>Some singing techniques/effects are recognised. Examples:<ul><li><code>ACE-Step is heeere</code>: hold the note for longer.</li><li><code>For your mind (your mind)</code>: backing vocals.</li><li><code>Stand up and SHOUT</code>: sing with more power.</li><li><code>[pt] Obrigado, amigo</code>: switches to a different language</li><li><code>[whispering] Don't be afraid</code>: attempt to add said effect.</li></ul></li></ul><h2 id="metadata">Metadata</h2>All metadata are an effort to guide music attributes, but they might be overridden by the prompts.The most relevant are listed below:<ul><li><code>bpm</code>: beats per minute, determines the tempo. Common distribution: slow songs 60–80, mid-tempo 90–120, fast songs 130–190.</li><li><code>duration</code>: target duration in seconds. The model officially supports 10s-600s. Short songs (30–60s) and medium length (2–4min) are stable; very long generation may have repetition or structure issues.</li><li><code>timesignature</code>: 4/4 (most common), 3/4 (waltz), 6/8 (swing feel).</li><li><code>language</code>: choose one of the many supported languages for the lyrics.</li><li><code>keyscale</code>: Affects overall pitch and emotional color. Usually Minor = darker mood; Major = brighter mood.</li><li><code>generate_audio_codes</code>: when enabled (recommended), spends much more time on the text encoder conditioning to improve song quality substantially.</li></ul><h2 id="sampling">Sampling</h2>Most of the music (melody, harmony, cadence, etc) comes from the conditioning, so tweak sampling parameters to explore variations.<ul><li><code>steps</code>: the SFT model requires at least 20, but I recommend 30-50 for good results. Sometimes requires 50-100+ to improve failed parts.</li><li><code>cfg</code>: 1.0 is good enough, even for the SFT model. Increasing it to 2.0 seems to improve vocals while reducing presence of instruments. Over 2.0 starts to harm the output (do your own experiments though).</li><li><code>sampler</code>: my favourites: <code>sa_solver_pece</code>, <code>heun</code>, <code>dpmpp_sde</code>, <code>uni_pc_bh2</code>, <code>euler</code>, etc.</li><li><code>scheduler</code>: my favourites: <code>beta</code>, <code>simple</code>, <code>kl_optimal</code>, etc.</li></ul>

ACE-Step 1.5 - Music generation for low VRAM

ScragVAE — Improved VAE Decoder for ACE-Step 1.5This is a drop-in replacement for ACE-Step 1.5 standard VAE. Full credits to the original author: <a target="_blank" rel="ugc" href="https://huggingface.co/scragnog/Ace-Step-1.5-ScragVAE">https://huggingface.co/scragnog/Ace-Step-1.5-ScragVAE</a>

Files with SHA256: b89c6a9b0ab8e799923a2d35ee69810fbb07124f9e86540bf00870163a8e0b0c