Aller au contenu
ModelPrésentéExterne
Télécharger

Gemma 4 E2B It 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)...

TypeText modelModèle de basegoogle/gemma-4-E2B-itVersionmodel

Source du modèle

Type
Text model
Taille du fichier
2,26 GB
Modèle de base
google/gemma-4-E2B-it
Version
vmodel
Mis à jour
17 sept. 2026
Téléchargements
113
Tâches
Légendes
Source
Hugging Face

Description de la source

[!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 E2B-it - RotorQuant MLX 2-bit

2-bit weight-quantized MLX version of google/gemma-4-E2B-it 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: ~0.6 GB

Model Specifications

PropertyValue
Base Modelgoogle/gemma-4-E2B-it
Parameters~2 billion
ArchitectureDense transformer
ModalityMultimodal: image + text input, text output
LicenseApache 2.0
Weight Quantization2-bit (~0.6 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-E2B-it-RotorQuant-MLX-2bit")

prompt = "Describe this image in detail."
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-E2B-it-RotorQuant-MLX-2bit")

prompt = "What do you see in 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 E2B-it)

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

Hardware Requirements

This model requires approximately 0.6 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~532 MBAggressive quantizationVery low-RAM Macs
3-bit~737 MBLossy but smallLow-RAM Macs
4-bit~860 MBBalanced defaultRecommended for most Macs
5-bit~1.0 GBHigher fidelityQuality-sensitive
6-bit~1.2 GBApproaching FP16 qualityHigh-fidelity
8-bit~1.5 GBNear-lossless referenceFidelity-critical work

(Current variant — 2bit — is bolded.)

Variants in this family

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

VariantRuntimeApprox sizeUse case
RotorQuantruntime modifiern/aKV-cache root (weight-agnostic)
RotorQuant-GGUF-IQ4_XSllama.cpp~1.7 GBLossy 4-bit, low-RAM CPU/edge
RotorQuant-GGUF-Q2_Kllama.cpp~1.2 GBLossy, low-RAM CPU/edge
RotorQuant-GGUF-Q3_K_Mllama.cpp~1.6 GBSmaller 3-bit, CPU-friendly
RotorQuant-GGUF-Q4_K_Mllama.cpp~2.2 GBBalanced default
RotorQuant-GGUF-Q5_K_Mllama.cpp~2.6 GBHigher fidelity, more RAM
RotorQuant-GGUF-Q8_0llama.cpp~4.2 GBNear-lossless reference
RotorQuant-MLX-2bitmlx-lm~655 MBApple Silicon, smallest
RotorQuant-MLX-4bitmlx-lm~1.2 GBApple Silicon balanced
RotorQuant-MLX-8bitmlx-lm~2.4 GBApple Silicon reference
TurboQuantruntime modifiern/aKV-cache root (weight-agnostic)
TurboQuant-MLX-2bitmlx-lm~655 MBApple Silicon, smallest
TurboQuant-MLX-4bitmlx-lm~1.2 GBApple Silicon balanced
TurboQuant-MLX-8bitmlx-lm~2.4 GBApple Silicon reference

Sources

1 source
Hugging FacePrincipalVersion 0a94565dcc3b8a9b7ba0f43b3ff943f850ea341e
huggingface.co/majentik/gemma-4-E2B-it-RotorQuant-MLX-2bit/tree/0a94565dcc3b8a9b7ba0f43b3ff943f850ea341e

Vérifié 17 sept.

Artefacts du modèle

1 artefact

model.safetensors

safetensors · 2,26 GB · SHA-256 66ed5382fb5f…63f6 · Hugging Face

Télécharger

Extraits de sources

2 extraits

--- base_model: google/gemma-4-E2B-it 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 E2B-it - RotorQuant MLX 2-bit **2-bit weight-quantized MLX version** of [google/gemma-4-E2B-it](https://huggingface.co/google/gemma-4-E2B-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. The most aggressive quantization, fitting the full model in the smallest possible footprint. Approximate model size: **~0.6 GB** ## Model Specifications | Property | Value | |---|---| | **Base Model** | [google/gemma-4-E2B-it](https://huggingface.co/google/gemma-4-E2B-it) | | **Parameters** | ~2 billion | | **Architecture** | Dense transformer | | **Modality** | Multimodal: image + text input, text output | | **License** | Apache 2.0 | | **Weight Quantization** | 2-bit (~0.6 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-E2B-it-RotorQuant-MLX-2bit") prompt = "Describe this image in detail." response = generate(model, tokenizer, prompt=prompt, max_tokens=512) print(respon...

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