Instructions to use SirSahOl/DeepSeek-R1-Distill-Qwen-7B-chat-mlx-8bit with libraries, inference providers, notebooks, and local apps. Follow these links to get started.

Libraries

How to use SirSahOl/DeepSeek-R1-Distill-Qwen-7B-chat-mlx-8bit with MLX:

# Make sure mlx-lm is installed
# pip install --upgrade mlx-lm

# Generate text with mlx-lm
from mlx_lm import load, generate

model, tokenizer = load("SirSahOl/DeepSeek-R1-Distill-Qwen-7B-chat-mlx-8bit")

prompt = "Write a story about Einstein"
messages = [{"role": "user", "content": prompt}]
prompt = tokenizer.apply_chat_template(
    messages, add_generation_prompt=True
)

text = generate(model, tokenizer, prompt=prompt, verbose=True)

Transformers

How to use SirSahOl/DeepSeek-R1-Distill-Qwen-7B-chat-mlx-8bit with Transformers:

# Use a pipeline as a high-level helper
from transformers import pipeline

pipe = pipeline("text-generation", model="SirSahOl/DeepSeek-R1-Distill-Qwen-7B-chat-mlx-8bit")
messages = [
    {"role": "user", "content": "Who are you?"},
]
pipe(messages)

# Load model directly
from transformers import AutoTokenizer, AutoModelForCausalLM

tokenizer = AutoTokenizer.from_pretrained("SirSahOl/DeepSeek-R1-Distill-Qwen-7B-chat-mlx-8bit")
model = AutoModelForCausalLM.from_pretrained("SirSahOl/DeepSeek-R1-Distill-Qwen-7B-chat-mlx-8bit", device_map="auto")
messages = [
    {"role": "user", "content": "Who are you?"},
]
inputs = tokenizer.apply_chat_template(
	messages,
	add_generation_prompt=True,
	tokenize=True,
	return_dict=True,
	return_tensors="pt",
).to(model.device)

outputs = model.generate(**inputs, max_new_tokens=40)
print(tokenizer.decode(outputs[0][inputs["input_ids"].shape[-1]:]))

Notebooks
Google Colab
Kaggle
Local Apps Settings
LM Studio

vLLM

How to use SirSahOl/DeepSeek-R1-Distill-Qwen-7B-chat-mlx-8bit with vLLM:

Install from pip and serve model

# Install vLLM from pip:
pip install vllm
# Start the vLLM server:
vllm serve "SirSahOl/DeepSeek-R1-Distill-Qwen-7B-chat-mlx-8bit"
# Call the server using curl (OpenAI-compatible API):
curl -X POST "http://localhost:8000/v1/chat/completions" \
	-H "Content-Type: application/json" \
	--data '{
		"model": "SirSahOl/DeepSeek-R1-Distill-Qwen-7B-chat-mlx-8bit",
		"messages": [
			{
				"role": "user",
				"content": "What is the capital of France?"
			}
		]
	}'

Use Docker

docker model run hf.co/SirSahOl/DeepSeek-R1-Distill-Qwen-7B-chat-mlx-8bit

SGLang

How to use SirSahOl/DeepSeek-R1-Distill-Qwen-7B-chat-mlx-8bit with SGLang:

Install from pip and serve model

# Install SGLang from pip:
pip install sglang
# Start the SGLang server:
python3 -m sglang.launch_server \
    --model-path "SirSahOl/DeepSeek-R1-Distill-Qwen-7B-chat-mlx-8bit" \
    --host 0.0.0.0 \
    --port 30000
# Call the server using curl (OpenAI-compatible API):
curl -X POST "http://localhost:30000/v1/chat/completions" \
	-H "Content-Type: application/json" \
	--data '{
		"model": "SirSahOl/DeepSeek-R1-Distill-Qwen-7B-chat-mlx-8bit",
		"messages": [
			{
				"role": "user",
				"content": "What is the capital of France?"
			}
		]
	}'

Use Docker images

docker run --gpus all \
    --shm-size 32g \
    -p 30000:30000 \
    -v ~/.cache/huggingface:/root/.cache/huggingface \
    --env "HF_TOKEN=<secret>" \
    --ipc=host \
    lmsysorg/sglang:latest \
    python3 -m sglang.launch_server \
        --model-path "SirSahOl/DeepSeek-R1-Distill-Qwen-7B-chat-mlx-8bit" \
        --host 0.0.0.0 \
        --port 30000
# Call the server using curl (OpenAI-compatible API):
curl -X POST "http://localhost:30000/v1/chat/completions" \
	-H "Content-Type: application/json" \
	--data '{
		"model": "SirSahOl/DeepSeek-R1-Distill-Qwen-7B-chat-mlx-8bit",
		"messages": [
			{
				"role": "user",
				"content": "What is the capital of France?"
			}
		]
	}'

MLX LM

How to use SirSahOl/DeepSeek-R1-Distill-Qwen-7B-chat-mlx-8bit with MLX LM:

Generate or start a chat session

# Install MLX LM
uv tool install mlx-lm
# Interactive chat REPL
mlx_lm.chat --model "SirSahOl/DeepSeek-R1-Distill-Qwen-7B-chat-mlx-8bit"

Run an OpenAI-compatible server

# Install MLX LM
uv tool install mlx-lm
# Start the server
mlx_lm.server --model "SirSahOl/DeepSeek-R1-Distill-Qwen-7B-chat-mlx-8bit"
# Calling the OpenAI-compatible server with curl
curl -X POST "http://localhost:8000/v1/chat/completions" \
   -H "Content-Type: application/json" \
   --data '{
     "model": "SirSahOl/DeepSeek-R1-Distill-Qwen-7B-chat-mlx-8bit",
     "messages": [
       {"role": "user", "content": "Hello"}
     ]
   }'

Docker Model Runner
How to use SirSahOl/DeepSeek-R1-Distill-Qwen-7B-chat-mlx-8bit with Docker Model Runner:
```
docker model run hf.co/SirSahOl/DeepSeek-R1-Distill-Qwen-7B-chat-mlx-8bit
```
Atomic Chat

DeepSeek-R1-Distill-Qwen-7B-mlx-8bit

8-bit MLX conversion of deepseek-ai/DeepSeek-R1-Distill-Qwen-7B optimized for Apple Silicon native GPU inference.

Converted by: SirSahOl
Source Model: deepseek-ai/DeepSeek-R1-Distill-Qwen-7B
Framework: MLX by Apple
Quantization: 8-bit (Average 8.25 bits per weight)
Format: safetensors
License: mit

Model Details

Architecture: Qwen2ForCausalLM
Parameters: 7B
Context Length: 131,072 tokens
Format: MLX (Apple Silicon native GPU format)
Quantization: 8-bit (Average 8.25 bits per weight)
Active VRAM Footprint: ~7.8 GB (Minimum recommended: 16 GB Unified Memory)

Quick Start

Installation

pip install mlx-lm

CLI Usage

# Chat interactively
mlx_lm.chat --model SirSahOl/DeepSeek-R1-Distill-Qwen-7B-chat-mlx-8bit

# Generate text
mlx_lm.generate --model SirSahOl/DeepSeek-R1-Distill-Qwen-7B-chat-mlx-8bit --prompt "Write a short poem about artificial intelligence."

Python API (with Chat Template)

from mlx_lm import load, generate

model, tokenizer = load("SirSahOl/DeepSeek-R1-Distill-Qwen-7B-chat-mlx-8bit")

messages = [
    {"role": "user", "content": "Explain quantum superposition in simple terms."}
]
prompt = tokenizer.apply_chat_template(
    messages, tokenize=False, add_generation_prompt=True
)

response = generate(model, tokenizer, prompt=prompt, verbose=True)
print(response)

Performance Benchmarks

Apple Silicon Hardware Sizing Matrix

Estimated decoding throughput, time-to-first-token (TTFT), and active unified memory footprint across Apple Silicon tiers:

Apple Silicon Tier	Unified Memory	Active VRAM	Estimated Speed	Est. TTFT	Recommended Use Case
M1 / M2 / M3 / M4 (Base)	16 GB (min. required)	~7.8 GB	~22 tokens/sec	~160 ms	High-precision instruction following on 16GB Apple Silicon Macs
M1 / M2 / M3 / M4 Pro	18 GB – 36 GB	~7.8 GB	~34 tokens/sec	~110 ms	Balanced daily driver for complex math, structured reasoning, and code
M1 / M2 / M3 / M4 Max	36 GB – 128 GB	~7.8 GB	~48 tokens/sec	~70 ms	Low-latency multi-step reasoning, swarm agents, data analysis
M1 / M2 / M3 Ultra	64 GB – 192 GB	~7.8 GB	~72 tokens/sec	~45 ms	High-throughput serving with near-lossless precision

Estimates based on Apple Silicon unified memory bandwidth and active parameter footprint. Real-world speeds may vary with context length.

Multi-Quantization Comparison

Evaluate your hardware budget and choose the optimal precision:

Variant	Disk Size	VRAM Footprint	Target Apple Silicon Hardware	Key Advantage
4-bit MLX	~4.3 GB	~4.2 GB	M1 / M2 / M3 / M4 (8GB+ Unified Memory)	Maximum generation speed, lowest memory pressure; ideal for multitasking and everyday local chat alongside IDEs.
8-bit MLX (This Repository)	~8.1 GB	~7.8 GB	M1 / M2 / M3 / M4 Pro/Max (16GB+ Unified Memory)	Near-lossless precision, high-fidelity reasoning, and stable complex instruction following.
16-bit MLX	~15.2 GB	~15.2 GB	M2 / M3 / M4 Max/Ultra (32GB+ Unified Memory)	Full unquantized bfloat16 precision; zero perplexity loss, ideal for evaluation and reference output.

Who Should Use This?

Your Hardware	Recommended Quantization
M1/M2/M3/M4 (8GB – 16GB)	4-bit — Best balance of speed, low memory, and multitasking capability
M1/M2/M3/M4 Pro/Max (18GB – 36GB)	8-bit — Higher quality reasoning with comfortable memory headroom
M1/M2/M3/M4 Max/Ultra (36GB – 192GB)	16-bit — Unquantized full precision, zero quality degradation

General guidance:

Use 4-bit if you want to run this model alongside IDEs, browsers, and background development tools.
Use 8-bit if you have 16GB+ unified memory and require superior reasoning and code accuracy.
Use 16-bit for research, benchmarking, evaluation, or high-end workstation deployments.

Other Quantization Variants

Variant	Link
4-bit	SirSahOl/DeepSeek-R1-Distill-Qwen-7B-chat-mlx-4bit
8-bit	SirSahOl/DeepSeek-R1-Distill-Qwen-7B-chat-mlx-8bit
16-bit	SirSahOl/DeepSeek-R1-Distill-Qwen-7B-chat-mlx-16bit

LM Studio & Local Inference Setup Guide

To prevent runaway loops and ensure correct conversational turn-taking, configure custom stop strings in your local inference runtime.

Custom Stop Strings Configuration

Ensure the following sequence tokens are configured as strict stop boundaries:

<|im_start|>
<|im_end|>
<|endoftext|>

Option A: Automatic Preset (Recommended for LM Studio)

Create a custom prompt preset JSON file named Qwen2.5.json in your LM Studio config directory:

macOS / Linux: ~/.lmstudio/config-presets/Qwen2.5.json
Windows: %USERPROFILE%\.lmstudio\config-presets\Qwen2.5.json

{
  "name": "Qwen2.5",
  "inference_params": {
    "pre_prompt": "You are a helpful, respectful, and honest assistant.",
    "input_prefix": "<|im_start|>user\n",
    "input_suffix": "<|im_end|>\n",
    "pre_prompt_prefix": "<|im_start|>system\n",
    "pre_prompt_suffix": "<|im_end|>\n",
    "antiprompt": [
      "<|im_start|>",
      "<|im_end|>",
      "<|endoftext|>"
    ],
    "stopStrings": [
      "<|im_start|>",
      "<|im_end|>",
      "<|endoftext|>"
    ],
    "temperature": 0.7,
    "max_tokens": 2048
  }
}

Restart LM Studio, load SirSahOl/DeepSeek-R1-Distill-Qwen-7B-chat-mlx-8bit, and select "Qwen2.5" from the Prompt Template dropdown.

Option B: Manual LM Studio Configuration

Load SirSahOl/DeepSeek-R1-Distill-Qwen-7B-chat-mlx-8bit in LM Studio.
In the right-hand Advanced Configuration / Inference Parameters panel:
- Stop Strings (antiprompt / stopStrings): Add <|im_start|>, <|im_end|>, <|endoftext|>
- System Prefix: <|im_start|>system\n
- System Suffix: <|im_end|>\n
- User Prefix: <|im_start|>user\n
- Assistant Suffix: <|im_end|>\n<|im_start|>assistant\n

Option C: Ollama Modelfile Setup

Create a Modelfile to run this model in Ollama:

FROM SirSahOl/DeepSeek-R1-Distill-Qwen-7B-chat-mlx-8bit

PARAMETER stop "<|im_start|>"
PARAMETER stop "<|im_end|>"
PARAMETER stop "<|endoftext|>"
PARAMETER temperature 0.7

TEMPLATE """{{ if .System }}<|im_start|>system
{{ .System }}<|im_end|>
{{ end }}{{ if .Prompt }}<|im_start|>user
{{ .Prompt }}<|im_end|>
{{ end }}<|im_start|>assistant
"""

Create and run with Ollama:

ollama create deepseek-r1-distill-qwen-7b-chat-mlx-8bit -f Modelfile
ollama run deepseek-r1-distill-qwen-7b-chat-mlx-8bit

Conversion Details

Property	Value
Source Model	deepseek-ai/DeepSeek-R1-Distill-Qwen-7B
Quantization	8-bit
mlx-lm Version	0.31.3
Conversion Time	126.61s
Output Size	7.5 GB
Date	2026-09-14T23:37:14.803647+00:00

Reproduction

To reproduce this conversion:

pip install mlx-lm==0.31.3
python3 -m mlx_lm.convert --hf-path /root/.cache/huggingface/hub/models--deepseek-ai--DeepSeek-R1-Distill-Qwen-7B/snapshots/916b56a44061fd5cd7d6a8fb632557ed4f724f60 --mlx-path output/DeepSeek-R1-Distill-Qwen-7B-mlx-8bit -q --q-bits 8

Limitations & Known Issues

4-bit group-wise quantization introduces minor precision loss compared to unquantized weights; for deep mathematical derivations or precision-critical reasoning, test the 8-bit or 16-bit variants.
High context sequences (>32K tokens) require sufficient unified memory headroom; ensure unified memory is not overcommitted.
This is a weight-only MLX conversion designed specifically for Apple Silicon GPUs (M1/M2/M3/M4 series).

License

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

See the original model card for full license details.

Changelog

Version	Date	Changes
v1.0	2026-09-14	Initial conversion

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

Downloads last month: 15

Safetensors

Model size

8B params

Tensor type

U32

BF16

MLX

Hardware compatibility

8-bit

Model tree for SirSahOl/DeepSeek-R1-Distill-Qwen-7B-chat-mlx-8bit

Base model

deepseek-ai/DeepSeek-R1-Distill-Qwen-7B

Quantized

(194)

this model

Collection including SirSahOl/DeepSeek-R1-Distill-Qwen-7B-chat-mlx-8bit

MLX Models by SirSahOl — Optimized for Apple Silicon

Collection

Curated collection of high-performance MLX model conversions benchmarked and optimized for Apple Silicon (M1/M2/M3/M4 unified memory). • 44 items • Updated about 14 hours ago