YuE2 Options

YuE2 Generate Song asks for three things - style, lyrics, seed - and hides everything else on purpose. YuE2 Options is where "everything else" lives, and the important thing about it is what happens when you don't use it: an unconnected options socket is not a special case. The node starts from the released defaults either way. So this isn't a config you have to get right before the first song; it's a panel you open once you have a reason.

Worth knowing where this sits first. The community's local music default is ACE-Step - fast, instrumental-leaning, weak exactly where YuE2 is aimed: vocals and lyrics. YuE2 is the other bet, a 3B model that writes a readable score and then sings it, and it's new enough that there's no accumulated folklore about which settings are good. The defaults are the model's own. Touch less than you think you need to.

The inputs that matter

Three are required, and they're the ones people actually change:

• cot - how much is planned before anything is sung. full writes a melody-and-chords score first (the default, and where the benchmark numbers come from), melody plans the tune and lets the accompaniment follow the style, and off skips the score entirely and goes straight from lyrics to audio - faster, and no readable plan to edit. Stick with full unless you're chasing speed.
• max_seconds - the length ceiling, 0 to 360 seconds, 0 meaning "work it out from the lyrics". Here's the part that bites: changing this changes the song, not just its length. The ceiling sizes the static KV cache and the captured CUDA graph, which reorders the attention reduction. Same seed, same lyrics, 40 and 90 second ceilings: identical for 79 tokens, divergent at the 80th. Settle this number before you go seed hunting, or you'll be chasing a moving target.
• keep_model_loaded - keeps the 6.8 GB on the card after the run. Saves around five seconds per run while you iterate, holds the VRAM until ComfyUI restarts. Leave it off when video or image nodes come next.

Then the optional fields you'll plausibly touch: attention_backend (sdpa by default and reproducible; cudnn is about 17% faster and produced four different songs from one seed over four runs - use it for exploring only), cfg_scale (0 means the released value, 1.0 normally; anything other than 1.0 runs a second unconditional branch, so roughly double the time and double the KV cache - raise it only when the result is ignoring your style), quantization (bf16 vs int8 - see below), download, vae (standard for listening, legacy to reproduce published numbers), device, ode_steps (32 is the released value; fewer is faster and thinner), and two banks of sampling numbers: abc_temperature / abc_top_p / abc_top_k for the score stage, and temperature / top_p / top_k / repetition_penalty for the song stage.

The output is one handle, options (YUE2_OPTIONS), and it plugs into the matching socket on YuE2 Generate Song, YuE2 Write Song, YuE2 Plan Batch, YuE2 Render Plan or YuE2 Decode Latents. One options node can feed all of them.

Two things people expect and don't get

INT8 does not save VRAM. quantization: int8 downloads Comfy-Org's 3.69 GB build instead of 7.26 GB - real on a slow connection, nothing on your card. This pack's layers are ordinary torch linears, so the weights are restored to BF16 as the file loads and the GPU holds the same 6.8 GB either way. It also isn't quite the same model: the round trip costs about a percent of each weight, so the same seed gives a different song. Download size only.

A second card is worth it, and a mixed one isn't. device is auto or cpu on a single-GPU install, with more entries when ComfyUI sees more cards; cpu works and takes about an hour a song. A second card stops YuE2 competing with ComfyUI's own VRAM, which is also when keep_model_loaded starts paying - but two YuE2 nodes pinned to different devices reload all 6.8 GB every run, because the loaded model is cached per device.

Install

Manager, search YuE2-ComfyUI (YuE2 Music), or:

cd ComfyUI/custom_nodes
git clone https://github.com/pytraveler/YuE2-ComfyUI

Restart after. tiktoken is the only new requirement; if it's missing the node prints the correct pip line for the interpreter ComfyUI runs on. Leave download on auto and the pack fetches the 7.26 GB Comfy-Org checkpoint into models/checkpoints/ on first run - the same file ComfyUI's own YuE2 nodes read, so one download serves both. off downloads nothing and tells you which files are missing, with a link and a folder for each.

One last gotcha: if you wire an options node into YuE2 Render Plan to change cot on a plan that already exists, it won't. cot is part of the prompt the score was written under, so it always comes from the plan, and the node warns you that it's ignoring your change.