Document Old School Hip-Hop LoRA

Document the Old School Hip-Hop adapter, trigger word, training details, usage settings, and checksum.

README.md

@@ -9,6 +9,7 @@ tags:
   - music-generation
   - audio
   - dream-pop
+  - old-school-hip-hop
   - sound-and-vision
 ---
 
@@ -16,13 +17,14 @@ tags:
 
 A growing library of LoRAs by **Atomtan Studio**, with downloads, trigger words, settings, and compatibility notes together on one page.
 
-The first release is **DreamPop v2 for YuE2-3B**, a music style adapter intended for atmospheric dream pop. More adapters can be added to this same repository, organized by base model and style.
+The library currently includes **DreamPop v2** and **Old School Hip-Hop** adapters for YuE2-3B. More adapters can be added to this same repository, organized by base model and style.
 
 ## Available LoRAs
 
 | LoRA | Base model | Checkpoint | Trigger | Download |
 | --- | --- | --- | --- | --- |
 | **DreamPop v2** | YuE2-3B | 1,000 steps | `sv_dreampop` | [dreampop_sv_dreampop.safetensors](https://huggingface.co/atomtanstudio/lora-library/resolve/main/yue2/dreampop/dreampop_sv_dreampop.safetensors?download=true) |
+| **Old School Hip-Hop** | YuE2-3B | 800-step checkpoint | `sv_oldschoolhiphop` | [sv_oldschoolhiphop.safetensors](https://huggingface.co/atomtanstudio/lora-library/resolve/main/yue2/oldschoolhiphop/sv_oldschoolhiphop.safetensors?download=true) |
 
 ## DreamPop v2
 
@@ -34,9 +36,9 @@ This is an adapter, not a standalone music model. Download and install the base
 
 Use **`sv_dreampop`** in the style prompt. For example:
 
-```text
+~~~text
 sv_dreampop, dream pop, shimmering guitars, soft vocals, spacious reverb, steady mid-tempo drums
-```
+~~~
 
 | Setting | Starting value |
 | --- | --- |
@@ -86,29 +88,97 @@ These are training and file-integrity checks, not a held-out quality benchmark.
 
 ### Checksum
 
-```text
+~~~text
 617852d379c66b0407879421a353233d29cda8188cca82973a94c61b512ca03d  dreampop_sv_dreampop.safetensors
-```
+~~~
+
+Also available in [SHA256SUMS](https://huggingface.co/atomtanstudio/lora-library/blob/main/SHA256SUMS).
+
+## Old School Hip-Hop
+
+Old School Hip-Hop was trained on **90 recordings across 18 artists** from the Sound & Vision library, with the dataset selected to cover late-1980s and early-1990s boom-bap, sample-driven production, varied regional styles, and rhythmic rap delivery. It uses the FL YuE2 `native_joint_v1` training recipe and trains both the autoregressive (AR) and acoustic (NAR) components of YuE2. This release contains the **800-step checkpoint** for testing; it is not an independently established best checkpoint.
+
+This is an adapter, not a standalone music model. Download and install the base model separately: [m-a-p/YuE2-3B](https://huggingface.co/m-a-p/YuE2-3B).
+
+### Trigger and starting settings
+
+Use **`sv_oldschoolhiphop`** in the style prompt. For example:
+
+~~~text
+sv_oldschoolhiphop, old-school hip-hop, boom-bap drums, dusty samples, swung hi-hats, warm bass, chopped soul and jazz textures, muted Rhodes, horn stabs, vinyl crackle, confident rhythmic rap delivery
+~~~
+
+| Setting | Starting value |
+| --- | --- |
+| LoRA strength | `1.0` |
+| Symbolic planning / CoT | `off` |
+| Guidance / CFG | `1.0` |
+| Acoustic synthesis steps | `32` |
+| Inference engine | Native YuE2 BF16 |
+
+Use your own lyrics and adjust the musical description for the song. These settings are a starting point, not a claim that one setting or checkpoint is best for every prompt.
+
+### Install in Sound & Vision
+
+Use [Sound & Vision](https://github.com/atomtanstudio/sound-and-vision) with support for native YuE2 LoRA exports.
+
+1. Download the checkpoint above and the accompanying [lora.json](https://huggingface.co/atomtanstudio/lora-library/resolve/main/yue2/oldschoolhiphop/lora.json?download=true).
+2. Place both files on the computer running the backend, under `<app>/loras/styles/OldSchoolHipHop/`.
+3. Refresh the app or rescan the LoRA folder, then select **Old School Hip-Hop** and **Step 800** under **Trained styles & artists**.
+4. Start with strength `1.0`. Sound & Vision reads the trigger and generation defaults from the sidecar and checkpoint metadata.
+
+If `SOUND_VISION_LORAS` points to a custom directory, use that directory instead of `<app>/loras`.
+
+### Format and compatibility
+
+The uploaded file uses **`sound-vision-yue2-native-export-v1`**. It combines the original AR and NAR adapter pair into fused projections while preserving their tensor values and scaling. Both learned components are included; Sound & Vision does not need a second adapter file for this release.
+
+This is a custom YuE2 adapter layout. The `.safetensors` extension alone does not establish compatibility with other loaders. Direct loading in generic ComfyUI, Diffusers, or PEFT loaders has not been verified. FL YuE2 workflows that expect separate AR and NAR files need the original pair or an appropriate conversion; do not supply this combined file as either member of that pair.
+
+### Training and verification
+
+| Property | Value |
+| --- | --- |
+| Base-model revision | `1a96eca688d6ae5d7f0feb88573fec89920fcd19` |
+| Training recipe | FL YuE2 `native_joint_v1` |
+| Training steps | 1,000 |
+| Released checkpoint | 800 |
+| LoRA rank | 32 |
+| Learning rate | `0.0001`, constant |
+| Dataset | 90 recordings across 18 artists |
+| Components | AR and NAR |
+| File size | 234,969,032 bytes, approximately 235 MB |
+
+The local checkpoint was verified against the SHA-256 digest shown below after the user-selected rename. These are training and file-integrity checks, not a held-out quality benchmark. Results vary with lyrics, prompt, seed, and runtime.
+
+### Checksum
+
+~~~text
+ca176909d55998d4f78426439885ff79cc96ba4daaaaea22a9936590d6e72694  sv_oldschoolhiphop.safetensors
+~~~
 
 Also available in [SHA256SUMS](https://huggingface.co/atomtanstudio/lora-library/blob/main/SHA256SUMS).
 
 ## Library layout
 
-```text
+~~~text
 README.md
 SHA256SUMS
 yue2/
   dreampop/
     dreampop_sv_dreampop.safetensors
     lora.json
-```
+  oldschoolhiphop/
+    sv_oldschoolhiphop.safetensors
+    lora.json
+~~~
 
 New entries will be listed in the table above and stored in their own model/style folders within this repository. Check each entry's base model, loader requirements, and license before use.
 
 ## License and credits
 
-The DreamPop adapter is shared under **CC BY-NC 4.0**, with the underlying YuE2 model terms applying. See the [CC BY-NC 4.0 license](https://creativecommons.org/licenses/by-nc/4.0/) and the [YuE2 model-weight license](https://github.com/multimodal-art-projection/YuE/blob/main/MODEL_LICENSE).
+The DreamPop and Old School Hip-Hop adapters are shared under **CC BY-NC 4.0**, with the underlying YuE2 model terms applying. See the [CC BY-NC 4.0 license](https://creativecommons.org/licenses/by-nc/4.0/) and the [YuE2 model-weight license](https://github.com/multimodal-art-projection/YuE/blob/main/MODEL_LICENSE).
 
 YuE2's September 16, 2026 additional permission allows individuals to generate and monetize outputs subject to its stated conditions. That permission does not extend to commercial redistribution or sale of the model weights. It also does not grant rights in third-party material used as inputs or outputs.
 
-Base model and inference research: **YuE2 authors / Multimodal Art Projection**. Adapter training and Sound & Vision packaging: **Atomtan Studio**, using FL YuE2 tooling. This is a community adapter, not an official YuE2 release or an endorsement by the base-model authors or recording artists. Training recordings are not included in this repository.
+Base model and inference research: **YuE2 authors / Multimodal Art Projection**. Adapter training and Sound & Vision packaging: **Atomtan Studio**, using FL YuE2 tooling. This is a community adapter, not an official YuE2 release or an endorsement by the base-model authors or recording artists. Training recordings are not included in this repository.