timoncool / YuE2-Studio

# YuE2 Studio
**Full songs with an editable score, generated on your own GPU. One executable — no Python, no Node.js, no launcher.**
**English** · Русский · 中文 · 日本語 · 한국어
YuE2 Studio is a desktop studio for **YuE2**, the open song model from M-A-P that writes a
score before it sings. Describe a style, write the lyrics, and the model composes a melody
with chords as sheet music, then performs it as a full song with vocals. The score comes
back with the track: read it, edit it, and render the same composition again with a
different sound. Windows installer with auto-update or a portable folder, runs offline on
an NVIDIA card with 6 GB of VRAM or more; AMD and Intel cards through Vulkan are experimental.
It is built on yue2.cpp, the native C++/CUDA
port of YuE2. The studio around it is Rust and React in a Tauri window — nothing in the
runtime path is Python.
## For AI agents
Given this repository, an agent can set everything up and drive the studio by itself:
1. Install the studio from the latest release and start it.
2. Connect to its MCP server at `http://127.0.0.1:8791/mcp`:
 `claude mcp add --transport http yue2-studio http://127.0.0.1:8791/mcp`
3. Read the skill it serves (resource `studio://skill`, prompt `studio`), the same text as
 docs/mcp-skill.md, and start with the tool `studio_status`.
llms.txt says the same for tools that look for it. To keep the skill in Claude
Code, save docs/mcp-skill.md as `~/.claude/skills/yue2-studio/SKILL.md`.
## What you can do
- **A player of its own** — a ten-band equalizer on Winamp's frequencies with its presets,
 your own and .EQF files; a MilkDrop visualiser with hundreds of presets or a spectrum in ten
 looks, over the studio, fullscreen or in its own window; and a Winamp mode that turns the whole
 window into a skinned Winamp 2 whose windows move apart, dock and resize — the original skin
 and ten more included, sharp at any scale, the Winamp Skin Museum one click away,
 Ctrl+M to switch. The song, its place and the equalizer carry over both ways.
- **Save as, and a Files panel** — songs, stems, MIDI, lyric sheets, scores and videos are
 saved where you say, in Windows' own Save dialog, and the Files panel shows each save.
- **A proxy for the whole studio** — HTTP, HTTPS, SOCKS5 or SOCKS4, with a login: model
 downloads, Hugging Face, OpenRouter and updates go through it.
- **Full songs from a style and lyrics** — up to ten minutes, in the languages the model
 sings. In Russian a stress mark (the combining acute U+0301, Alt+0769 on Windows) after a
 vowel moves the sung stress to it, as Ruach Studio documents. On an RTX 4090 with the Q8_0 set a 3:38 song renders in about 46 seconds.
- **Read and edit the score** — the model writes its composition in ABC notation first; the
 studio engraves it as sheet music. Edit the notes, tempo or key and create again: the
 composition stays, the performance changes. Or switch to melody-only, or no score at all.
- **Compose the score first** — write only the score fr