mlx-optiq
← Models

gemma-4-31B-it-OptiQ-4bit

google/gemma-4-31B-it, quantized by OptiQ for Apple Silicon; takes images.

vision
On disk23.5 GB
Memoryabout 29 GB
Capability Score82.77
Imagesyes

Capability Score breakdown

The six metrics behind this model's Capability Score of 82.77, as reported in the model card. Values are compared with uniform 4-bit.

  • This model
  • Uniform 4-bit
Capability Score breakdown: gemma-4-31B-it-OptiQ-4bitMMLU: This model 73.2, Uniform 4-bit 73.9; GSM8K: This model 96.0, Uniform 4-bit 96.5; IFEval: This model 76.5, Uniform 4-bit 76.9; BFCL-V3: This model 93.5, Uniform 4-bit 93.5; HumanEval: This model 91.5, Uniform 4-bit 92.1; HashHop: This model 66.0, Uniform 4-bit 44.0MMLU73.273.9GSM8K96.096.5IFEval76.576.9BFCL-V393.593.5HumanEval91.592.1HashHop66.044.0

Use it

Install

pip install mlx-optiq

Serve it

An OpenAI- and Anthropic-compatible server on this Mac. Every app below can use it.

optiq serve --model mlx-community/gemma-4-31B-it-OptiQ-4bit

OptiQ Code

The terminal coding agent uses whatever model optiq serve is running.

optiq serve --model mlx-community/gemma-4-31B-it-OptiQ-4bit
optiq code

OptiQ Lab

optiq lab --model mlx-community/gemma-4-31B-it-OptiQ-4bit

Claude Code

optiq run claude -m mlx-community/gemma-4-31B-it-OptiQ-4bit

Codex

optiq run codex -m mlx-community/gemma-4-31B-it-OptiQ-4bit

OpenCode

optiq run opencode -m mlx-community/gemma-4-31B-it-OptiQ-4bit

Mistral Vibe

optiq run vibe -m mlx-community/gemma-4-31B-it-OptiQ-4bit

Hermes Agent

optiq run hermes -m mlx-community/gemma-4-31B-it-OptiQ-4bit

OpenClaw

optiq run openclaw -m mlx-community/gemma-4-31B-it-OptiQ-4bit

optiq run starts optiq serve if it is not running, sets the agent up for this session only, and stops the server when the agent exits.

mlx-lm, text only

from mlx_lm import load, generate

model, tokenizer = load("mlx-community/gemma-4-31B-it-OptiQ-4bit")
print(generate(model, tokenizer, prompt="Hello", max_tokens=256))

Details

FamilyGemma-4 · Gemma-4 docs
ArchitectureGemma 4
Base modelgoogle/gemma-4-31B-it
Size on disk23.5 GB
Memory neededabout 29 GB
Imagesyes, through optiq serve and the Lab
Capability Score82.77 (from the model card)
Downloads640 in the last month
Updated2026-10-18
Hugging Facemlx-community/gemma-4-31B-it-OptiQ-4bit