Zum Inhalt springen
ModelAufgelistetExtern
Herunterladen

Gemma 4 E4B RotorQuant MLX 2bit

> [!TIP] > KV-cache quantization without any fork (recommended, 2026): upstream > llama.cpp/Ollama now cover this natively — use -ctk q80 -ctv q80 > (half KV memory, negligible quality loss: perplexity +0.002–0.05)...

ArtText modelBasismodellgoogle/gemma-4-E4BVersionmodel

Modellquelle

Art
Text model
Dateigröße
3,11 GB
Basismodell
google/gemma-4-E4B
Version
vmodel
Aktualisiert
18. Sept. 2026
Downloads
119
Aufgaben
Beschriftung
Quelle
Hugging Face

Quellenbeschreibung

[!TIP] KV-cache quantization without any fork (recommended, 2026): upstream llama.cpp/Ollama now cover this natively — use -ctk q8_0 -ctv q8_0 (~half KV memory, negligible quality loss: perplexity +0.002–0.05) or -ctk q4_0 -ctv q4_0 (~quarter memory, ≈7.6% perplexity increase). In Ollama: OLLAMA_KV_CACHE_TYPE=q8_0 with OLLAMA_FLASH_ATTENTION=1. Keep K and V types symmetric to stay on the fast fused Flash-Attention path. Since April 2026, mainline llama.cpp also applies Hadamard rotation to KV activations (PR #21038), which greatly improves low-bit KV quality (opt-out: LLAMA_ATTN_ROT_DISABLE=1).

The RotorQuant/TurboQuant fork flow below is experimental/legacy: the TurboQuant llama.cpp PR was closed without merging (June 2026) and the fork is unmaintained relative to mainline. It is NOT required to use this model.

Gemma 4 E4B - RotorQuant MLX 2-bit

2-bit weight-quantized MLX version of google/gemma-4-E4B with RotorQuant KV-cache quantization. Optimized for Apple Silicon inference via the MLX framework. RotorQuant delivers 5.3x faster prefill and 28% faster decode compared to TurboQuant. The most aggressive quantization, fitting the full model in the smallest possible footprint.

Approximate model size: ~1.2 GB

Model Specifications

PropertyValue
Base Modelgoogle/gemma-4-E4B
Parameters~4 billion
ArchitectureDense transformer
ModalityMultimodal: image + text input, text output
LicenseApache 2.0
Weight Quantization2-bit (~1.2 GB)
KV-Cache QuantizationRotorQuant
FrameworkMLX (Apple Silicon)

Quickstart

import mlx.core as mx
from mlx_lm import load, generate

model, tokenizer = load("majentik/gemma-4-E4B-RotorQuant-MLX-2bit")

prompt = "The history of artificial intelligence began"
response = generate(model, tokenizer, prompt=prompt, max_tokens=512)
print(response)

For multimodal usage with images:

from mlx_vlm import load, generate

model, processor = load("majentik/gemma-4-E4B-RotorQuant-MLX-2bit")

prompt = "Describe the contents of this image."
output = generate(model, processor, prompt=prompt, image="path/to/image.jpg", max_tokens=512)
print(output)

What is RotorQuant?

RotorQuant is a high-performance KV-cache quantization method that achieves significantly better throughput than TurboQuant. Combined with 2-bit weight quantization in MLX, this provides maximum compression with the best available KV-cache performance: the smallest possible model footprint plus the fastest compressed KV cache for efficient long-context generation.

Key advantages over TurboQuant:

  • 5.3x faster prefill
  • 28% faster decode
  • Equivalent memory savings

Note: 2-bit quantization is the most aggressive option and may result in some quality degradation compared to higher-precision variants. It is best suited for experimentation, rapid prototyping, or hardware-constrained environments.

KV-Cache Quantization Comparison

MethodPrefill SpeedDecode SpeedMemory SavingsReference
TurboQuant1x (baseline)1x (baseline)HigharXiv: 2504.19874
RotorQuant5.3x faster28% fasterHighGitHub

Memory Estimates (Gemma 4 E4B)

PrecisionApproximate SizeMLX Variant
FP16 (original)~8 GB--
8-bit quantized~4 GBRotorQuant-MLX-8bit
4-bit quantized~2.3 GBRotorQuant-MLX-4bit
2-bit quantized~1.2 GBThis model

Hardware Requirements

This model requires approximately 1.2 GB of unified memory. Recommended hardware:

  • Apple M1 (8 GB+)
  • Apple M2 (8 GB+)
  • Apple M3 (8 GB+)
  • Apple M4 (8 GB+)
  • Any Apple Silicon Mac with 8 GB+ unified memory

See Also

Quant trade-off (MLX lane)

BitsApprox sizeUse caseRecommendation
2-bit~1.0 GBAggressive quantizationVery low-RAM Macs
3-bit~1.4 GBLossy but smallLow-RAM Macs
4-bit~1.7 GBBalanced defaultRecommended for most Macs
5-bit~2.0 GBHigher fidelityQuality-sensitive
6-bit~2.4 GBApproaching FP16 qualityHigh-fidelity
8-bit~3.0 GBNear-lossless referenceFidelity-critical work

(Current variant — 2bit — is bolded.)

Variants in this family

(Showing 14 sibling variants under majentik/gemma-4-e4b-*. The current variant — RotorQuant-MLX-2bit — is bolded.)

VariantRuntimeApprox sizeUse case
RotorQuantruntime modifiern/aKV-cache root (weight-agnostic)
RotorQuant-GGUF-IQ4_XSllama.cpp~3.4 GBLossy 4-bit, low-RAM CPU/edge
RotorQuant-GGUF-Q2_Kllama.cpp~2.4 GBLossy, low-RAM CPU/edge
RotorQuant-GGUF-Q3_K_Mllama.cpp~3.1 GBSmaller 3-bit, CPU-friendly
RotorQuant-GGUF-Q4_K_Mllama.cpp~4.4 GBBalanced default
RotorQuant-GGUF-Q5_K_Mllama.cpp~5.3 GBHigher fidelity, more RAM
RotorQuant-GGUF-Q8_0llama.cpp~8.4 GBNear-lossless reference
RotorQuant-MLX-2bitmlx-lm~1.3 GBApple Silicon, smallest
RotorQuant-MLX-4bitmlx-lm~2.5 GBApple Silicon balanced
RotorQuant-MLX-8bitmlx-lm~4.7 GBApple Silicon reference
TurboQuantruntime modifiern/aKV-cache root (weight-agnostic)
TurboQuant-MLX-2bitmlx-lm~1.3 GBApple Silicon, smallest
TurboQuant-MLX-4bitmlx-lm~2.5 GBApple Silicon balanced
TurboQuant-MLX-8bitmlx-lm~4.7 GBApple Silicon reference

Quellen

1 Quelle
Hugging FacePrimärVersion 3f9cb29d72623c10bc31bcfce95fc82ade2bb3b0
huggingface.co/majentik/gemma-4-E4B-RotorQuant-MLX-2bit/tree/3f9cb29d72623c10bc31bcfce95fc82ade2bb3b0

Verifiziert 18. Sept.

Modellartefakte

1 Artefakt

model.safetensors

safetensors · 3,11 GB · SHA-256 835bc802780f…e236 · Hugging Face

Herunterladen

Quellenauszüge

2 Auszüge

--- base_model: google/gemma-4-E4B library_name: mlx tags: - rotorquant - kv-cache-quantization - gemma - gemma4 - multimodal - quantized - mlx - 2bit license: apache-2.0 pipeline_tag: image-text-to-text --- > [!TIP] > **KV-cache quantization without any fork (recommended, 2026):** upstream > llama.cpp/Ollama now cover this natively — use `-ctk q8_0 -ctv q8_0` > (~half KV memory, negligible quality loss: perplexity +0.002–0.05) or > `-ctk q4_0 -ctv q4_0` (~quarter memory, ≈7.6% perplexity increase). In > Ollama: `OLLAMA_KV_CACHE_TYPE=q8_0` with `OLLAMA_FLASH_ATTENTION=1`. Keep > K and V types symmetric to stay on the fast fused Flash-Attention path. > Since April 2026, mainline llama.cpp also applies Hadamard rotation to > KV activations ([PR #21038](https://github.com/ggml-org/llama.cpp/pull/21038)), > which greatly improves low-bit KV quality (opt-out: > `LLAMA_ATTN_ROT_DISABLE=1`). > > The RotorQuant/TurboQuant fork flow below is **experimental/legacy**: the > TurboQuant llama.cpp PR was closed without merging (June 2026) and the fork > is unmaintained relative to mainline. It is NOT required to use this model. <!-- kv-upstream-note --> # Gemma 4 E4B - RotorQuant MLX 2-bit **2-bit weight-quantized MLX version** of [google/gemma-4-E4B](https://huggingface.co/google/gemma-4-E4B) 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. The most aggressive quantization, fitting the full model in the smallest possible footprint. Approximate model size: **~1.2 GB** ## Model Specifications | Property | Value | |---|---| | **Base Model** | [google/gemma-4-E4B](https://huggingface.co/google/gemma-4-E4B) | | **Parameters** | ~4 billion | | **Architecture** | Dense transformer | | **Modality** | Multimodal: image + text input, text output | | **License** | Apache 2.0 | | **Weight Quantization** | 2-bit (~1.2 GB) | | **KV-Cache Quantization** | RotorQuant | | **Framework** | MLX (Apple Silicon) | ## Quickstart ```python import mlx.core as mx from mlx_lm import load, generate model, tokenizer = load("majentik/gemma-4-E4B-RotorQuant-MLX-2bit") prompt = "The history of artificial intelligence began" response = generate(model, tokenizer, prompt=prompt, max_tokens=512) print(response) ```...

Source context: 119 downloads · 0 likes · Pipeline image-text-to-text · Library mlx · Repo majentik/gemma-4-E4B-RotorQuant-MLX-2bit