How to use from
Pi
Start the MLX server
# Install MLX LM:
uv tool install mlx-lm
# Start a local OpenAI-compatible server:
mlx_lm.server --model "yugeshkarunamurthy/Gemma-4-12B-it-oQ4"
Configure the model in Pi
# Install Pi:
npm install -g @earendil-works/pi-coding-agent
# Add to ~/.pi/agent/models.json:
{
  "providers": {
    "mlx-lm": {
      "baseUrl": "http://localhost:8080/v1",
      "api": "openai-completions",
      "apiKey": "none",
      "models": [
        {
          "id": "yugeshkarunamurthy/Gemma-4-12B-it-oQ4"
        }
      ]
    }
  }
}
Run Pi
# Start Pi in your project directory:
pi
Quick Links

Gemma 4 12B IT - oQ Quantized

Model Description

This repository contains an oMLX oQ quantized version of Google's Gemma 4 12B IT model.

The model has been quantized using oMLX's sensitivity-aware mixed-precision quantization pipeline, which dynamically allocates precision across model components to preserve quality while reducing memory and storage requirements.

Base Model

  • Base Model: google/gemma-4-12B-it
  • Model Family: Gemma 4
  • Quantization Method: oMLX oQ
  • Format: MLX
  • License: Gemma License

Quantization Information

This model was created using the oMLX oQ quantization pipeline.

oQ uses mixed-precision quantization instead of applying a uniform bit-width across all tensors. More sensitive model components retain higher precision while less sensitive components are compressed more aggressively.

Benefits

  • Reduced memory footprint
  • Reduced storage requirements
  • Improved quality retention compared to uniform quantization
  • Optimized for Apple Silicon inference

Intended Uses

This model is suitable for:

  • General chat applications
  • Coding assistance
  • Research and experimentation
  • Local AI assistants
  • Agent workflows
  • Reasoning tasks
  • Content generation

Usage

Python

from mlx_lm import load, generate

model, tokenizer = load("path/to/model")

response = generate(
    model,
    tokenizer,
    prompt="Explain mixed precision quantization.",
    max_tokens=512,
)

print(response)

CLI

mlx_lm.generate \
  --model path/to/model \
  --prompt "Hello!"

Hardware Requirements

Hardware requirements depend on:

  • Context length
  • Runtime implementation
  • Quantization parameters
  • Concurrent workloads

Apple Silicon systems are recommended for optimal performance.

Limitations

This model inherits the strengths and limitations of the original Gemma 4 12B IT model.

Quantization may introduce:

  • Minor reductions in reasoning quality
  • Slight output variations compared to full-precision checkpoints
  • Reduced accuracy on some specialized tasks

Users should evaluate the model for their specific use cases.

Acknowledgements

Base Model

Google DeepMind — Gemma 4

Quantization

  • oMLX
  • MLX Ecosystem

License

This repository contains a quantized derivative of Gemma 4.

Please refer to the original Gemma license and usage terms before deployment.

Disclaimer

This is a community-produced quantized checkpoint and is not an official Google DeepMind release.

Downloads last month
21
Safetensors
Model size
12B params
Tensor type
U32
·
BF16
·
MLX
Hardware compatibility
Log In to add your hardware

4-bit

Inference Providers NEW
This model isn't deployed by any Inference Provider. 🙋 Ask for provider support

Model tree for yugeshkarunamurthy/Gemma-4-12B-it-oQ4

Quantized
(310)
this model