--- 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](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/