Qwen2.5-3B-Instruct-chat-mlx-4bit

Qwen2.5-3B-Instruct-mlx-4bit

4-bit MLX conversion of Qwen/Qwen2.5-3B-Instruct for Apple Silicon.

Converted by: SirSahOl Source model: Qwen/Qwen2.5-3B-Instruct Framework: MLX by Apple Quantization: 4-bit Format: safetensors License: other

---

Quick Start

Installation

pip install mlx-lm

CLI Usage

# Chat interactively
mlx_lm.chat --model SirSahOl/Qwen2.5-3B-Instruct-chat-mlx-4bit

# Generate text
mlx_lm.generate --model SirSahOl/Qwen2.5-3B-Instruct-chat-mlx-4bit --prompt "Your prompt here"

Python Usage

from mlx_lm import load, generate

model, tokenizer = load("SirSahOl/Qwen2.5-3B-Instruct-chat-mlx-4bit")
response = generate(model, tokenizer, prompt="Your prompt here", max_tokens=256)
print(response)

---

Performance Benchmarks

| Metric | 4-bit | |--------|--------|| Tokens/sec | 28.18 | | TTFT | 35.57 ms | | Peak Memory | 1958.1 MB |

Benchmarked on Apple M1 with 8GB unified memory. Average over 5 runs with 256 max tokens.

---

Who Should Use This?

General guidance:

• Use 4-bit if you want to run this model alongside other applications
• Use 8-bit if you have the memory and want better quality
• Use 16-bit for research, evaluation, or if memory isn't a concern

---

Other Quantization Variants

---

Conversion Details

Reproduction

To reproduce this conversion:

pip install mlx-lm==0.31.3
python3 -m mlx_lm.convert --hf-path Qwen/Qwen2.5-3B-Instruct --mlx-path output/Qwen2.5-3B-Instruct-mlx-4bit -q --q-bits 4

---

Limitations & Known Issues

• Performance may degrade with very long contexts (>8K tokens) at lower quantization levels.
• This is a weight-only conversion; the model architecture and behavior are inherited from the source model.
• Quantization introduces a small quality loss compared to the original model. Lower bit counts = more loss.
• This model requires Apple Silicon (M1 or later) to run with MLX.

---

License

This model conversion inherits the license of the source model: other.

See the original model card for full license details.

---

Changelog

---

Converted with MLX Foundry — a professional pipeline for converting models to Apple MLX format.