license: other
license_name: mixed-non-commercial
license_link: LICENSE.md
tags:
- music-generation
- yue2
- gguf
- text-to-image
- ruach-studio
library_name: ggml
base_model:
- m-a-p/YuE2-3B
- m-a-p/YuE2-Vae-legacy
- Mothersuperior/YuE2-Vae-merge-0.666
- m-a-p/SheetSage2
- openai/whisper-large-v3
- Qwen/Qwen2.5-Omni-7B
- Qwen/Qwen-Image-2512
- Qwen/Qwen-Image-2.1
- Qwen/Qwen3-4B-Instruct-2507
- m-a-p/MERT-v2-FullSong
Ruach Studio · Models v2
Website · GitHub · The guide · ☕ Buy me a Coffee Machine
Everything Ruach Studio runs on, in one place and laid out as its own folders: the music model and its decoders, the transcriber, the stems' and the sound upscaler's models, Whisper, the style listener, the studio's own adapters, the LoRA Trainer's base, and the Artist's painters with the adapters their authors let be shared. 163 files, 256 GB. A copy of the studio's own disk, file for file: what lies here is what it paints, sings and trains with, and the studio fetches all of it from here alone.
Nothing here is ours but the conversions and the studio's own adapters. Every other file is its authors' work, unchanged, under its authors' licence, credited below and line by line in MANIFEST.tsv. Not affiliated with M-A-P, Comfy Org, Mothersuperior, HaileyStorm, atomtanstudio, storagejuju, OpenAI, Systran, Meta, the Qwen team, Unsloth, lightx2v, Falconsai, prithivMLmods, Civitai or the authors named below. If you are an author and want a file of yours taken down, open a discussion here and it goes.
Take what you need
The studio's own install (./fetch-models.sh) takes what your card can run, at a pinned revision, checking each file. By hand, from the studio's root:
hf download goldhub/Ruach_Studio_Models_v2 --local-dir . --include "models/YuE2-3B-Q8_0.gguf" "models/YuE2-Vae-F32.gguf" "models/SheetSage2-Q8_0.gguf" # to sing: 5.3 GB
hf download goldhub/Ruach_Studio_Models_v2 --local-dir . --include "models/YuE2-Vae-*" # the other decoders
hf download goldhub/Ruach_Studio_Models_v2 --local-dir . --include "whisper/*" "separation/*" "universr/*" # Whisper, stems, the sound's upscaler
hf download goldhub/Ruach_Studio_Models_v2 --local-dir . --include "artwork/Qwen-Image-2512/gguf/*Q4_K_M*" "artwork/Qwen-Image-2512/lightning/*" "artwork/Qwen-Image-2512/*.json" "artwork/Qwen-Image-2512/scheduler/*" "artwork/Qwen-Image-2512/tokenizer/*" "artwork/Qwen-Image-2512/text_encoder/*" "artwork/Qwen-Image-2512/vae/*" "artwork/Qwen-Image-2512/transformer/*" # the Artist on 16 GB
hf download goldhub/Ruach_Studio_Models_v2 --local-dir . --include "checkpoints/comfy/checkpoints/yue2_3b_bf16.safetensors" "checkpoints/MERT-v2-FullSong/*" "checkpoints/yue2-mothersuperior-realaudio-tokenizer-v4/*" # the LoRA Trainer's base: 10.5 GB
Known by its content, not its name
SHA256SUMS holds each file's SHA-256 (as sha256sum -c SHA256SUMS reads it, and as Hugging Face knows the file). MANIFEST.tsv adds, for each .safetensors, the SHA-256 of its tensors alone (their names and data, its header's metadata aside), with each file's origin and licence. A file renamed after download, or an adapter whose header was rewritten, is the same file or the same adapter all the same: the studio looks for what it needs by these sums, not by the name it was published under.
What is here
| folder | size | what for | from | licence |
|---|---|---|---|---|
models/ |
21.8 GB | YuE2-3B (BF16, Q8_0, Q6_K, Q5_K_M), its decoders (Standard, Legacy, the 0.666 Blend) and SheetSage2 (F32, Q8_0), the score's transcriber | m-a-p/YuE2-3B and its siblings as GGUF (Serveurperso/YuE2-GGUF); Legacy and Blend converted by the studio from m-a-p/YuE2-Vae-legacy and Mothersuperior/YuE2-Vae-merge-0.666 | CC BY-NC 4.0 |
whisper/ |
3.1 GB | Whisper large-v3 (CTranslate2, float16): the lyrics heard, the takes checked | Systran/faster-whisper-large-v3 | MIT |
separation/demucs/ |
0.34 GB | the stems (htdemucs_ft) | facebookresearch/demucs | MIT |
universr/ |
0.23 GB | the sound's upscaler (the top of a take redrawn) | woongzip1/universr-audio | CC BY 4.0 |
checkpoints/comfy/, checkpoints/MERT-v2-FullSong/, checkpoints/yue2-mothersuperior-realaudio-tokenizer-v4/ |
14.5 GB | the LoRA Trainer's base: YuE2-3B whole in one file (bf16, or int8 for a smaller card), MERT-v2-FullSong (the set's latent cache hears with it) and the realaudio tokenizer head | Comfy-Org/YuE2, m-a-p/MERT-v2-FullSong (its LICENSE and notices beside it), Mothersuperior/yue2-mothersuperior-realaudio-tokenizer-v4 (its card beside it) |
CC BY-NC 4.0 |
checkpoints/Qwen2.5-Omni-7B-GGUF/ |
35.7 GB | the style listener (hears a training set and writes each song's tags) and the Artist's critic: six quants, two projectors | Qwen2.5-Omni-7B as GGUF: ggml-org, unsloth in unsloth/, mradermacher in mradermacher/ |
Apache-2.0 (Qwen's LICENSE, beside the GGUFs; ggml-org's card names it qwen-research, its link leads to the same Apache-2.0) |
loras/ |
1.9 GB | the Kit's library of adapters, the ones their authors license (below); the studio's own: duduk and shofar, six voices by their kind (contralto, baritenor, bass) | the authors below; goldhub/Ruach_Studio_LoRAs | CC BY-NC 4.0 |
artwork/Qwen-Image-2512/ |
129.5 GB | the Artist's main painter: its parts, the GGUFs (Q4_K_M for 16 GB, Q6_K for 24 GB), Lightning (8 steps), and four fp8 single files for 24 GB: its own BASE and the fine-tunes IntoRealism, JibMix, Real | Qwen/Qwen-Image-2512, unsloth/Qwen-Image-2512-GGUF, lightx2v/Qwen-Image-2512-Lightning; the fine-tunes from Civitai by enzino, J1B and wikeeyang | Apache-2.0; the fine-tunes their authors' (share and sell) |
artwork/Qwen-Image-2.1/ |
33.1 GB | the painter that letters and edits a finished picture | Qwen/Qwen-Image-2.1, unchanged, with its LICENSE and the NOTICE it asks for |
Qwen Research Licence: research and evaluation only |
artwork/Qwen3-4B-Instruct-2507/ |
8.1 GB | the covers' prompt writer | Qwen/Qwen3-4B-Instruct-2507 | Apache-2.0 |
artwork/nsfw-filter/ |
0.34 GB | the covers' content filter | Falconsai/nsfw_image_detection | Apache-2.0 |
artwork/loras/ |
7.5 GB | the Artist's adapters their authors let be shared: for 2512 Film Photography, Photostyle by Sean Archer (SFW), Sketch Smudge, Lightning in 4 steps (bf16, fp32) and 8 (fp32); for 2.1 Fantasy ArtStyle, Frank Frazetta, GPT-Image-2 Anime, Lenovo UltraReal | Civitai: bluejaysierra, FASCIUM, aimann, tarn59, makimakimakima12138, Danrisi; prithivMLmods/Qwen-Image-Sketch-Smudge; Lightning by lightx2v | each its author's: share and sell (Civitai); Sketch Smudge and Lightning Apache-2.0 |
The fine-tunes and the Artist's adapters are here because their authors let them be shared. On Civitai each of these allows sharing and selling the model itself and its merges; they are credited all the same. Many others the Artist paints with allow running and renting but not sharing the file (Outpaint, Turbo 4 steps, High Resolution, More Real, Cinematic Photography, Flux Pro Style, the FinalCut fine-tune of 2.1 and more): they stay with their authors on Civitai; taken from there into artwork/loras/ or artwork/Qwen-Image-2.1/checkpoints/, the Artist offers them.
The Kit's library of adapters
The adapters the YuE2 Kit offers, unchanged, at the revisions it pins, laid out as its own downloader lays them out (loras/<folder>/, the small side files the studio reads beside each):
| adapter | what it brings | folder | author | licence |
|---|---|---|---|---|
| Instrumental | no vocals, planned sections | loras/YuE2-instrumental-cot-full-loras/ |
Mothersuperior | CC BY-NC 4.0 |
| sv-billie | hushed bedroom pop | loras/sv-billie-yue2-lora/ |
HaileyStorm | CC BY-NC 4.0, its LICENSE beside it |
| DreamPop v2 | hazy dream pop | loras/sv-dreampop/ |
atomtanstudio | CC BY-NC 4.0 |
| J-pop | bright modern J-pop sound | loras/yue2-jpop-t4-lora/ |
storagejuju | CC BY-NC 4.0 |
| Real audio v4, v9 | real-audio sound, the older and the newest | loras/yue2-mothersuperior-realaudio-tokenizer-v4/ |
Mothersuperior | CC BY-NC 4.0 |
| Industrial rock · Epic trailer · Death metal | riffs and mechanical tone · orchestra and choir · melodic death metal | not here | monsterovich (1, 2) · pduncan (3) | none stated: asked |
What is not here, and why. Three adapters of the Kit's library carry no licence (Industrial rock, Epic trailer, Death metal): the studio fetches them from their authors' repositories, and they are not copied here until their authors say so (asked, linked above). The vocal stem's BS-RoFormer comes through audio-separator, and Qwen2.5-Omni-7B whole (the listener at bf16) from Qwen. The studio's private adapters (a person's own voice, a person's likeness) and its datasets are never published.
Licences
The strictest terms bind what you take: most of this repository is non-commercial. Every file keeps its source's licence, named in MANIFEST.tsv and in LICENSE.md; THIRD_PARTY_NOTICES.md groups them by origin, and licenses/ holds the full texts of the code the decoders name (stable-audio-tools and SnakeBeta/BigVGAN, MIT). MERT-v2-FullSong keeps its LICENSE (CC BY-NC 4.0, its full text) and THIRD_PARTY_NOTICES.md beside its weights. Qwen-Image 2.1 is used under the Qwen Research Licence: research and evaluation only, its notice kept. Using YuE2 in research, please cite YuE, as M-A-P asks.
Credits
YuE2, its decoders and SheetSage2: the Multimodal Art Projection team (m-a-p), as GGUF by Serveurperso. YuE2-3B in one file for ComfyUI: Comfy Org. MERT-v2-FullSong: m-a-p. The 0.666 decoder merge, the instrumental adapter, the realaudio tokenizer head and its NAR adapters: Mothersuperior. The Kit's library: HaileyStorm (sv-billie), atomtanstudio (DreamPop v2), storagejuju (J-pop), gathered by IronWolve's YuE2 Kit. Whisper: OpenAI, in CTranslate2 by Systran. Demucs: Meta AI. UniverSR: woongzip1. Qwen2.5-Omni, Qwen-Image 2512 and 2.1, Qwen3-4B: the Qwen team (Alibaba), the GGUFs by ggml-org, unsloth and mradermacher. Lightning: lightx2v. The content filter: Falconsai. The fine-tunes: enzino (IntoRealism Qwen), J1B (Jib Mix Qwen), wikeeyang (Real-Qwen-Image); 2512's own fp8 as Civitai publishes it. The adapters: bluejaysierra (Film Photography), FASCIUM (Photostyle by Sean Archer), aimann (Fantasy ArtStyle), tarn59 (Frank Frazetta Style), makimakimakima12138 (GPT-Image-2 Anime), Danrisi (Lenovo UltraReal), prithivMLmods (Qwen-Image Sketch Smudge). The conversions: convert-extras.py of the YuE2 Kit by IronWolve (yue2-kit), through the converter of yue2.cpp by Serveurperso.
Gathered for Ruach Studio by Viktor Zhuromskyy (ЙирмиЙа́Ѓу) with Claude (Anthropic) · HERETICAL TANDEM™. The card before 14 October 2026 is kept as README.OLD.md.