audio-cpp commited on
Commit
57de533
·
verified ·
1 Parent(s): fd2fe4c

Add MuLaCover F16 and Q8 GGUF packages

Browse files
.gitattributes CHANGED
@@ -266,3 +266,5 @@ PocketTTS-Small-GGUF/english-2m/english-2m-f32.gguf filter=lfs diff=lfs merge=lf
266
  PocketTTS-Small-GGUF/english-2m-refl/english-2m-refl-f32.gguf filter=lfs diff=lfs merge=lfs -text
267
  PocketTTS-Small-GGUF/english-7m/english-7m-f32.gguf filter=lfs diff=lfs merge=lfs -text
268
  PocketTTS-Small-GGUF/english-7m-refl/english-7m-refl-f32.gguf filter=lfs diff=lfs merge=lfs -text
 
 
 
266
  PocketTTS-Small-GGUF/english-2m-refl/english-2m-refl-f32.gguf filter=lfs diff=lfs merge=lfs -text
267
  PocketTTS-Small-GGUF/english-7m/english-7m-f32.gguf filter=lfs diff=lfs merge=lfs -text
268
  PocketTTS-Small-GGUF/english-7m-refl/english-7m-refl-f32.gguf filter=lfs diff=lfs merge=lfs -text
269
+ MuLaCover-GGUF/mulacover-f16.gguf filter=lfs diff=lfs merge=lfs -text
270
+ MuLaCover-GGUF/mulacover-q8_0.gguf filter=lfs diff=lfs merge=lfs -text
MuLaCover-GGUF/MODEL_LICENSE ADDED
@@ -0,0 +1,64 @@
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
1
+ MuLaCover Model Weight and Output Terms
2
+
3
+ Copyright (c) 2026 MuLa Labs. All rights reserved except as expressly granted
4
+ below.
5
+
6
+ 1. Scope
7
+
8
+ These terms apply to all MuLaCover checkpoint weights distributed by MuLa
9
+ Labs, including the MuLaCover-oss model weights and any fine-tuned, converted,
10
+ quantized, merged, or otherwise modified versions derived from those weights
11
+ (collectively, the "Model Weights"). They do not replace the licenses that
12
+ apply to MuLaCover source code or third-party components.
13
+
14
+ 2. Model Weight License
15
+
16
+ The Model Weights are licensed under the Creative Commons
17
+ Attribution-NonCommercial 4.0 International license (CC BY-NC 4.0):
18
+
19
+ https://creativecommons.org/licenses/by-nc/4.0/legalcode
20
+
21
+ You may copy, share, and adapt the Model Weights only for noncommercial
22
+ purposes and only in compliance with CC BY-NC 4.0, including its attribution
23
+ requirements. Attribute the Model Weights as "MuLaCover by MuLa Labs" and
24
+ include a link to the official MuLaCover repository:
25
+
26
+ https://github.com/HeartMuLa/MuLaCover
27
+
28
+ 3. Generated Output Restriction
29
+
30
+ In addition to the Model Weight License, and as a condition of accessing or
31
+ using the Model Weights, you may use outputs generated with the Model Weights
32
+ only for noncommercial purposes. "Outputs" include generated or transformed
33
+ audio, music, MIDI, tokens, latent representations, and other material produced
34
+ through use of the Model Weights.
35
+
36
+ Without a separate written commercial license from MuLa Labs, you may not sell,
37
+ license for a fee, monetize, commercially distribute, commercially publish, use
38
+ in advertising, use in a paid product or service, or otherwise exploit Outputs
39
+ for commercial advantage or monetary compensation.
40
+
41
+ These output terms are separate terms governing use of Outputs and access to
42
+ the Model Weights. They do not modify the text of CC BY-NC 4.0. They apply only
43
+ to the extent MuLa Labs has rights or contractual authority to impose them and
44
+ do not limit rights that cannot lawfully be restricted.
45
+
46
+ 4. Commercial Licensing
47
+
48
+ Commercial use of the Model Weights or Outputs requires a separate written
49
+ license from MuLa Labs. Contact MuLa Labs through the official repository for
50
+ commercial licensing inquiries.
51
+
52
+ 5. Third-Party Rights and User Responsibility
53
+
54
+ These terms grant no rights in third-party source recordings, compositions,
55
+ lyrics, performances, datasets, trademarks, or other material. You are solely
56
+ responsible for obtaining all permissions required for your inputs and Outputs
57
+ and for complying with applicable law. Third-party components remain subject
58
+ to their respective licenses and notices.
59
+
60
+ 6. Disclaimer
61
+
62
+ TO THE EXTENT PERMITTED BY LAW, THE MODEL WEIGHTS AND OUTPUTS ARE PROVIDED
63
+ "AS IS", WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND. MULA LABS WILL NOT BE
64
+ LIABLE FOR CLAIMS, DAMAGES, OR OTHER LIABILITY ARISING FROM THEIR USE.
MuLaCover-GGUF/README.md ADDED
@@ -0,0 +1,83 @@
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
1
+ ---
2
+ library_name: audio.cpp
3
+ license: cc-by-nc-4.0
4
+ base_model:
5
+ - HeartMuLa/MuLaCover
6
+ - Qwen/Qwen3-Embedding-0.6B
7
+ - HeartMuLa/HeartCodec-oss-20260123
8
+ tags:
9
+ - audio.cpp
10
+ - gguf
11
+ - music
12
+ - text-to-audio
13
+ - audio-to-audio
14
+ ---
15
+
16
+ # MuLaCover GGUF
17
+
18
+ Follow or star [audio.cpp](https://github.com/0xShug0/audio.cpp) for the native inference implementation.
19
+
20
+ MuLaCover generates cover songs from reference audio or melody/chord MIDI, with
21
+ new lyrics and style conditioning. These packages contain the complete pipeline:
22
+ MuLaCover, the Qwen3 style encoder, HeartCodec, YourMT3, and five ChordNet folds.
23
+
24
+ The base checkpoint is pinned to
25
+ [HeartMuLa/MuLaCover at bbbaef2b31835c2ef5172ff528dbe325230d46fb](https://huggingface.co/HeartMuLa/MuLaCover/tree/bbbaef2b31835c2ef5172ff528dbe325230d46fb).
26
+ The reference implementation is
27
+ [HeartMuLa/MuLaCover at e27fa7fa0da7c9817879cc6210cc5693f9327946](https://github.com/HeartMuLa/MuLaCover/tree/e27fa7fa0da7c9817879cc6210cc5693f9327946).
28
+
29
+ > [!IMPORTANT]
30
+ > Upstream restricts the model weights and generated outputs to noncommercial use.
31
+ > Read [MODEL_LICENSE](MODEL_LICENSE). The Apache-2.0 code license does not grant
32
+ > commercial rights to the weights or generated audio.
33
+
34
+ ## Packages
35
+
36
+ | File | Storage |
37
+ |---|---|
38
+ | `mulacover-f16.gguf` | FP16 floating weights, FP32 vector parameters |
39
+ | `mulacover-q8_0.gguf` | Q8 eligible matrix weights across components, FP16 convolutions and lookup tables, FP32 vector parameters |
40
+
41
+ Both files embed the model contract, configuration, tokenizers and chord vocabulary.
42
+ Use the `mulacover` family. Generation is offline; progress through audio frames
43
+ is not a streaming waveform API.
44
+
45
+ ## Download
46
+
47
+ ```bash
48
+ hf download audio-cpp/audio.cpp-gguf \
49
+ --include "MuLaCover-GGUF/*" --local-dir models
50
+ ```
51
+
52
+ ## Generate from MIDI
53
+
54
+ ```bash
55
+ audiocpp_cli --task gen --family mulacover \
56
+ --model models/MuLaCover-GGUF/mulacover-q8_0.gguf --backend cuda \
57
+ --text '[Verse] A morning light across the sea. [Chorus] Keep a little hope for me.' \
58
+ --request-option 'tags=topic:[hope]; genre:[folk]; instrument:[piano]; mood:[warm]' \
59
+ --request-option melody_file=melody.mid \
60
+ --request-option chord_file=chord.mid \
61
+ --request-option seed=1234 --out cover.wav --log
62
+ ```
63
+
64
+ Add `--request-option drum_file=drums.mid` for drum conditioning. MIDI timing
65
+ uses musical ticks; its tempo is not a separate target-tempo control.
66
+
67
+ ## Generate from reference audio
68
+
69
+ ```bash
70
+ audiocpp_cli --task gen --family mulacover \
71
+ --model models/MuLaCover-GGUF/mulacover-q8_0.gguf --backend cuda --audio reference.wav \
72
+ --text '[Verse] A morning light across the sea. [Chorus] Keep a little hope for me.' \
73
+ --request-option 'tags=topic:[hope]; genre:[folk]; instrument:[piano]; mood:[warm]' \
74
+ --request-option seed=1234 --out cover.wav --log
75
+ ```
76
+
77
+ Tempo is estimated automatically. Set `--request-option bpm=120` to supply the
78
+ reference tempo explicitly. Reference audio and MIDI inputs are mutually exclusive.
79
+ Upstream selects the transcribed lead-singing track as melody; input without a
80
+ detected melody is rejected. Reference-audio preprocessing requires SOXR support.
81
+
82
+ `duration_sec` defaults to a 300-second maximum generation budget. The model can
83
+ stop earlier at EOS. The prompt and frame budget must fit the 8,192-token context.
MuLaCover-GGUF/mulacover-f16.gguf ADDED
@@ -0,0 +1,3 @@
 
 
 
 
1
+ version https://git-lfs.github.com/spec/v1
2
+ oid sha256:5a73ce63ab2c4b8a9bd606d40ccf83f95ed68ecc8ac2c6210e45cf2dc56e3b57
3
+ size 13380996416
MuLaCover-GGUF/mulacover-q8_0.gguf ADDED
@@ -0,0 +1,3 @@
 
 
 
 
1
+ version https://git-lfs.github.com/spec/v1
2
+ oid sha256:5daca50ce959c63dcfef3be1e3a7cd855eee753a91cab1a3475da1af781e4518
3
+ size 8220378496