--- 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

Ruach Studio · OSEM: Open Source, Engaged & Musical

Website · GitHub · The guide · ☕ Buy me a Coffee Machine

Everything [Ruach Studio](https://github.com/igrbible/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: ```bash 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](https://huggingface.co/m-a-p/YuE2-3B) and its siblings as GGUF ([Serveurperso/YuE2-GGUF](https://huggingface.co/Serveurperso/YuE2-GGUF)); Legacy and Blend converted by the studio from [m-a-p/YuE2-Vae-legacy](https://huggingface.co/m-a-p/YuE2-Vae-legacy) and [Mothersuperior/YuE2-Vae-merge-0.666](https://huggingface.co/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](https://huggingface.co/Systran/faster-whisper-large-v3) | MIT | | `separation/demucs/` | 0.34 GB | the stems (htdemucs_ft) | [facebookresearch/demucs](https://github.com/facebookresearch/demucs) | MIT | | `universr/` | 0.23 GB | the sound's upscaler (the top of a take redrawn) | [woongzip1/universr-audio](https://huggingface.co/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](https://huggingface.co/Comfy-Org/YuE2), [m-a-p/MERT-v2-FullSong](https://huggingface.co/m-a-p/MERT-v2-FullSong) (its `LICENSE` and notices beside it), [Mothersuperior/yue2-mothersuperior-realaudio-tokenizer-v4](https://huggingface.co/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](https://huggingface.co/ggml-org/Qwen2.5-Omni-7B-GGUF), [unsloth](https://huggingface.co/unsloth/Qwen2.5-Omni-7B-GGUF) in `unsloth/`, [mradermacher](https://huggingface.co/mradermacher/Qwen2.5-Omni-7B-GGUF) 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](https://huggingface.co/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](https://huggingface.co/Qwen/Qwen-Image-2512), [unsloth/Qwen-Image-2512-GGUF](https://huggingface.co/unsloth/Qwen-Image-2512-GGUF), [lightx2v/Qwen-Image-2512-Lightning](https://huggingface.co/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](https://huggingface.co/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](https://huggingface.co/Qwen/Qwen3-4B-Instruct-2507) | Apache-2.0 | | `artwork/nsfw-filter/` | 0.34 GB | the covers' content filter | [Falconsai/nsfw_image_detection](https://huggingface.co/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](https://huggingface.co/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](https://github.com/IronWolve/yue2-kit) offers, unchanged, at the revisions it pins, laid out as its own downloader lays them out (`loras//`, 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](https://huggingface.co/Mothersuperior/YuE2-instrumental-cot-full-loras) | CC BY-NC 4.0 | | sv-billie | hushed bedroom pop | `loras/sv-billie-yue2-lora/` | [HaileyStorm](https://huggingface.co/HaileyStorm/sv-billie-yue2-lora) | CC BY-NC 4.0, its `LICENSE` beside it | | DreamPop v2 | hazy dream pop | `loras/sv-dreampop/` | [atomtanstudio](https://huggingface.co/atomtanstudio/lora-library) | CC BY-NC 4.0 | | J-pop | bright modern J-pop sound | `loras/yue2-jpop-t4-lora/` | [storagejuju](https://huggingface.co/storagejuju/yue2-jpop-t4-lora) | CC BY-NC 4.0 | | Real audio v4, v9 | real-audio sound, the older and the newest | `loras/yue2-mothersuperior-realaudio-tokenizer-v4/` | [Mothersuperior](https://huggingface.co/Mothersuperior/yue2-mothersuperior-realaudio-tokenizer-v4) | 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](https://huggingface.co/monsterovich/yue2-industrial-rock-lora/discussions/4), [2](https://huggingface.co/monsterovich/yue2-steps-from-hell/discussions/3)) · pduncan ([3](https://huggingface.co/pduncan/YuE2_Deathmetalv1_lora/discussions/1)) | 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`](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](https://arxiv.org/abs/2503.08638), as M-A-P asks. ## Credits YuE2, its decoders and SheetSage2: the Multimodal Art Projection team ([m-a-p](https://huggingface.co/m-a-p)), as GGUF by Serveurperso. YuE2-3B in one file for ComfyUI: [Comfy Org](https://huggingface.co/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](https://huggingface.co/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](https://github.com/IronWolve/yue2-kit)), through the converter of [yue2.cpp](https://github.com/ServeurpersoCom/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`](README.OLD.md).