YuE2

YuE2

ComfyUI-ready files for the YuE2 3B music model, packaged by Comfy-Org, with workflows for text to music and music cover. Free for non-commercial use only.

Made by Comfy-Org on Hugging Face. These notes are Mindket's, written from its model page and model card; the model's own files and license are on Hugging Face.

About

What it is: This repository holds ComfyUI-ready copies of the YuE2 3B music model and its SheetSage2 audio encoder, repackaged by Comfy-Org from the m-a-p originals. Two workflows are listed, one for making music from text and one for covering existing music. Both files are in BF16.

Who it suits: ComfyUI users and music makers who want to try text-to-music and music-cover generation inside a node editor, for personal or research projects.

Industry | Who uses it | How they use it | Example
Music | Hobbyist musicians | Draft songs from a written description | A short track from a style prompt
Content creation | Video makers | Try background music ideas for non-commercial clips | A backing track for a personal video
Research | AI researchers | Explore a 3B music model in a visual workflow | A test of the cover workflow
Education | Teachers and students | Show how text to music works in ComfyUI | A classroom demo

If you need music for commercial work, or you do not use ComfyUI, you can skip it.

Where to use it:

• ComfyUI on Windows, macOS or Linux with Python
• The two Comfy-Org workflow templates named YuE2 Music Cover and YuE2 Text to Music

Use case | Who | What they get back
Text to music | Music makers | A song generated from a written description
Music cover | Music makers | A cover version of an existing piece of music

How to set it up:

• ComfyUI installed on your computer
• Python, to run the Hugging Face download tool
• Room for the two model files

1. Install the Hugging Face hub tools with pip.
2. Download the repository with the hf command.
3. Put sheetsage2_bf16.safetensors in the audio_encoders folder inside ComfyUI models.
4. Put yue2_3b_bf16.safetensors in the checkpoints folder inside ComfyUI models.
5. Open one of the two workflows in ComfyUI.

pip install -U huggingface_hub
hf download Comfy-Org/YuE2

How to use it: Open ComfyUI, load the Text to Music or Music Cover workflow, check that its loader nodes find your two files, and run it.

Tool | What it does
YuE2 Text to Music | Workflow that makes music from a text description
YuE2 Music Cover | Workflow that covers existing music
yue2_3b_bf16.safetensors | The YuE2 3B checkpoint
sheetsage2_bf16.safetensors | The SheetSage2 audio encoder

Example: You load the Text to Music workflow, type a short description of the song you want and run it. By the workflow's name, ComfyUI returns a piece of music.

For newcomers and experts: Start with the Text to Music workflow and a short, simple description. Move to the cover workflow after you have heard the first result.

The repository separates the model into a checkpoint and an audio encoder, which ComfyUI loads from different folders. The checkpoint comes from the YuE2 3B release and the encoder from SheetSage2. Both are stored as BF16 safetensors files.

Place the two files in ComfyUI folders
Open a YuE2 workflow
Give a text description or music to cover
Run the nodes
Audio comes out

Good to know:

• License: CC BY-NC 4.0, which is non-commercial
• Cost to run: none named
• Data it reaches: downloads files from Hugging Face, then runs on your own machine in ComfyUI
• Not for: commercial use under the stated license
• Not for: use outside ComfyUI, since the card describes only ComfyUI file placement

On Hugging Face, 13 November 2026

• Library: diffusion-single-file
• Downloads in the last 30 days: 384,692
• Likes: 322
• License: cc-by-nc-4.0
• Based on: m-a-p/YuE2-3B
• Fine-tunes: 1
• Tags: diffusion-single-file, comfyui

Links

• Model: https://huggingface.co/Comfy-Org/YuE2
• Files: https://huggingface.co/Comfy-Org/YuE2/tree/main

Get the model

Download its files with Hugging Face's command line:

pip install -U huggingface_hub
hf download Comfy-Org/YuE2

Then follow the usage in its model card. Nothing in this kit runs by itself.