Update Yue2 README demos

README.md

@@ -29,10 +29,112 @@ testing, validation, and optimization. Star our repo so you don’t miss any imp
 | `sidecars/yue2-generation-config.json` | Yue2 generation defaults. |
 | `sidecars/yue2-qwen.tiktoken` | Qwen tokenizer used by Yue2. |
 | `sidecars/yue2-vae-config.json` | Yue2 VAE config. |
-| `examples/tonight-awake-audiocpp-current.wav` | audio.cpp output from the official `tonight-awake` example. |
+| `examples/demo1.wav` | Direct text-to-music demo, `cot=off`. |
+| `examples/demo2.wav` | Full planning demo, `cot=full`. |
+| `examples/demo3.wav` | Melody-conditioned cover demo, `cot=melody`. |
+| `examples/demo4.wav` | Full score-conditioned demo, `cot=full`. |
 
-The example WAV was generated using audio.cpp from the official Yue2 example:
-[`examples/tonight-awake.json`](https://huggingface.co/m-a-p/YuE2-3B/blob/main/examples/tonight-awake.json).
+## Demos
+
+The demos below were generated with `yue2-3b-bf16.gguf` and `yue2-vae-f32.gguf`.
+Replace `<AUDIOCPP>` with your audio.cpp checkout and `<YUE2_GGUF>` with this
+downloaded GGUF repo directory.
+
+### Demo 1: direct generation
+
+<audio controls src="examples/demo1.wav"></audio>
+
+```bash
+<AUDIOCPP>/build/debug/bin/audiocpp_cli \
+  --task gen \
+  --family yue2 \
+  --model <YUE2_GGUF> \
+  --backend cuda \
+  --threads 8 \
+  --text $'[Verse]\nSoft morning light is touching the window.\nI hear the city waking below.\n[Chorus]\nStay with the rhythm, let it carry us home.\nSing with the sunrise, we are never alone.' \
+  --request-option 'style=English, indie pop, bright acoustic guitar, soft drums, warm lead vocal, polished demo mix' \
+  --request-option cot=off \
+  --request-option seed=20260920 \
+  --request-option num_inference_steps=8 \
+  --session-option yue2.model_gguf=yue2-3b-bf16.gguf \
+  --session-option yue2.vae_gguf=yue2-vae-f32.gguf \
+  --out demo1.wav \
+  --log
+```
+
+### Demo 2: full planning
+
+<audio controls src="examples/demo2.wav"></audio>
+
+```bash
+<AUDIOCPP>/build/debug/bin/audiocpp_cli \
+  --task gen \
+  --family yue2 \
+  --model <YUE2_GGUF> \
+  --backend cuda \
+  --threads 8 \
+  --text $'[Verse]\nA quiet piano opens the evening.\nWarm city lights are starting to glow.\n[Chorus]\nLift every voice into the skyline.\nLet the melody carry us home.' \
+  --request-option 'style=English, piano pop, clear lead vocal, gentle bass, soft drums, warm chorus harmonies' \
+  --request-option cot=full \
+  --request-option seed=20260921 \
+  --request-option num_inference_steps=8 \
+  --session-option yue2.model_gguf=yue2-3b-bf16.gguf \
+  --session-option yue2.vae_gguf=yue2-vae-f32.gguf \
+  --out demo2.wav \
+  --log
+```
+
+### Demo 3: melody-conditioned cover
+
+<audio controls src="examples/demo3.wav"></audio>
+
+This demo uses the upstream
+[`examples/melody.abc`](https://huggingface.co/m-a-p/YuE2-3B/blob/main/examples/melody.abc).
+
+```bash
+<AUDIOCPP>/build/debug/bin/audiocpp_cli \
+  --task gen \
+  --family yue2 \
+  --model <YUE2_GGUF> \
+  --backend cuda \
+  --threads 8 \
+  --text $'[Verse]\nWe follow the melody line.\nThe rhythm keeps everything fine.\n[Chorus]\nHold that shape and make it new.\nChange the color, keep the view.' \
+  --request-option 'style=English, jazz funk cover, warm Rhodes, round bass, light drums, relaxed vocal, clean live band feel' \
+  --request-option cot=melody \
+  --request-option abc_file=<AUDIOCPP>/reference/YuE/examples/melody.abc \
+  --request-option seed=20260922 \
+  --request-option num_inference_steps=8 \
+  --session-option yue2.model_gguf=yue2-3b-bf16.gguf \
+  --session-option yue2.vae_gguf=yue2-vae-f32.gguf \
+  --out demo3.wav \
+  --log
+```
+
+### Demo 4: full score conditioning
+
+<audio controls src="examples/demo4.wav"></audio>
+
+This demo uses the upstream
+[`examples/score-jazz.abc`](https://github.com/multimodal-art-projection/YuE/blob/main/examples/score-jazz.abc).
+
+```bash
+<AUDIOCPP>/build/debug/bin/audiocpp_cli \
+  --task gen \
+  --family yue2 \
+  --model <YUE2_GGUF> \
+  --backend cuda \
+  --threads 8 \
+  --text $'[Verse]\nThe room begins with a gentle phrase.\nThe harmony turns through a golden haze.\n[Chorus]\nHold the note and let it rise.\nMorning opens up the sky.' \
+  --request-option 'style=English, piano pop with jazz harmony, clear lead vocal, gentle bass, tasteful drum fills' \
+  --request-option cot=full \
+  --request-option abc_file=<AUDIOCPP>/reference/YuE/examples/score-jazz.abc \
+  --request-option seed=20260923 \
+  --request-option num_inference_steps=8 \
+  --session-option yue2.model_gguf=yue2-3b-bf16.gguf \
+  --session-option yue2.vae_gguf=yue2-vae-f32.gguf \
+  --out demo4.wav \
+  --log
+```
 
 ## Upstream