Instructions to use hans00/Chatterbox-TTS-GGUF with libraries, inference providers, notebooks, and local apps. Follow these links to get started.
- Libraries
- Chatterbox
How to use hans00/Chatterbox-TTS-GGUF with Chatterbox:
# pip install chatterbox-tts import torchaudio as ta from chatterbox.tts import ChatterboxTTS model = ChatterboxTTS.from_pretrained(device="cuda") text = "Ezreal and Jinx teamed up with Ahri, Yasuo, and Teemo to take down the enemy's Nexus in an epic late-game pentakill." wav = model.generate(text) ta.save("test-1.wav", wav, model.sr) # If you want to synthesize with a different voice, specify the audio prompt AUDIO_PROMPT_PATH="YOUR_FILE.wav" wav = model.generate(text, audio_prompt_path=AUDIO_PROMPT_PATH) ta.save("test-2.wav", wav, model.sr) - Notebooks
- Google Colab
- Kaggle
Initial Chatterbox-TTS GGUF release
Browse files- .gitattributes +11 -0
- README.md +84 -0
- codec-f16.gguf +3 -0
- codec-f32.gguf +3 -0
- codec-q4_k_m.gguf +3 -0
- codec-q5_k_m.gguf +3 -0
- codec-q8_0.gguf +3 -0
- s3t.gguf +3 -0
- t3-f16.gguf +3 -0
- t3-f32.gguf +3 -0
- t3-q4_k_m.gguf +3 -0
- t3-q5_k_m.gguf +3 -0
- t3-q8_0.gguf +3 -0
.gitattributes
CHANGED
|
@@ -33,3 +33,14 @@ saved_model/**/* filter=lfs diff=lfs merge=lfs -text
|
|
| 33 |
*.zip filter=lfs diff=lfs merge=lfs -text
|
| 34 |
*.zst filter=lfs diff=lfs merge=lfs -text
|
| 35 |
*tfevents* filter=lfs diff=lfs merge=lfs -text
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
| 33 |
*.zip filter=lfs diff=lfs merge=lfs -text
|
| 34 |
*.zst filter=lfs diff=lfs merge=lfs -text
|
| 35 |
*tfevents* filter=lfs diff=lfs merge=lfs -text
|
| 36 |
+
codec-f16.gguf filter=lfs diff=lfs merge=lfs -text
|
| 37 |
+
codec-f32.gguf filter=lfs diff=lfs merge=lfs -text
|
| 38 |
+
codec-q4_k_m.gguf filter=lfs diff=lfs merge=lfs -text
|
| 39 |
+
codec-q5_k_m.gguf filter=lfs diff=lfs merge=lfs -text
|
| 40 |
+
codec-q8_0.gguf filter=lfs diff=lfs merge=lfs -text
|
| 41 |
+
s3t.gguf filter=lfs diff=lfs merge=lfs -text
|
| 42 |
+
t3-f16.gguf filter=lfs diff=lfs merge=lfs -text
|
| 43 |
+
t3-f32.gguf filter=lfs diff=lfs merge=lfs -text
|
| 44 |
+
t3-q4_k_m.gguf filter=lfs diff=lfs merge=lfs -text
|
| 45 |
+
t3-q5_k_m.gguf filter=lfs diff=lfs merge=lfs -text
|
| 46 |
+
t3-q8_0.gguf filter=lfs diff=lfs merge=lfs -text
|
README.md
ADDED
|
@@ -0,0 +1,84 @@
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
| 1 |
+
---
|
| 2 |
+
license: mit
|
| 3 |
+
language:
|
| 4 |
+
- en
|
| 5 |
+
tags:
|
| 6 |
+
- gguf
|
| 7 |
+
- tts
|
| 8 |
+
- chatterbox
|
| 9 |
+
- text-to-speech
|
| 10 |
+
base_model: ResembleAI/chatterbox
|
| 11 |
+
---
|
| 12 |
+
|
| 13 |
+
# Chatterbox-TTS GGUF
|
| 14 |
+
|
| 15 |
+
GGUF conversions of [Resemble AI's Chatterbox-TTS](https://huggingface.co/ResembleAI/chatterbox).
|
| 16 |
+
|
| 17 |
+
The Chatterbox stack is split into two halves so each can run inside the
|
| 18 |
+
runtime that owns it:
|
| 19 |
+
|
| 20 |
+
- **LLM-part (T3)** — text + conditioning to discrete speech token IDs,
|
| 21 |
+
run by a `chatterbox_t3`-aware llama.cpp build.
|
| 22 |
+
- **Codec-part (S3G / S3T)** — discrete speech tokens to/from 24 kHz
|
| 23 |
+
PCM, run by [codec.cpp](https://github.com/mybigday/codec.cpp).
|
| 24 |
+
|
| 25 |
+
Only payload speech token IDs (`0..6560`) cross the boundary between the
|
| 26 |
+
two runtimes.
|
| 27 |
+
|
| 28 |
+
## Files
|
| 29 |
+
|
| 30 |
+
### LLM-part (T3, `t3_cfg.safetensors`)
|
| 31 |
+
|
| 32 |
+
`t3-<quant>.gguf` — 30-layer, hidden 1024, MLP 4096 Llama-style backbone
|
| 33 |
+
plus T3-specific embeddings, heads, positional embeddings, and the
|
| 34 |
+
conditioning encoder (perceiver / speaker / emotion). Architecture:
|
| 35 |
+
`chatterbox_t3`.
|
| 36 |
+
|
| 37 |
+
| File | Size |
|
| 38 |
+
| ----------------- | ------- |
|
| 39 |
+
| `t3-f32.gguf` | 2031 MB |
|
| 40 |
+
| `t3-f16.gguf` | 1016 MB |
|
| 41 |
+
| `t3-q8_0.gguf` | 540 MB |
|
| 42 |
+
| `t3-q5_k_m.gguf` | 349 MB |
|
| 43 |
+
| `t3-q4_k_m.gguf` | 286 MB |
|
| 44 |
+
|
| 45 |
+
### Codec-part (S3G, `s3gen.safetensors`)
|
| 46 |
+
|
| 47 |
+
`codec[-<quant>].gguf` — Chatterbox S3Gen flow-matching decoder + HiFi-GAN
|
| 48 |
+
vocoder. Architecture: `chatterbox_s3g`. Built-in conditioning (`conds.pt`)
|
| 49 |
+
is baked in.
|
| 50 |
+
|
| 51 |
+
| File | Size |
|
| 52 |
+
| ------------------- | ------- |
|
| 53 |
+
| `codec-f32.gguf` | 535 MB |
|
| 54 |
+
| `codec-f16.gguf` | 268 MB |
|
| 55 |
+
| `codec-q8_0.gguf` | 196 MB |
|
| 56 |
+
| `codec-q5_k_m.gguf` | 167 MB |
|
| 57 |
+
| `codec-q4_k_m.gguf` | 158 MB |
|
| 58 |
+
|
| 59 |
+
### Codec-part (S3T, `s3gen.safetensors[tokenizer.*]`)
|
| 60 |
+
|
| 61 |
+
`s3t.gguf` — S3 audio tokenizer (24 kHz mel front-end, 16 kHz token rate
|
| 62 |
+
25 Hz, codebook 6561). Architecture: `chatterbox_s3t`. Only needed for
|
| 63 |
+
voice-cloning / reference-token paths; F16 only because most weights are
|
| 64 |
+
already small.
|
| 65 |
+
|
| 66 |
+
## Boundary contract
|
| 67 |
+
|
| 68 |
+
- token rate: 25 Hz
|
| 69 |
+
- codebook size: 6561 (payload IDs `0..6560`)
|
| 70 |
+
- `n_q = 1`
|
| 71 |
+
- encode sample rate: 16 kHz, decode sample rate: 24 kHz
|
| 72 |
+
- `start_speech_token = 6561`, `stop_speech_token = 6562`
|
| 73 |
+
|
| 74 |
+
## Notes
|
| 75 |
+
|
| 76 |
+
- Quantization (`Q8_0`, `Q5_K_M`, `Q4_K_M`) is applied to 2-D `.weight`
|
| 77 |
+
tensors whose last dimension is divisible by the quant block size (32
|
| 78 |
+
for Q8, 256 for K-quants); norms, biases, and small tensors stay F16.
|
| 79 |
+
- Source weights: `t3_cfg.safetensors` (T3 base config) and
|
| 80 |
+
`s3gen.safetensors` from `ResembleAI/chatterbox`. Multilingual T3
|
| 81 |
+
variants (`t3_23lang`, `t3_mtl23ls_v2/v3`) are not converted here.
|
| 82 |
+
- llama.cpp does not yet support the `chatterbox_t3` architecture
|
| 83 |
+
upstream; the T3 GGUFs are forward-compatible with that future runtime
|
| 84 |
+
and otherwise consumable by tooling that reads GGUF metadata/weights.
|
codec-f16.gguf
ADDED
|
@@ -0,0 +1,3 @@
|
|
|
|
|
|
|
|
|
|
|
|
|
| 1 |
+
version https://git-lfs.github.com/spec/v1
|
| 2 |
+
oid sha256:8382d0cd5eddcdf454415ff6a804aa624dd480c80102d3693db9bd9e91e09050
|
| 3 |
+
size 280878048
|
codec-f32.gguf
ADDED
|
@@ -0,0 +1,3 @@
|
|
|
|
|
|
|
|
|
|
|
|
|
| 1 |
+
version https://git-lfs.github.com/spec/v1
|
| 2 |
+
oid sha256:069c9ad0e42dea31090753bf54f50cae9dd38337f526da20ff8294ab265b9f94
|
| 3 |
+
size 561480800
|
codec-q4_k_m.gguf
ADDED
|
@@ -0,0 +1,3 @@
|
|
|
|
|
|
|
|
|
|
|
|
|
| 1 |
+
version https://git-lfs.github.com/spec/v1
|
| 2 |
+
oid sha256:0ada4835a7fda716307fedb23fba6fe795a55693abc8951f19a754377b07a454
|
| 3 |
+
size 165200928
|
codec-q5_k_m.gguf
ADDED
|
@@ -0,0 +1,3 @@
|
|
|
|
|
|
|
|
|
|
|
|
|
| 1 |
+
version https://git-lfs.github.com/spec/v1
|
| 2 |
+
oid sha256:9e0ab68a6c8ac9278c1c0b9b86ff4edacb7126330767fd6368f72ada07f08a2b
|
| 3 |
+
size 175259808
|
codec-q8_0.gguf
ADDED
|
@@ -0,0 +1,3 @@
|
|
|
|
|
|
|
|
|
|
|
|
|
| 1 |
+
version https://git-lfs.github.com/spec/v1
|
| 2 |
+
oid sha256:3992234e8d3071e8f79911900bc53a1a2a96aa1ac41496eb3d91131911896ac6
|
| 3 |
+
size 205114848
|
s3t.gguf
ADDED
|
@@ -0,0 +1,3 @@
|
|
|
|
|
|
|
|
|
|
|
|
|
| 1 |
+
version https://git-lfs.github.com/spec/v1
|
| 2 |
+
oid sha256:26592ce171dd40bb54468a32dd9a3b697e15bfc23ebc8f8d218e34c3962e69c4
|
| 3 |
+
size 247487280
|
t3-f16.gguf
ADDED
|
@@ -0,0 +1,3 @@
|
|
|
|
|
|
|
|
|
|
|
|
|
| 1 |
+
version https://git-lfs.github.com/spec/v1
|
| 2 |
+
oid sha256:ba91576bc71065b8a9af656b03f7754dd847387f6e792080c9eb5215a151c929
|
| 3 |
+
size 1064828992
|
t3-f32.gguf
ADDED
|
@@ -0,0 +1,3 @@
|
|
|
|
|
|
|
|
|
|
|
|
|
| 1 |
+
version https://git-lfs.github.com/spec/v1
|
| 2 |
+
oid sha256:e551adae11ec294c2f75be6cf2b2450e633e0b73fe838c0ab0b56c3cd7dd8cd2
|
| 3 |
+
size 2129639488
|
t3-q4_k_m.gguf
ADDED
|
@@ -0,0 +1,3 @@
|
|
|
|
|
|
|
|
|
|
|
|
|
| 1 |
+
version https://git-lfs.github.com/spec/v1
|
| 2 |
+
oid sha256:93180910778985f557e11c7da12e93dc3509fd3f414e80b23de6415866c215a8
|
| 3 |
+
size 299645120
|
t3-q5_k_m.gguf
ADDED
|
@@ -0,0 +1,3 @@
|
|
|
|
|
|
|
|
|
|
|
|
|
| 1 |
+
version https://git-lfs.github.com/spec/v1
|
| 2 |
+
oid sha256:3b164d7639bc1f016728a0bac3d0be68524e46a4b3e72c6efd688b3bc22b4653
|
| 3 |
+
size 366182848
|
t3-q8_0.gguf
ADDED
|
@@ -0,0 +1,3 @@
|
|
|
|
|
|
|
|
|
|
|
|
|
| 1 |
+
version https://git-lfs.github.com/spec/v1
|
| 2 |
+
oid sha256:4f898d5b403f29cb7c9008ef9f828106c156039228763eaa12edfe6a12df5f2c
|
| 3 |
+
size 565796032
|