DeepSeek-R1 Qwen3-8B GGUF
Quantized GGUF versions of the DeepSeek-R1 model optimized for CPU inference with llama.cpp and Ollama.
Model Details
- Base Model: deepseek-ai/DeepSeek-R1-0528-Qwen3-8B
- Model Type: Large Language Model with Chain-of-Thought reasoning capabilities
- Format: GGUF (GPT-Generated Unified Format)
- Compatible with: llama.cpp, Ollama, LM Studio, and other GGUF-compatible inference engines
Available Quantizations
Quantization | File Size | Use Case | Quality |
---|---|---|---|
bf16 | 15.0 GB | Maximum quality, research use | ★★★★★ |
q8_0 | 8.1 GB | Near-original quality | ★★★★★ |
q6_k | 6.3 GB | High quality, balanced | ★★★★☆ |
q5_k_m | 5.4 GB | Good quality, recommended | ★★★★☆ |
q5_k_s | 5.3 GB | Good quality, smaller | ★★★★☆ |
q4_1 | 4.9 GB | Balanced quality/size | ★★★☆☆ |
q4_k_m | 4.7 GB | Recommended for most users | ★★★☆☆ |
iq4_nl | 4.5 GB | Improved q4 with better quality | ★★★☆☆ |
q4_k_s | 4.5 GB | Good balance | ★★★☆☆ |
q4_0 | 4.4 GB | Standard q4 quantization | ★★★☆☆ |
iq4_xs | 4.3 GB | Extra small q4 variant | ★★★☆☆ |
q3_k_l | 4.1 GB | Large q3 variant | ★★☆☆☆ |
q3_k_m | 3.8 GB | Medium q3 quantization | ★★☆☆☆ |
iq3_m | 3.6 GB | Improved q3 quantization | ★★☆☆☆ |
q3_k_s | 3.5 GB | Small q3 variant | ★★☆☆☆ |
iq3_s | 3.5 GB | Small improved q3 | ★★☆☆☆ |
q2_k | 3.1 GB | Most compressed, lowest RAM | ★☆☆☆☆ |
Recommended Quantizations
- For High-End Systems (32GB+ RAM):
q8_0
orq6_k
- For Most Users (16GB+ RAM):
q5_k_m
orq4_k_m
- For Limited RAM (8-12GB):
q4_0
orq3_k_m
- For Very Limited RAM (<8GB):
q2_k
Usage
With Ollama
- Create a Modelfile:
echo 'FROM "./deepseek-r1-qwen3-8b-q4_k_m.gguf"
PARAMETER temperature 0.1
PARAMETER top_p 0.8
PARAMETER top_k 40
PARAMETER repeat_penalty 1.1
PARAMETER num_ctx 4096
PARAMETER stop "<|im_end|>"
PARAMETER stop "<|endoftext|>"
TEMPLATE """<|im_start|>system
{{ .System }}<|im_end|>
<|im_start|>user
{{ .Prompt }}<|im_end|>
<|im_start|>assistant
"""
SYSTEM """You are DeepSeek-R1, a helpful AI assistant created by DeepSeek. Please provide helpful, accurate, and thoughtful responses."""' > Modelfile
- Create the model:
ollama create deepseek-r1 -f Modelfile
- Run the model:
ollama run deepseek-r1 "Explain quantum computing"
With llama.cpp
# Download a quantization
wget https://huggingface.co/[your-username]/[repo-name]/resolve/main/deepseek-r1-qwen3-8b-q4_k_m.gguf
# Run inference
./llama-cli -m deepseek-r1-qwen3-8b-q4_k_m.gguf -p "Hello, how are you?" -n 128
Chat Template
<|im_start|>system {system_prompt}<|im_end|> <|im_start|>user {user_message}<|im_end|> <|im_start|>assistant
Model Capabilities
- Chain-of-Thought Reasoning: Advanced problem-solving with step-by-step thinking
- Code Generation: Programming assistance across multiple languages
- Mathematical Problem Solving: Complex mathematical reasoning
- General Question Answering: Comprehensive knowledge across domains
- Creative Writing: Story generation, content creation
Hardware Requirements
Quantization | Minimum RAM | Recommended RAM | GPU VRAM (optional) |
---|---|---|---|
bf16/f16 | 16 GB | 24 GB | 16 GB |
q8_0 | 10 GB | 16 GB | 10 GB |
q6_k | 8 GB | 12 GB | 8 GB |
q4_k_m | 6 GB | 8 GB | 6 GB |
q3_k_m | 5 GB | 6 GB | 4 GB |
q2_k | 4 GB | 5 GB | 3 GB |
Important Notes
- These are quantized versions with some quality trade-offs compared to the original model
- Performance and quality decrease with smaller quantizations
- Test different quantizations to find the best balance for your use case
- The model exhibits chain-of-thought reasoning capabilities - allow longer generation for complex problems
How to Download Specific Models
Method 1: Using Python Script (Recommended)
Create a Python script to download any specific quantization:
#!/usr/bin/env python3
"""
Download specific GGUF model from Hugging Face repository
"""
import os
from huggingface_hub import hf_hub_download
from pathlib import Path
def download_gguf_model(filename="deepseek-r1-qwen3-8b-q4_k_m.gguf"):
# Configuration
repo_id = "muranAI/DeepSeek-R1-0528-Qwen3-8B-GGUF"
local_dir = "gguf_models"
# Create local directory if it doesn't exist
Path(local_dir).mkdir(exist_ok=True)
print(f"Downloading {filename} from {repo_id}...")
print(f"Saving to: {local_dir}/")
try:
# Download the file
downloaded_path = hf_hub_download(
repo_id=repo_id,
filename=filename,
local_dir=local_dir,
resume_download=True # Resume if download was interrupted
)
print(f"✅ Successfully downloaded: {downloaded_path}")
# Get file size
file_size = os.path.getsize(downloaded_path)
file_size_gb = file_size / (1024**3)
print(f"📊 File size: {file_size_gb:.2f} GB")
return downloaded_path
except Exception as e:
print(f"❌ Error downloading {filename}: {str(e)}")
return None
if __name__ == "__main__":
# Download specific model - change filename as needed
download_gguf_model("deepseek-r1-qwen3-8b-q4_k_m.gguf")
Usage:
pip install huggingface_hub
python download_model.py
Available filenames:
deepseek-r1-qwen3-8b-bf16.gguf
(15.0 GB)deepseek-r1-qwen3-8b-q8_0.gguf
(8.1 GB)deepseek-r1-qwen3-8b-q6_k.gguf
(6.3 GB)deepseek-r1-qwen3-8b-q5_k_m.gguf
(5.4 GB)deepseek-r1-qwen3-8b-q5_k_s.gguf
(5.3 GB)deepseek-r1-qwen3-8b-q4_1.gguf
(4.9 GB)deepseek-r1-qwen3-8b-q4_k_m.gguf
(4.7 GB)deepseek-r1-qwen3-8b-iq4_nl.gguf
(4.5 GB)deepseek-r1-qwen3-8b-q4_k_s.gguf
(4.5 GB)deepseek-r1-qwen3-8b-q4_0.gguf
(4.4 GB)deepseek-r1-qwen3-8b-iq4_xs.gguf
(4.3 GB)deepseek-r1-qwen3-8b-q3_k_l.gguf
(4.1 GB)deepseek-r1-qwen3-8b-q3_k_m.gguf
(3.8 GB)deepseek-r1-qwen3-8b-iq3_m.gguf
(3.6 GB)deepseek-r1-qwen3-8b-q3_k_s.gguf
(3.5 GB)deepseek-r1-qwen3-8b-iq3_s.gguf
(3.5 GB)deepseek-r1-qwen3-8b-q2_k.gguf
(3.1 GB)
Method 2: Direct Download with wget/curl
Using wget:
# Download q4_k_m (recommended for most users)
wget https://huggingface.co/muranAI/DeepSeek-R1-0528-Qwen3-8B-GGUF/resolve/main/deepseek-r1-qwen3-8b-q4_k_m.gguf
# Download q8_0 (high quality)
wget https://huggingface.co/muranAI/DeepSeek-R1-0528-Qwen3-8B-GGUF/resolve/main/deepseek-r1-qwen3-8b-q8_0.gguf
# Download iq3_m (smaller size)
wget https://huggingface.co/muranAI/DeepSeek-R1-0528-Qwen3-8B-GGUF/resolve/main/deepseek-r1-qwen3-8b-iq3_m.gguf
Using curl:
# Download q4_k_m (recommended for most users)
curl -L -o deepseek-r1-qwen3-8b-q4_k_m.gguf https://huggingface.co/muranAI/DeepSeek-R1-0528-Qwen3-8B-GGUF/resolve/main/deepseek-r1-qwen3-8b-q4_k_m.gguf
Method 3: Using Hugging Face CLI
# Install Hugging Face CLI
pip install huggingface_hub[cli]
# Download specific model
huggingface-cli download muranAI/DeepSeek-R1-0528-Qwen3-8B-GGUF deepseek-r1-qwen3-8b-q4_k_m.gguf --local-dir ./models
# Download multiple models
huggingface-cli download muranAI/DeepSeek-R1-0528-Qwen3-8B-GGUF \
deepseek-r1-qwen3-8b-q4_k_m.gguf \
deepseek-r1-qwen3-8b-q8_0.gguf \
--local-dir ./models
Method 4: Git LFS (Download All Models)
# Clone the entire repository (warning: ~85GB total)
git lfs clone https://huggingface.co/muranAI/DeepSeek-R1-0528-Qwen3-8B-GGUF
# Or clone and download specific files
git clone https://huggingface.co/muranAI/DeepSeek-R1-0528-Qwen3-8B-GGUF
cd DeepSeek-R1-0528-Qwen3-8B-GGUF
git lfs pull --include="deepseek-r1-qwen3-8b-q4_k_m.gguf"
Quick Download Commands by Use Case
For most users (8-16GB RAM):
wget https://huggingface.co/muranAI/DeepSeek-R1-0528-Qwen3-8B-GGUF/resolve/main/deepseek-r1-qwen3-8b-q4_k_m.gguf
For high-end systems (16GB+ RAM):
wget https://huggingface.co/muranAI/DeepSeek-R1-0528-Qwen3-8B-GGUF/resolve/main/deepseek-r1-qwen3-8b-q8_0.gguf
For limited RAM (8GB or less):
wget https://huggingface.co/muranAI/DeepSeek-R1-0528-Qwen3-8B-GGUF/resolve/main/deepseek-r1-qwen3-8b-iq3_m.gguf
For very limited RAM (4-6GB):
wget https://huggingface.co/muranAI/DeepSeek-R1-0528-Qwen3-8B-GGUF/resolve/main/deepseek-r1-qwen3-8b-q2_k.gguf
License
MIT License - See the original model repository for full license details.
Original Model
This is a quantized version of deepseek-ai/DeepSeek-R1-0528-Qwen3-8B. Please refer to the original repository for model details, training information, and research papers.
DeepSeek-R1-0528 Model Card
1. Introduction
The DeepSeek R1 model has undergone a minor version upgrade, with the current version being DeepSeek-R1-0528. In the latest update, DeepSeek R1 has significantly improved its depth of reasoning and inference capabilities by leveraging increased computational resources and introducing algorithmic optimization mechanisms during post-training. The model has demonstrated outstanding performance across various benchmark evaluations, including mathematics, programming, and general logic. Its overall performance is now approaching that of leading models, such as O3 and Gemini 2.5 Pro.
Compared to the previous version, the upgraded model shows significant improvements in handling complex reasoning tasks. For instance, in the AIME 2025 test, the model’s accuracy has increased from 70% in the previous version to 87.5% in the current version. This advancement stems from enhanced thinking depth during the reasoning process: in the AIME test set, the previous model used an average of 12K tokens per question, whereas the new version averages 23K tokens per question.
Beyond its improved reasoning capabilities, this version also offers a reduced hallucination rate, enhanced support for function calling, and better experience for vibe coding.
2. Evaluation Results
DeepSeek-R1-0528
For all our models, the maximum generation length is set to 64K tokens. For benchmarks requiring sampling, we use a temperature of $0.6$, a top-p value of $0.95$, and generate 16 responses per query to estimate pass@1.
Category | Benchmark (Metric) | DeepSeek R1 | DeepSeek R1 0528 |
---|---|---|---|
General | |||
MMLU-Redux (EM) | 92.9 | 93.4 | |
MMLU-Pro (EM) | 84.0 | 85.0 | |
GPQA-Diamond (Pass@1) | 71.5 | 81.0 | |
SimpleQA (Correct) | 30.1 | 27.8 | |
FRAMES (Acc.) | 82.5 | 83.0 | |
Humanity's Last Exam (Pass@1) | 8.5 | 17.7 | |
Code | |||
LiveCodeBench (2408-2505) (Pass@1) | 63.5 | 73.3 | |
Codeforces-Div1 (Rating) | 1530 | 1930 | |
SWE Verified (Resolved) | 49.2 | 57.6 | |
Aider-Polyglot (Acc.) | 53.3 | 71.6 | |
Math | |||
AIME 2024 (Pass@1) | 79.8 | 91.4 | |
AIME 2025 (Pass@1) | 70.0 | 87.5 | |
HMMT 2025 (Pass@1) | 41.7 | 79.4 | |
CNMO 2024 (Pass@1) | 78.8 | 86.9 | |
Tools | |||
BFCL_v3_MultiTurn (Acc) | - | 37.0 | |
Tau-Bench (Pass@1) | - | 53.5(Airline)/63.9(Retail) |
DeepSeek-R1-0528-Qwen3-8B
Meanwhile, we distilled the chain-of-thought from DeepSeek-R1-0528 to post-train Qwen3 8B Base, obtaining DeepSeek-R1-0528-Qwen3-8B. This model achieves state-of-the-art (SOTA) performance among open-source models on the AIME 2024, surpassing Qwen3 8B by +10.0% and matching the performance of Qwen3-235B-thinking. We believe that the chain-of-thought from DeepSeek-R1-0528 will hold significant importance for both academic research on reasoning models and industrial development focused on small-scale models.
AIME 24 | AIME 25 | HMMT Feb 25 | GPQA Diamond | LiveCodeBench (2408-2505) | |
---|---|---|---|---|---|
Qwen3-235B-A22B | 85.7 | 81.5 | 62.5 | 71.1 | 66.5 |
Qwen3-32B | 81.4 | 72.9 | - | 68.4 | - |
Qwen3-8B | 76.0 | 67.3 | - | 62.0 | - |
Phi-4-Reasoning-Plus-14B | 81.3 | 78.0 | 53.6 | 69.3 | - |
Gemini-2.5-Flash-Thinking-0520 | 82.3 | 72.0 | 64.2 | 82.8 | 62.3 |
o3-mini (medium) | 79.6 | 76.7 | 53.3 | 76.8 | 65.9 |
DeepSeek-R1-0528-Qwen3-8B | 86.0 | 76.3 | 61.5 | 61.1 | 60.5 |
3. Chat Website & API Platform
You can chat with DeepSeek-R1 on DeepSeek's official website: chat.deepseek.com, and switch on the button "DeepThink"
We also provide OpenAI-Compatible API at DeepSeek Platform: platform.deepseek.com
4. How to Run Locally
Please visit DeepSeek-R1 repository for more information about running DeepSeek-R1-0528 locally.
Compared to previous versions of DeepSeek-R1, the usage recommendations for DeepSeek-R1-0528 have the following changes:
- System prompt is supported now.
- It is not required to add "<think>\n" at the beginning of the output to force the model into thinking pattern.
The model architecture of DeepSeek-R1-0528-Qwen3-8B is identical to that of Qwen3-8B, but it shares the same tokenizer configuration as DeepSeek-R1-0528. This model can be run in the same manner as Qwen3-8B, but it is essential to ensure that all configuration files are sourced from our repository rather than the original Qwen3 project.
System Prompt
In the official DeepSeek web/app, we use the same system prompt with a specific date.
该助手为DeepSeek-R1,由深度求索公司创造。
今天是{current date}。
For example,
该助手为DeepSeek-R1,由深度求索公司创造。
今天是2025年5月28日,星期一。
Temperature
In our web and application environments, the temperature parameter $T_{model}$ is set to 0.6.
Prompts for File Uploading and Web Search
For file uploading, please follow the template to create prompts, where {file_name}, {file_content} and {question} are arguments.
file_template = \
"""[file name]: {file_name}
[file content begin]
{file_content}
[file content end]
{question}"""
For Web Search, {search_results}, {cur_date}, and {question} are arguments. For Chinese query, we use the prompt:
search_answer_zh_template = \
'''# 以下内容是基于用户发送的消息的搜索结果:
{search_results}
在我给你的搜索结果中,每个结果都是[webpage X begin]...[webpage X end]格式的,X代表每篇文章的数字索引。请在适当的情况下在句子末尾引用上下文。请按照引用编号[citation:X]的格式在答案中对应部分引用上下文。如果一句话源自多个上下文,请列出所有相关的引用编号,例如[citation:3][citation:5],切记不要将引用集中在最后返回引用编号,而是在答案对应部分列出。
在回答时,请注意以下几点:
- 今天是{cur_date}。
- 并非搜索结果的所有内容都与用户的问题密切相关,你需要结合问题,对搜索结果进行甄别、筛选。
- 对于列举类的问题(如列举所有航班信息),尽量将答案控制在10个要点以内,并告诉用户可以查看搜索来源、获得完整信息。优先提供信息完整、最相关的列举项;如非必要,不要主动告诉用户搜索结果未提供的内容。
- 对于创作类的问题(如写论文),请务必在正文的段落中引用对应的参考编号,例如[citation:3][citation:5],不能只在文章末尾引用。你需要解读并概括用户的题目要求,选择合适的格式,充分利用搜索结果并抽取重要信息,生成符合用户要求、极具思想深度、富有创造力与专业性的答案。你的创作篇幅需要尽可能延长,对于每一个要点的论述要推测用户的意图,给出尽可能多角度的回答要点,且务必信息量大、论述详尽。
- 如果回答很长,请尽量结构化、分段落总结。如果需要分点作答,尽量控制在5个点以内,并合并相关的内容。
- 对于客观类的问答,如果问题的答案非常简短,可以适当补充一到两句相关信息,以丰富内容。
- 你需要根据用户要求和回答内容选择合适、美观的回答格式,确保可读性强。
- 你的回答应该综合多个相关网页来回答,不能重复引用一个网页。
- 除非用户要求,否则你回答的语言需要和用户提问的语言保持一致。
# 用户消息为:
{question}'''
For English query, we use the prompt:
search_answer_en_template = \
'''# The following contents are the search results related to the user's message:
{search_results}
In the search results I provide to you, each result is formatted as [webpage X begin]...[webpage X end], where X represents the numerical index of each article. Please cite the context at the end of the relevant sentence when appropriate. Use the citation format [citation:X] in the corresponding part of your answer. If a sentence is derived from multiple contexts, list all relevant citation numbers, such as [citation:3][citation:5]. Be sure not to cluster all citations at the end; instead, include them in the corresponding parts of the answer.
When responding, please keep the following points in mind:
- Today is {cur_date}.
- Not all content in the search results is closely related to the user's question. You need to evaluate and filter the search results based on the question.
- For listing-type questions (e.g., listing all flight information), try to limit the answer to 10 key points and inform the user that they can refer to the search sources for complete information. Prioritize providing the most complete and relevant items in the list. Avoid mentioning content not provided in the search results unless necessary.
- For creative tasks (e.g., writing an essay), ensure that references are cited within the body of the text, such as [citation:3][citation:5], rather than only at the end of the text. You need to interpret and summarize the user's requirements, choose an appropriate format, fully utilize the search results, extract key information, and generate an answer that is insightful, creative, and professional. Extend the length of your response as much as possible, addressing each point in detail and from multiple perspectives, ensuring the content is rich and thorough.
- If the response is lengthy, structure it well and summarize it in paragraphs. If a point-by-point format is needed, try to limit it to 5 points and merge related content.
- For objective Q&A, if the answer is very brief, you may add one or two related sentences to enrich the content.
- Choose an appropriate and visually appealing format for your response based on the user's requirements and the content of the answer, ensuring strong readability.
- Your answer should synthesize information from multiple relevant webpages and avoid repeatedly citing the same webpage.
- Unless the user requests otherwise, your response should be in the same language as the user's question.
# The user's message is:
{question}'''
5. License
This code repository is licensed under MIT License. The use of DeepSeek-R1 models is also subject to MIT License. DeepSeek-R1 series (including Base and Chat) supports commercial use and distillation.
6. Citation
@misc{deepseekai2025deepseekr1incentivizingreasoningcapability,
title={DeepSeek-R1: Incentivizing Reasoning Capability in LLMs via Reinforcement Learning},
author={DeepSeek-AI},
year={2025},
eprint={2501.12948},
archivePrefix={arXiv},
primaryClass={cs.CL},
url={https://arxiv.org/abs/2501.12948},
}
7. Contact
If you have any questions, please raise an issue or contact us at [email protected].
- Downloads last month
- 151
Model tree for muranAI/DeepSeek-R1-0528-Qwen3-8B-GGUF
Base model
deepseek-ai/DeepSeek-R1-0528-Qwen3-8B