Add MuLaCover F16 and Q8 GGUF packages
Browse files- .gitattributes +2 -0
- MuLaCover-GGUF/MODEL_LICENSE +64 -0
- MuLaCover-GGUF/README.md +83 -0
- MuLaCover-GGUF/mulacover-f16.gguf +3 -0
- MuLaCover-GGUF/mulacover-q8_0.gguf +3 -0
.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
|