CoolFace
Modelpublic

majentik/MERaLiON-3-10B-TurboQuant-MLX-4bit

sourceHugging Faceotherupdated 2mo agoView on Hugging Face
0likes15downloads
Model Card
[!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.

<!-- kv-upstream-note -->

MERaLiON-3-10B-TurboQuant-MLX-4bit

4-bit weight-quantized MLX version of MERaLiON/MERaLiON-3-10B-preview with the legacy TurboQuant KV-cache fork (superseded by upstream llama.cpp KV options). Optimized for Apple Silicon inference via the MLX framework.

MERaLiON-3-10B is a multimodal audio-language model built on a Gemma-2 decoder backbone, designed for speech-to-text and audio understanding tasks.

Approximate model size: ~5 GB

Model Specifications

PropertyValue
Base ModelMERaLiON/MERaLiON-3-10B-preview
Parameters~10 billion
ArchitectureMultimodal audio-language (Gemma-2 decoder backbone)
ModalityAudio + text input, text output
LicenseSee base model
Weight Quantization4-bit (~5 GB)
KV-Cache QuantizationTurboQuant
FrameworkMLX (Apple Silicon)

Quickstart

python
from mlx_lm import load, generate

model, tokenizer = load("majentik/MERaLiON-3-10B-TurboQuant-MLX-4bit")

prompt = "Transcribe the following audio:"
response = generate(model, tokenizer, prompt=prompt, max_tokens=512)
print(response)

About the RotorQuant / TurboQuant labels

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

MethodPrefill SpeedDecode SpeedMemory SavingsReference
TurboQuantBaselineBaselineHigharXiv: 2504.19874

Memory Estimates (MERaLiON-3-10B)

PrecisionApproximate SizeMLX Variant
FP16 (original)~20 GB--
8-bit quantized~10 GBTurboQuant-MLX-8bit
4-bit quantized~5 GBThis model
2-bit quantized~3 GBTurboQuant-MLX-2bit

Hardware Requirements

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

  • —Apple M1 (8 GB+)
  • —Any Apple Silicon Mac

See Also

Quant trade-off (MLX lane)

BitsApprox sizeUse caseRecommendation
2-bit~2.6 GBAggressive quantizationVery low-RAM Macs
3-bit~3.6 GBLossy but smallLow-RAM Macs
4-bit~4.2 GBBalanced defaultRecommended for most Macs
5-bit~5.0 GBHigher fidelityQuality-sensitive
6-bit~6.0 GBApproaching FP16 qualityHigh-fidelity
8-bit~7.6 GBNear-lossless referenceFidelity-critical work

(Current variant — 4bit — is bolded.)

Variants in this family

(Showing 8 sibling variants under majentik/meralion3-10b-*. The current variant — TurboQuant-MLX-4bit — is bolded.)

VariantRuntimeApprox sizeUse case
TurboQuant-MLX-4bitmlx-lm~6.2 GBApple Silicon balanced