majentik commited on
Commit
ccd31ec
·
verified ·
1 Parent(s): c993ccd

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

Browse files
Files changed (1) hide show
  1. README.md +8 -19
README.md CHANGED
@@ -131,23 +131,14 @@ OLLAMA_KV_CACHE_TYPE=q8_0 OLLAMA_FLASH_ATTENTION=1 ollama run majentik/Qwen3.6-3
131
  | Modalities | Text + Image + Video (multimodal) |
132
  | Compatible Runtimes | llama.cpp, LM Studio, Ollama, koboldcpp |
133
 
134
- ## What is RotorQuant?
135
 
136
- [RotorQuant](https://github.com/scrya-com/rotorquant) is a KV cache compression method based on Clifford algebra (Cl(3,0)) rotors. It was developed as a faster, more parameter-efficient alternative to Google's [TurboQuant](https://arxiv.org/abs/2504.19874) (ICLR 2026).
137
-
138
- Instead of applying a dense d×d random orthogonal rotation matrix (as TurboQuant does), RotorQuant uses lightweight block-diagonal rotations independent 2D/4D rotations per pair/quartet achieving O(d) complexity instead of O(d log d), fully parallelisable with no inter-element dependencies.
139
-
140
- **Benchmarks from the RotorQuant repository** (Llama 3.1 8B, RTX 5090 results will vary by model and hardware):
141
-
142
- | Metric | RotorQuant (iso3) | TurboQuant | Standard q4_0 |
143
- |--------|-------------------|------------|---------------|
144
- | Prefill Speed | 3,822 tok/s | 722 tok/s | — |
145
- | Decode Speed | 119 tok/s | 93 tok/s | — |
146
- | Perplexity (PPL) | 6.91 | 7.07 | — |
147
- | KV Compression | ~5× vs FP16 | ~5× vs FP16 | ~4× vs FP16 |
148
- | Rotation Parameters | 4 per rotor | 16,384 per matrix | N/A |
149
-
150
- > **Note:** These benchmarks are from the RotorQuant repository using Llama 3.1 8B on an RTX 5090. Performance on Qwen3.6-35B-A3B will differ. Independent benchmarks for this specific model are welcome — please open a discussion if you have results to share.
151
 
152
  ## Current Status of RotorQuant in the Ecosystem
153
 
@@ -199,7 +190,6 @@ For VRAM-constrained setups, standard q8_0 KV cache quantization already halves
199
 
200
  | Variant | Runtime | Approx size | Use case |
201
  |---|---|---|---|
202
- | [RotorQuant](https://huggingface.co/majentik/qwen3.6-35b-a3b-rotorquant) | runtime modifier | n/a | KV-cache root (weight-agnostic) |
203
  | **RotorQuant-GGUF-IQ4_XS** | llama.cpp | ~30 GB | Lossy 4-bit, low-RAM CPU/edge |
204
  | [RotorQuant-GGUF-Q2_K](https://huggingface.co/majentik/qwen3.6-35b-a3b-rotorquant-gguf-Q2_K) | llama.cpp | ~21 GB | Lossy, low-RAM CPU/edge |
205
  | [RotorQuant-GGUF-Q3_K_M](https://huggingface.co/majentik/qwen3.6-35b-a3b-rotorquant-gguf-Q3_K_M) | llama.cpp | ~27 GB | Smaller 3-bit, CPU-friendly |
@@ -212,10 +202,9 @@ For VRAM-constrained setups, standard q8_0 KV cache quantization already halves
212
  | [RotorQuant-MLX-5bit](https://huggingface.co/majentik/qwen3.6-35b-a3b-rotorquant-mlx-5bit) | mlx-lm | ~27 GB | Apple Silicon, higher fidelity |
213
  | [RotorQuant-MLX-6bit](https://huggingface.co/majentik/qwen3.6-35b-a3b-rotorquant-mlx-6bit) | mlx-lm | ~32 GB | Apple Silicon, near-lossless |
214
  | [RotorQuant-MLX-8bit](https://huggingface.co/majentik/qwen3.6-35b-a3b-rotorquant-mlx-8bit) | mlx-lm | ~41 GB | Apple Silicon reference |
215
- | [TurboQuant](https://huggingface.co/majentik/qwen3.6-35b-a3b-turboquant) | runtime modifier | n/a | KV-cache root (weight-agnostic) |
216
  | [TurboQuant-MLX-2bit](https://huggingface.co/majentik/qwen3.6-35b-a3b-turboquant-mlx-2bit) | mlx-lm | ~11 GB | Apple Silicon, smallest |
217
  | [TurboQuant-MLX-3bit](https://huggingface.co/majentik/qwen3.6-35b-a3b-turboquant-mlx-3bit) | mlx-lm | ~16 GB | Apple Silicon, small |
218
  | [TurboQuant-MLX-4bit](https://huggingface.co/majentik/qwen3.6-35b-a3b-turboquant-mlx-4bit) | mlx-lm | ~22 GB | Apple Silicon balanced |
219
  | [TurboQuant-MLX-5bit](https://huggingface.co/majentik/qwen3.6-35b-a3b-turboquant-mlx-5bit) | mlx-lm | ~27 GB | Apple Silicon, higher fidelity |
220
  | [TurboQuant-MLX-6bit](https://huggingface.co/majentik/qwen3.6-35b-a3b-turboquant-mlx-6bit) | mlx-lm | ~32 GB | Apple Silicon, near-lossless |
221
- | [TurboQuant-MLX-8bit](https://huggingface.co/majentik/qwen3.6-35b-a3b-turboquant-mlx-8bit) | mlx-lm | ~41 GB | Apple Silicon reference |
 
131
  | Modalities | Text + Image + Video (multimodal) |
132
  | Compatible Runtimes | llama.cpp, LM Studio, Ollama, koboldcpp |
133
 
134
+ ## About the RotorQuant / TurboQuant labels
135
 
136
+ RotorQuant and TurboQuant are this project's **release labels**, not distinct
137
+ quantization algorithms — for any given tier, both brand repos carry
138
+ byte-identical weights produced with the standard MLX / llama.cpp quantizers.
139
+ No brand-specific speedup is claimed or measured. The KV-cache fork these
140
+ labels originally referred to is legacy; for KV-cache memory savings use the
141
+ upstream options described above (`-ctk/-ctv q8_0`, `OLLAMA_KV_CACHE_TYPE`).
 
 
 
 
 
 
 
 
 
142
 
143
  ## Current Status of RotorQuant in the Ecosystem
144
 
 
190
 
191
  | Variant | Runtime | Approx size | Use case |
192
  |---|---|---|---|
 
193
  | **RotorQuant-GGUF-IQ4_XS** | llama.cpp | ~30 GB | Lossy 4-bit, low-RAM CPU/edge |
194
  | [RotorQuant-GGUF-Q2_K](https://huggingface.co/majentik/qwen3.6-35b-a3b-rotorquant-gguf-Q2_K) | llama.cpp | ~21 GB | Lossy, low-RAM CPU/edge |
195
  | [RotorQuant-GGUF-Q3_K_M](https://huggingface.co/majentik/qwen3.6-35b-a3b-rotorquant-gguf-Q3_K_M) | llama.cpp | ~27 GB | Smaller 3-bit, CPU-friendly |
 
202
  | [RotorQuant-MLX-5bit](https://huggingface.co/majentik/qwen3.6-35b-a3b-rotorquant-mlx-5bit) | mlx-lm | ~27 GB | Apple Silicon, higher fidelity |
203
  | [RotorQuant-MLX-6bit](https://huggingface.co/majentik/qwen3.6-35b-a3b-rotorquant-mlx-6bit) | mlx-lm | ~32 GB | Apple Silicon, near-lossless |
204
  | [RotorQuant-MLX-8bit](https://huggingface.co/majentik/qwen3.6-35b-a3b-rotorquant-mlx-8bit) | mlx-lm | ~41 GB | Apple Silicon reference |
 
205
  | [TurboQuant-MLX-2bit](https://huggingface.co/majentik/qwen3.6-35b-a3b-turboquant-mlx-2bit) | mlx-lm | ~11 GB | Apple Silicon, smallest |
206
  | [TurboQuant-MLX-3bit](https://huggingface.co/majentik/qwen3.6-35b-a3b-turboquant-mlx-3bit) | mlx-lm | ~16 GB | Apple Silicon, small |
207
  | [TurboQuant-MLX-4bit](https://huggingface.co/majentik/qwen3.6-35b-a3b-turboquant-mlx-4bit) | mlx-lm | ~22 GB | Apple Silicon balanced |
208
  | [TurboQuant-MLX-5bit](https://huggingface.co/majentik/qwen3.6-35b-a3b-turboquant-mlx-5bit) | mlx-lm | ~27 GB | Apple Silicon, higher fidelity |
209
  | [TurboQuant-MLX-6bit](https://huggingface.co/majentik/qwen3.6-35b-a3b-turboquant-mlx-6bit) | mlx-lm | ~32 GB | Apple Silicon, near-lossless |
210
+ | [TurboQuant-MLX-8bit](https://huggingface.co/majentik/qwen3.6-35b-a3b-turboquant-mlx-8bit) | mlx-lm | ~41 GB | Apple Silicon reference |