Local draft

Style Trainer setup

Requires full PyTorch YuE2 + VAE weights and a BF16-capable NVIDIA GPU. GGUF weights cannot train or use these LoRAs. Select local model paths in Advanced settings, then check setup. No community encoder or lyric files are needed.

Check existing files first. Downloads and GPU training only start after separate explicit actions. After a download finishes, click Check setup, then Use downloaded model paths.

Model terms: YuE2-3B license · VAE license. If FFmpeg is missing, use 48 kHz mono/stereo WAV or FLAC, or install FFmpeg on PATH for conversion.

EXPERIMENTAL STYLE TRAINING

Build your sound.

Choose your songs, share one style, and train an acoustic LoRA.

Trains acoustic production style from your recordings. It may influence vocal texture, but does not specifically train singer identity or separate vocals from instruments.

Each selected song is split into consecutive chunks across the song—not just its first few seconds. For example, a 3-minute song produces 18 ten-second clips. Any shorter leftover ending is excluded. Each training step learns from one clip, cycling through a shuffled pool; enough steps are needed to visit every clip. Longer clips provide more context but need more VRAM. This does not set the length of songs you generate or alter your original files.

ⓘ Shared style and clip length

Describe the shared sound: instruments, genre, vocal delivery, and production. Every selected song uses the same description. Clip estimates count complete fixed-length clips; shorter tails are excluded. Longer clips will require more training memory.

Choose a folder to inspect its audio. No matching text files are needed.

Saved training projects

Train a style LoRA

Uses the saved project selected above, not unsaved form edits. Training joins Studio's GPU queue after existing jobs. Other apps are not managed by this queue.

ⓘ How much training?

Defaults to 2,000 updates, not 2,000 passes through every song. Each step learns from one clip. Use 20 steps only for a short technical smoke test. More steps can strengthen the effect, but excessive repetition can overfit and damage musical variety. Loss alone cannot tell you whether it sounds better.

ⓘ How strongly does it learn?

The peak update size; training warms up then tapers it. Start at 0.0001. Larger values can learn faster but become unstable or spoil the sound; smaller values may need more steps. There is no universal safe cutoff. Non-finite loss or gradients stop the run.

ⓘ How much can it remember?

Rank controls adapter capacity and memory use. Start at 8. Higher ranks produce larger files and can overfit a small collection. This version trains acoustic attention only; it does not retrain the song composer or guarantee singer identity.

ⓘ Checkpoints and stopping

Defaults to saving an intermediate adapter every 500 steps to audition later. Frequent saves use more disk space. Cancel waits for a safe boundary and saves completed training updates; closing Studio may force-stop after 10 seconds. Existing checkpoints survive. These adapter files are for inference, not exact optimizer-state resume.

ⓘ Models, caching, and the first run

Uses the local YuE2 and VAE folders from Models & runtime, independently of the inference backend. Requires a BF16 NVIDIA GPU; actual training memory use is still experimental. All selected audio clips are encoded first, even for a 20-step test. The cache is reused when source audio, VAE identity, and clip settings match. Original songs and model weights are never overwritten.

Start with the 20-step smoke test. No GPU training starts until you queue it.

Training runs

EXPERIMENTAL ARTIST TRAINING

Train your artist sound.

Use full recordings, matching lyrics, and a shared style to train an Artist LoRA.

SEPARATE WORKFLOW · ARTIST AR LORA

Artist Trainer · Experimental

Prepare Artist Trainer

These actions use the shared queue. Checks hash local files without GPU allocation. Downloads and dependency installation require confirmation; neither starts training. Setup remains experimental.

Encoder/companion terms · Reference pack · YuE2 · VAE · MERT

Use Check setup; results and errors appear in the Library run. Preparing paths records them only after verification.

Train the song-generation branch using whole recordings, full lyrics, and shared style. Separate from Style trainer's acoustic workflow. Experimental: check the verification status above; passing a short test does not guarantee voice similarity or a stable long run. Completed Artist runs appear in the Style / Artist LoRA selector. Select No score and Torch explicitly before generation.

ⓘ Trigger phrase

A distinctive phrase to associate with your artist. Future preparation will combine it with the shared style. Saving this setup does not train it yet.

ⓘ Lyrics are required for this new workflow

Choose the naming convention used by your folder. Each audio filename must have an exact matching text filename, without its audio extension. UTF-8 text only, up to 64 KB per song. Plain .txt files are treated as lyrics only when you explicitly choose that option; style-only files are not lyrics. Include complete words with section tags, then check each preview against the recording. We do not rename or overwrite source files.

ⓘ Shared style and full songs

Keep lyrics separate from this description. Uses complete 30–360 second songs, not the acoustic trainer’s short clips. No model quality, encoder compatibility, or voice identity has been verified by this scan.

Scanning and saving do not start a GPU job.

Saved artist setups

Train an Artist LoRA

Uses the saved setup selected above, not unsaved edits. At least two 30–360 second songs; the last selected song is held out for validation. Whole songs are used without silent clipping. Reference songs make up approximately half of training examples.

ⓘ Steps

Optimizer updates, with two song examples per update. There is no artificial maximum, but longer runs take proportionally longer and can overfit. Try 20 only for a technical smoke test; it is not a quality test.

ⓘ Rank

Adapter capacity. 64 follows the community recipe; lower ranks use less training memory but may learn less detail.

ⓘ Learning rate

The strongest update size reached after warmup. Higher values learn faster but can overfit or damage quality. The schedule below controls how quickly it becomes gentler.

ⓘ Learning-rate schedule

Auto warms up, then gradually reduces the rate to 20% at the final requested step. This supports longer runs but cannot prevent overfitting. Legacy reproduces the original curve, which tapers as if every run lasts 3,000 steps.

ⓘ Checkpoints

Keeps intermediate adapters so you can compare training lengths later. More frequent saves use more disk space. These are adapter snapshots, not exact optimizer-resume files.

ⓘ Timing methods

MMS forces every English lyric word onto the separated vocals. Whisper-assisted uses fine-tuned Demucs and Whisper large-v3 to recognize words, match them to your lyric file, and estimate missing positions. Only recognized word timing contributes to training; the full lyric text still conditions every song. A timing JSON is saved for review in the Library run. Whisper large-v3 weights download on first use.

ⓘ Lyric alignment weight

0.08 follows the community recipe. 0 skips all timing preparation and timing loss, regardless of the selected method; full lyrics still condition training. Higher values can overemphasize imperfect timestamps. MMS uses every aligned word; Whisper-assisted excludes estimated timestamps from the timing loss.

Uses Studio's shared queue. Progress, logs, cancellation, and saved checkpoints appear in Library → Open run. Cancellation waits for a safe boundary; separation/alignment of a full song can take time.

FROM AN IDEA TO A SONG

Make something worth hearing.

Your words, your direction. A whole new sound.

Checking engine…

Try a direction
/
0 words

Section tags guide the arrangement. Keep instruments and performance directions in Style.

Melody & score ABCOptional

Supply a native two-voice ABC score to use an existing melody. A supplied score bypasses the planner. Edit a copy; original run artifacts stay intact.

Prepare melody removes chord symbols and checks that the retained notes, timing and meter stay unchanged. Selecting one voice silences the other.

Plans a melody with chords, then renders the song.

Keep the seed to compare variations.

EXPERIMENTAL

Shape the generation

These are musical shortcuts for groups of Advanced settings. Keep inputs fixed and compare multiple runs: the same seed does not guarantee identical music. These shortcuts apply to the Python engine, not GGUF.

Default
?
Familiar ↔ Unexpected

Changes Symbolic planner temperature, top-p, and top-k while YuE2 invents melody and harmony. It does nothing for Direct audio or a supplied score.

Experiment warning: this slider stays around 0.55–1.0 temperature. Advanced values above 1.0 can make plans less coherent; below 0.55 can make them overly predictable or repetitive. These are caution bands, not guaranteed failure points.

FamiliarDefaultUnexpected
Default
?
Controlled ↔ Adventurous

Changes Audio token sampling temperature, top-p, and top-k. It can influence performance, texture, phrasing, and timbral choices, but it cannot guarantee a specific vocal or instrument.

Experiment warning: this slider stays around 0.8–1.2 temperature. Advanced values above 1.2 may become erratic or noisy; below 0.8 may become flatter or repetitive. Results vary by seed and song.

ControlledDefaultAdventurous
Default
?
Loose ↔ Focused

Changes semantic CFG guidance: how strongly generation follows the supplied style and lyrics. It does not change the symbolic planner, and a supplied ABC remains the score condition.

Experiment warning: the default is Automatic. This slider uses 0.85–1.15; moving away from 1 can add a second CFG branch and increase work. Advanced values above 1.15 become increasingly aggressive and may distort or destabilize a result. Higher is not automatically better.

LooseDefaultFocused

Experimental positions can change a new render, never an existing song. Exact values are saved with each run and remain editable in Advanced settings.

Checking local adapters…

Add a local LoRA / folder location

YuE2 acoustic Style adapters only. Adapters for other models cannot be used here.

48 kHz · Stereo32 synthesis steps · Lossless FLAC
MADE IN YOUR STUDIO

Your sounds, all in one place.

Listen, revisit a score, or take a song in a new direction.

Your first song belongs here.

Create a song or transcribe a recording.
Its audio, score, settings, and progress will appear here.

MAKE IT YOURS

Studio appearance

Choose the mood that feels right for your studio.

COLOR THEMES
UNDER THE HOOD

Every detail, in your hands.

Native engine controls, with the context to use them well.

THE WRITING ASSISTANT

LLM Runner

Your choice of model. Your creative partner.

Kept in memory only; active batches retain the key until they finish. Never included in projects, run files, or browser autosave.

Starter list from your video builder. Refresh to load available models from the provider.

Writing controls & instructions

Blank lets the provider choose. Some reasoning models reject explicit temperature values.

Output ceiling, including reasoning where applicable. Increase if a draft is cut short; provider/model limits still apply.

How long to wait for a model response, including local loading. Range: 15–600 seconds.

Added to the built-in Yue2 songwriting instructions for every draft.

Read the complete songwriting instructions
STUDIO RUN

Run details

Live engine log

Exact request & settings
Artifacts & provenance
QUICK START

Welcome to your studio.

Make an original song

Describe the sound in Style, add lyrics with [Verse] and [Chorus] tags, then choose Create song. Full mode creates melody and harmony before audio. Plan only creates an editable score without rendering audio.

Give a melody a new sound

Choose Create a cover and upload a recording. Transcribe it, then use Review melody in the completed run. You can also import native ABC directly. Check the score and use Prepare melody to remove chords, keeping both melodic voices by default. Enter the target style and lyrics, then create your cover. Full mode can keep the score’s harmony too.

Train a Style or Artist LoRA

Style trainer learns production from audio clips. Artist Trainer uses whole songs with matching lyrics and a shared style. Artist steps have no artificial maximum; Auto matches the learning-rate schedule to the requested steps. Unchanged songs reuse cached encoding and Whisper/MMS timing, so changing only the step count does not repeat preparation. Completed adapters appear in the Style / Artist LoRA selector.

Publish to Audius

The app maintainer configures one Audius developer key and callback. Users open Connected platforms, connect or create a normal Audius account, confirm publishing rights, then choose Upload to Audius on a completed Library song. Users do not need their own developer key.

Write with an LLM

Open LLM Runner, choose a provider, enter an API key if needed, and refresh the model list. Custom model IDs are supported. Test the connection, describe your idea in the writing room, and review the editable draft before applying it. You can refine the current lyrics or generate only a style.

Tags & timing

[Verse] and [Chorus] are the official example’s section cues. Other section tags are editable text cues, not guaranteed control tokens. Put vocal delivery, instruments, mood, language and intended BPM in Style. Yue2 has no exact-duration slider or singer-cloning input.

GPU memory recovery

If song generation runs out of CUDA memory, Studio retries once in a fresh process and enables safer memory behavior where compatible. It does not shorten or rewrite the song. If the retry also fails, close other GPU applications and try a shorter or less complex song.

Closing Studio

Closing the last Studio tab stops the server after a 15-second grace period. Refreshing or keeping another tab open keeps it running. Active songs, batches and writing requests finish before automatic shutdown. To return, use Start Yue2 Studio.bat.

Your work stays organized

Each GPU job uses a fresh folder in runs/studio. The library keeps audio, scores, exact requests, token arrays, latents, logs and provenance. Cancel stops that job’s worker. Interrupted jobs need a fresh run. Local draft autosave and exported project JSON exclude API keys. Save a project to make a portable backup; original recordings remain in this workspace.

Local LLMs & memory

Use LM Studio, Ollama, or a custom OpenAI-compatible server for local models. Start that server and load a text model before connecting. If it shares your music GPU, unload its model before a large music run. Ollama requests use keep_alive=0 to release the model after writing.

Official Yue2 music skill ↗

CONNECTED PLATFORM

Audius

Publish finished songs directly from your library.

Connect with Audius to allow Yue2 to upload songs to your account. Yue2 never receives your Audius password.

Replace this draft?

GPU MEMORY

Yue2 ran out of memory twice

The automatic retry also ran out of GPU memory. The song may be too long for the available VRAM. Check for background applications using the GPU, close them, and try again.

MUSIC MODELS

Choose how your music runs.

Switch engines without changing your lyrics, style, or score.

1. Connect your installed audio.cpp engine

Standard build folders are detected automatically. Model downloads install weights, not the engine or CUDA drivers.

Need to install the engine?

Install a Yue2-capable audio.cpp build. On Windows, building requires Visual Studio C++ Build Tools, CMake/Ninja, and CUDA Toolkit for NVIDIA. Keep runtime DLLs beside the executable, then paste its full path above.

Step-by-step setup guide ↗ · Windows build instructions ↗

2. Choose a GGUF model

Each download includes the F16 decoder and all four supporting files. Existing complete files are verified and reused. Source: audio-cpp on Hugging Face (CC BY-NC 4.0).

Use model changes the engine and GGUF component paths only. Your song and sampling controls stay as they are. Advanced settings still expose every control and custom model folders.