docs: upstream-first KV-cache guidance (q8_0/q4_0, mainline Hadamard rotation); fork demoted to experimental
Browse files
README.md
CHANGED
|
@@ -17,6 +17,23 @@ tags:
|
|
| 17 |
- 8-bit
|
| 18 |
---
|
| 19 |
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
| 20 |
# Voxtral-4B-TTS-2603-RotorQuant-MLX-8bit
|
| 21 |
|
| 22 |
8-bit MLX weight-quantized build of [`mistralai/Voxtral-4B-TTS-2603`](https://huggingface.co/mistralai/Voxtral-4B-TTS-2603) with a RotorQuant KV-cache profile. Highest-fidelity MLX TTS variant — preferred when batches mix voices or languages.
|
|
|
|
| 17 |
- 8-bit
|
| 18 |
---
|
| 19 |
|
| 20 |
+
> [!TIP]
|
| 21 |
+
> **KV-cache quantization without any fork (recommended, 2026):** upstream
|
| 22 |
+
> llama.cpp/Ollama now cover this natively — use `-ctk q8_0 -ctv q8_0`
|
| 23 |
+
> (~half KV memory, negligible quality loss: perplexity +0.002–0.05) or
|
| 24 |
+
> `-ctk q4_0 -ctv q4_0` (~quarter memory, ≈7.6% perplexity increase). In
|
| 25 |
+
> Ollama: `OLLAMA_KV_CACHE_TYPE=q8_0` with `OLLAMA_FLASH_ATTENTION=1`. Keep
|
| 26 |
+
> K and V types symmetric to stay on the fast fused Flash-Attention path.
|
| 27 |
+
> Since April 2026, mainline llama.cpp also applies Hadamard rotation to
|
| 28 |
+
> KV activations ([PR #21038](https://github.com/ggml-org/llama.cpp/pull/21038)),
|
| 29 |
+
> which greatly improves low-bit KV quality (opt-out:
|
| 30 |
+
> `LLAMA_ATTN_ROT_DISABLE=1`).
|
| 31 |
+
>
|
| 32 |
+
> The RotorQuant/TurboQuant fork flow below is **experimental/legacy**: the
|
| 33 |
+
> TurboQuant llama.cpp PR was closed without merging (June 2026) and the fork
|
| 34 |
+
> is unmaintained relative to mainline. It is NOT required to use this model.
|
| 35 |
+
<!-- kv-upstream-note -->
|
| 36 |
+
|
| 37 |
# Voxtral-4B-TTS-2603-RotorQuant-MLX-8bit
|
| 38 |
|
| 39 |
8-bit MLX weight-quantized build of [`mistralai/Voxtral-4B-TTS-2603`](https://huggingface.co/mistralai/Voxtral-4B-TTS-2603) with a RotorQuant KV-cache profile. Highest-fidelity MLX TTS variant — preferred when batches mix voices or languages.
|