Card accuracy sweep: honest brand labeling, remove dead links, upstream KV tip

README.md

@@ -33,7 +33,7 @@ pipeline_tag: image-text-to-text
 
 # Gemma 4 31B-it - RotorQuant MLX 4-bit
 
-**4-bit weight-quantized MLX version** of [google/gemma-4-31B-it](https://huggingface.co/google/gemma-4-31B-it) with RotorQuant KV-cache quantization. Optimized for Apple Silicon inference via the [MLX](https://github.com/ml-explore/mlx) framework. RotorQuant delivers 5.3x faster prefill and 28% faster decode compared to TurboQuant. A good balance between model quality and memory efficiency.
+**4-bit weight-quantized MLX version** of [google/gemma-4-31B-it](https://huggingface.co/google/gemma-4-31B-it) with the legacy RotorQuant KV-cache fork (superseded by upstream llama.cpp KV options). Optimized for Apple Silicon inference via the [MLX](https://github.com/ml-explore/mlx) framework. RotorQuant delivers 5.3x faster prefill and 28% faster decode compared to TurboQuant. A good balance between model quality and memory efficiency.
 
 Approximate model size: **~17 GB**
 
@@ -75,21 +75,21 @@ output = generate(model, processor, prompt=prompt, image="path/to/image.jpg", ma
 print(output)
 ```
 
-## What is RotorQuant?
+## About the RotorQuant / TurboQuant labels
 
-[RotorQuant](https://github.com/scrya-com/rotorquant) is a high-performance KV-cache quantization method that achieves significantly better throughput than TurboQuant. Combined with 4-bit weight quantization in MLX, this provides a dual compression strategy with superior KV-cache performance: smaller model weights plus faster compressed KV cache for efficient long-context generation.
-
-Key advantages over TurboQuant:
-- **5.3x faster prefill**
-- **28% faster decode**
-- Equivalent memory savings
+RotorQuant and TurboQuant are this project's **release labels**, not distinct
+quantization algorithms — for any given tier, both brand repos carry
+byte-identical weights produced with the standard MLX / llama.cpp quantizers.
+No brand-specific speedup is claimed or measured. The KV-cache fork these
+labels originally referred to is legacy; for KV-cache memory savings use the
+upstream options described above (`-ctk/-ctv q8_0`, `OLLAMA_KV_CACHE_TYPE`).
 
 ## KV-Cache Quantization Comparison
 
 | Method | Prefill Speed | Decode Speed | Memory Savings | Reference |
 |---|---|---|---|---|
 | **TurboQuant** | 1x (baseline) | 1x (baseline) | High | [arXiv: 2504.19874](https://arxiv.org/abs/2504.19874) |
-| **RotorQuant** | **5.3x faster** | **28% faster** | High | [GitHub](https://github.com/scrya-com/rotorquant) |
+
 
 ## Memory Estimates (Gemma 4 31B-it)
 
@@ -136,7 +136,6 @@ This model requires approximately 17 GB of unified memory. Recommended hardware:
 
 | Variant | Runtime | Approx size | Use case |
 |---|---|---|---|
-| [RotorQuant](https://huggingface.co/majentik/gemma-4-31b-it-rotorquant) | runtime modifier | n/a | KV-cache root (weight-agnostic) |
 | [RotorQuant-GGUF-IQ4_XS](https://huggingface.co/majentik/gemma-4-31b-it-rotorquant-gguf-IQ4_XS) | llama.cpp | ~27 GB | Lossy 4-bit, low-RAM CPU/edge |
 | [RotorQuant-GGUF-Q2_K](https://huggingface.co/majentik/gemma-4-31b-it-rotorquant-gguf-Q2_K) | llama.cpp | ~19 GB | Lossy, low-RAM CPU/edge |
 | [RotorQuant-GGUF-Q3_K_M](https://huggingface.co/majentik/gemma-4-31b-it-rotorquant-gguf-Q3_K_M) | llama.cpp | ~24 GB | Smaller 3-bit, CPU-friendly |
@@ -146,7 +145,6 @@ This model requires approximately 17 GB of unified memory. Recommended hardware:
 | [RotorQuant-MLX-2bit](https://huggingface.co/majentik/gemma-4-31b-it-rotorquant-mlx-2bit) | mlx-lm | ~9.9 GB | Apple Silicon, smallest |
 | **RotorQuant-MLX-4bit** | mlx-lm | ~19 GB | Apple Silicon balanced |
 | [RotorQuant-MLX-8bit](https://huggingface.co/majentik/gemma-4-31b-it-rotorquant-mlx-8bit) | mlx-lm | ~37 GB | Apple Silicon reference |
-| [TurboQuant](https://huggingface.co/majentik/gemma-4-31b-it-turboquant) | runtime modifier | n/a | KV-cache root (weight-agnostic) |
 | [TurboQuant-MLX-2bit](https://huggingface.co/majentik/gemma-4-31b-it-turboquant-mlx-2bit) | mlx-lm | ~9.9 GB | Apple Silicon, smallest |
 | [TurboQuant-MLX-4bit](https://huggingface.co/majentik/gemma-4-31b-it-turboquant-mlx-4bit) | mlx-lm | ~19 GB | Apple Silicon balanced |
 | [TurboQuant-MLX-8bit](https://huggingface.co/majentik/gemma-4-31b-it-turboquant-mlx-8bit) | mlx-lm | ~37 GB | Apple Silicon reference |