YuE2

  · · · · · ·            

YuE2 is an open music generation model with frontier song quality competitive with Suno v5/v6. Turn lyrics and a style prompt into a complete song with vocals and accompaniment, then shape its melody and chords through an editable score.

State-of-the-art results on WildSongBench. YuE2 (best-of-8) achieves the highest SongBench average among all evaluated open and proprietary models: 6.9632, compared with 6.8721 for Suno v5, 6.5562 for Suno v6, and 6.4195 for Suno v6 Wild.

Frontier song quality and text alignment on 192 WildSongBench prompts. YuE2 uses symbolic planning; Bo8 means best-of-8.

September 12, 2026 comparison: 17 settings, including Suno v6 and Suno v6 Wild. Vector PDF · SVG · All nine metrics and protocols · Full-precision CSV.

• Compose and edit: melody + chords, melody-only, or direct generation; bring your own ABC score.
• Edit with an agent: turn musical feedback into score, style and lyric revisions, then let YuE2 render the next version. Hear the editing process.
• Run locally: 48 kHz stereo songs on a 24GB GPU, without quantization.
• Build on it: Hugging Face loading, text guidance (CFG), and separate planning and synthesis APIs.

One AR–NAR Mixture-of-Transformers backbone writes the score and semantic tokens, then generates acoustic latents through flow matching. The VAE turns them into stereo audio.

🎧 Listen to YuE2

🎶 Text-to-music

Original songs generated from lyrics and a style prompt.

Cyber Metal · English · 5:00

今晚不眠 · Mandarin funk / nu-disco · 3:24

Passion · English rock · 3:55

All three songs use 🤗 YuE2-Vae.

🎙️ Cover songs

Existing songs reimagined in a new style.

Make your own cover →

Auld Lang Syne · Jazz-funk cover · 3:10

最炫民族风 · Ballad cover · 4:45

Jingle Bells · Heavy metal cover · 1:09

🤖 Agentic editing

Explore the agentic editing demo →

Follow The Last Train through 9 steps and 14 versions, from Mandarin pop to English jazz with modern harmony and a saxophone solo built around two complete statements of “Twinkle, Twinkle, Little Star.” Hear the full songs and inspect the conversation, scores, prompts and lyrics at each step.

Try editing with an agent →

🚀 Quick start

Linux · Python 3.10+ · 24GB NVIDIA GPU with BF16 support. Install the inference package:

python -m pip install huggingface-hub==0.36.2
hf download m-a-p/YuE2-3B yue2_infer-0.1.5-py3-none-any.whl --local-dir .
python -m pip install ./yue2_infer-0.1.5-py3-none-any.whl

Create · Cover · Edit & agentic edit

Load the pipeline once for the examples below:

from pathlib import Path
from yue2 import YuE2Pipeline

pipe = YuE2Pipeline.from_pretrained("m-a-p/YuE2-3B", device="cuda")

🎶 Create

Turn a style prompt and lyrics into a complete song with vocals and accompaniment.

Use the style and full lyrics from 今晚不眠, the funk / nu-disco demo above.

import json
from huggingface_hub import hf_hub_download

repo = "m-a-p/YuE2-3B"
prompt_path = hf_hub_download(repo, "examples/tonight-awake.json")
demo = json.loads(Path(prompt_path).read_text(encoding="utf-8"))
style, lyrics = demo["style"], demo["lyrics"]

song = pipe(style=style, lyrics=lyrics, cot="full", seed=demo["seed"])
song.save("song.flac")
song.save_artifacts("outputs/song")  # ABC, tokens, latents, audio and settings

Defaults are ready to use: cot="full" and 🤗 YuE2-Vae.

🎙️ Cover

Start from an existing recording and give it a new arrangement.

For covers, we recommend melody-only mode (cot="melody").

1. Get the score: transcribe the existing song with 🤗 SheetSage2 and save its melody ABC without chord symbols as melody.abc.
2. Get the lyrics: ask an agent to find them online, or transcribe the singing with Qwen3-ASR or the Gemini API. Check the words, organize them into sections matching the recording, and save them as cover_lyrics.txt.
3. Choose a target style and generate: review or edit the score and lyrics, then supply them to YuE2 with cot="melody" and your target style prompt.

Run the transcription tools in their own environments, then use the YuE2 pipeline:

cover = pipe(
    style="Jazz-funk, warm lead vocal, Rhodes piano, electric bass, tight drums",
    lyrics=Path("cover_lyrics.txt").read_text(encoding="utf-8"),
    abc=Path("melody.abc").read_text(encoding="utf-8"),
    cot="melody", seed=831001,
)
cover.save("cover.flac")
cover.save_artifacts("outputs/cover")

cot="melody" does not remove chord symbols automatically. Use cot="full" if you want to supply the original or edited harmony as well.

🎼 Edit & agentic edit

Edit the ABC yourself, or give an agent the score, original prompt and lyrics, and your requested changes. The agent can reharmonize, develop a solo, or adapt the lyrics and style; YuE2 renders each revision. [Hear the multi-