Built: 2026-11-04T11:35:00Z
Beginner installation guide

Install YuE2

Answer six short questions. We will turn your choices into one exact path and explain every step in plain language.

Development snapshot · rolling latest
YuE2 currently publishes one CUDA image, latest. No stable application digest or baked/tiny model variants are documented. Download approximately 4.34 GB of GGUF models before starting.

Tell us about this computer

Your answers stay in this browser. Nothing is submitted or stored on our server.

Operating system
Computer hardware
Image source
Who should be able to open it?

Install Docker

Download Docker Desktop from the official guide, run the installer with the recommended WSL 2 option, then open Docker and wait for the engine to start: Docker Desktop for Windows ↗.

Open the command window

Select the Windows Search button on the taskbar, type PowerShell, and open Windows PowerShell: .

Paste this first check and press Enter:

Check Docker
docker version

You should see both Client and Server sections. If Server is missing, open Docker and wait for it to finish starting.

Download and start YuE2

Copy the complete one-line command, paste it into the same window, and press Enter. The first download can be large, so leave the window open.

Generated command
docker run -d --name yue2 --restart unless-stopped -p 127.0.0.1:8087:8087 --gpus all --mount "type=bind,source=$($PWD.Path)\data\models,target=/models,readonly" hangrylabs/yue2:latest

Open YuE2

Wait until the application reports that it is ready, then select this button:

Open YuE2 at localhost:8087 ↗

Download the models first, start Docker, then open Create. Enter musical direction and lyrics and select Generate. Library stores songs in this browser; export the tracks you want to keep.

If the page does not open yet, give the first startup another minute and try again.

Useful commands for later

Open PowerShell or Terminal again whenever you need one of these.

Stop
docker stop yue2
Start again
docker start yue2
Watch startup messages
docker logs -f yue2

A SHA-256 digest identifies an exact build, not its security freshness. Immutable releases do not receive later fixes. Review release notes and remaining advisories before choosing a version; use a newer published build when needed. Release and security notes ↗

What did the choices change?

The full image includes model assets and is the easiest offline-friendly choice after the first pull. The tiny image downloads models during first use. Docker Hub and GHCR are official sources; 1ms is an optional third-party mirror. Local-only binds to 127.0.0.1; home-network access publishes the port on every interface and belongs only on a trusted private network.