Upload folder using huggingface_hub

.gitattributes

@@ -35,3 +35,6 @@ saved_model/**/* filter=lfs diff=lfs merge=lfs -text
 *tfevents* filter=lfs diff=lfs merge=lfs -text
 DeepSeek-R1-Distill-Qwen-1.5B-baseline.gguf filter=lfs diff=lfs merge=lfs -text
 DeepSeek-R1-Distill-Qwen-1.5B-pct5.gguf filter=lfs diff=lfs merge=lfs -text
+benchmark_plots/gpqa_pass1_benchmark.png filter=lfs diff=lfs merge=lfs -text
+benchmark_plots/gsm8k_benchmark.png filter=lfs diff=lfs merge=lfs -text
+benchmark_plots/math500_pass1_benchmark.png filter=lfs diff=lfs merge=lfs -text

README.md

@@ -10,4 +10,393 @@ library_name: transformers
 language:
 - en
 license: mit
----
+---
+# Dheyo Dynamic Quantization: Compact Quantized Models for DeepSeek-R1-Distill-Qwen-1.5B with Strong Reasoning Accuracy
+
+<br>
+
+* * *
+
+<br>
+
+## Introduction
+
+The **DeepSeek-R1-Distill-Qwen-1.5B** model is a distilled variant of the Qwen language model, designed to offer efficient inference while preserving strong reasoning capabilities. Quantization is commonly used to compress models by representing their weights and activations in reduced precision formats, improving speed and memory efficiency.
+
+This report presents a comparative study of quantized variants of the **DeepSeek-R1-Distill-Qwen-1.5B** language model. Two models developed using quantization-aware training (QAT) are evaluated: **DheyoAI/DeepSeek-R1-Distill-Qwen-1.5B-baseline (Dheyo baseline)** (1.74 GB) and **DheyoAI/DeepSeek-R1-Distill-Qwen-1.5B-pct5 (Dheyo pct5)** (1.57 GB). These models are benchmarked against the original full-precision model **deepseek-ai/DeepSeek-R1-Distill-Qwen-1.5B** (3.39 GB) and two quantized baselines from Unsloth: **unsloth/DeepSeek-R1-Distill-Qwen-1.5B-Q8\_0** (1.89 GB) and **unsloth/DeepSeek-R1-Distill-Qwen-1.5B-Q5\_K\_M** (1.29 GB).
+
+<br>
+
+* * *
+
+<br>
+
+## TL;DR
+
+- **DheyoAI/DeepSeek-R1-Distill-Qwen-1.5B-baseline** (Dheyo baseline) is a quantized 1.74 GB model with the highest GSM8K accuracy (78.92%) among all variants.
+- It outperforms **unsloth/DeepSeek-R1-Distill-Qwen-1.5B-Q8\_0** on GPQA Diamond (31.82% vs 18.19%) despite being smaller.
+- Math500 accuracy (79.8%) is close to the full model and Unsloth Q8\_0, with consistent AIME 2024 performance.
+- **DheyoAI/DeepSeek-R1-Distill-Qwen-1.5B-pct5** (Dheyo pct) compresses further to 1.57 GB with GSM8K accuracy of 77.18%.
+- It scores 28.28% on GPQA Diamond and 80.2% on Math500, maintaining strong accuracy with lower size.
+- Both models lie within the accuracy–size “Sweet Spot” and are efficient for reasoning tasks under memory constraints.
+
+<br>
+
+* * *
+
+<br>
+
+## Why These Models Were Compared
+
+To assess the effectiveness of Dheyo Quantization, we evaluate two Dheyo models, **DheyoAI/DeepSeek-R1-Distill-Qwen-1.5B-baseline (Dheyo baseline)** (1.74 GB) and **DheyoAI/DeepSeek-R1-Distill-Qwen-1.5B-pct5 (Dheyo pct5)** (1.57 GB) against relevant baselines with similar architecture and comparable size. 
+
+The original full-precision model (BFloat16), **deepseek-ai/DeepSeek-R1-Distill-Qwen-1.5B** (3.39 GB), is included to serve as an upper bound on reasoning accuracy without any compression. 
+
+For quantized baselines, we use **unsloth/DeepSeek-R1-Distill-Qwen-1.5B-Q8\_0** (1.89 GB) and **unsloth/DeepSeek-R1-Distill-Qwen-1.5B-Q5\_K\_M** (1.29 GB), as their model sizes are similar to the Dheyo quantized model variants.
+
+<br>
+
+* * *
+
+<br>
+
+## Hardware Used
+
+The quantization-aware training (QAT) of the Dheyo models and the benchmarking of all model variants were conducted on a cluster equipped with **AMD Instinct MI300X GPUs**. Each GPU provides 192 GB of HBM3 memory and high memory bandwidth, making them well-suited for running large quantized models efficiently. All evaluations were performed using the **llama.cpp** backend, optimized for low-precision inference.
+
+<br>
+
+* * *
+
+<br>
+
+## Benchmark Results
+
+### Math500 Pass@1 and GPQA Diamond Pass@1 Benchmarks
+
+Math500 Pass@1 and GPQA Diamond Pass@1evaluations follow the official usage recommendations provided by DeepSeek. Specifically, inference was run with temperature = 0.6, max\_length = 32678, and prompt format as recommended. The benchmark results presented here were obtained using these exact settings.
+
+We evaluate model performance on two reasoning benchmarks: **Math500 Pass@1**, which measures symbolic math accuracy, and **GPQA Diamond Pass@1**, which tests factual multiple-choice science questions.
+
+<br>
+
+| **Model** | **GPQA Diamond Pass@1 (%)** | **Math500 Pass@1 (%)** | **Size (GB)** |
+| --- | --- | --- | --- |
+| deepseek-ai/DeepSeek-R1-Distill-Qwen-1.5B | 33.8 | 83.9 | 3.39 |
+| DheyoAI/DeepSeek-R1-Distill-Qwen-1.5B-baseline | **31.82** | 79.8 | 1.74 |
+| DheyoAI/DeepSeek-R1-Distill-Qwen-1.5B-pct5 | 28.28 | 80.2 | 1.57 |
+| unsloth/DeepSeek-R1-Distill-Qwen-1.5B-Q8\_0 | 18.19 | **81.4** | 1.89 |
+| unsloth/DeepSeek-R1-Distill-Qwen-1.5B-Q5\_K\_M | 19.7 | 76.8 | 1.29 |
+
+_Note: Bold values indicate the best-performing quantized model; underlined values indicate the second-best._
+
+<br>
+
+On **GPQA Diamond Pass@1**, both Dheyo models maintain relatively high factual accuracy while reducing model size significantly compared to the full-precision baseline. The **Dheyo baseline model scores 31.82% and the smaller pct5 variant scores 28.28%**, both within a few points of the original’s 33.8%. The Unsloth variants show lower performance in this benchmark.
+
+In Figure 1, both Dheyo models fall well within the green “Sweet Spot” which indicates a favorable balance between factual accuracy and model size relative to the Unsloth quantized models. Their positioning reflects efficient performance on factual QA tasks relative to their memory footprint.
+
+![](benchmark_plots/gpqa_pass1_benchmark.png)<br>
+
+_Figure 1: ⁠Factual Reasoning (GPQA Diamond Pass@1): Accuracy vs Model Size_
+
+**<br>
+**
+
+In **Math500 Pass@1**, the Dheyo models perform consistently, **scoring 79.8% (Dheyo baseline) and 80.2% (Dheyo pct)** as shown in Figure 2. While unsloth/DeepSeek-R1-Distill-Qwen-1.5B-Q8\_0 achieves slightly higher accuracy at 81.4%, it does so with a larger model size.   
+![](benchmark_plots/math500_pass1_benchmark.png)
+
+_Figure 2: ⁠Symbolic Math (Math500): Accuracy vs Model Size_
+
+## <br>
+
+### GSM8K Benchmark
+
+All GSM8K evaluations follow temperature = 0.8, max\_length = 1024, and prompt as recommended. Dheyo baseline and pct5 models were trained using quantization-aware training (QAT) on 95% of the GSM8K training data.
+
+<br>
+
+| **Model** | **GSM8K Accuracy (%)** | **Model Size (GB)** |
+| --- | --- | --- |
+| deepseek-ai/DeepSeek-R1-Distill-Qwen-1.5B | 76.88 | 3.39 |
+| DheyoAI/DeepSeek-R1-Distill-Qwen-1.5B-baseline | 78.92 | 1.74 |
+| DheyoAI/DeepSeek-R1-Distill-Qwen-1.5B-pct5 | 77.18 | 1.57 |
+| unsloth/DeepSeek-R1-Distill-Qwen-1.5B-Q8\_0 | 78.47 | 1.89 |
+| unsloth/DeepSeek-R1-Distill-Qwen-1.5B-Q5\_K\_M | 76.65 | 1.29 |
+
+<br>
+
+The **Dheyo baseline model achieves the highest GSM8K accuracy at 78.92**%, outperforming all other models in this evaluation, including the original full-precision model and Unsloth Q8\_0. The **Dheyo pct5 model also performs well at 77.18%**, with a further reduction in size to 1.57 GB.
+
+In the GSM8K figure, Dheyo baseline model lies inside the green “Sweet Spot”.
+
+![](benchmark_plots/gsm8k_benchmark.png)<br>
+
+_Figure 3: Arithmetic Reasoning (GSM8K): Accuracy vs Model Size_
+
+<br>
+
+### AIME 2024 Benchmarks
+
+Cons@64 checks whether the most frequently predicted answer across 64 attempts by the model is correct. It measures if the model consistently converges on the right answer. 
+
+The **Dheyo baseline model**, marked in red in Figure 4, achieves an accuracy of **53.33%**, which is the highest observed, matching the performance of the Unsloth quantized model and outperforming the original DeepSeek-AI model (52.70%)
+
+<br>
+
+| **Dataset** | DheyoAI/DeepSeek-R1-Distill-Qwen-1.5B-baseline | unsloth/DeepSeek-R1-Distill-Qwen-1.5B-Q8\_0 | deepseek-ai/DeepSeek-R1-Distill-Qwen-1.5B |
+| --- | --- | --- | --- |
+| AIME 2024 Cons@64 | 53.33 | 53.33 | 52.70 |
+
+<br>
+
+![](benchmark_plots/aime_cons%4064_benchmark_plot.png)<br>
+
+_Figure 4: ⁠AIME 2024: Accuracy Comparison on Cons@64_
+
+### <br>
+
+* * *
+
+<br>
+
+---
+license: mit
+library_name: transformers
+---
+# DeepSeek-R1
+<!-- markdownlint-disable first-line-h1 -->
+<!-- markdownlint-disable html -->
+<!-- markdownlint-disable no-duplicate-header -->
+
+<div align="center">
+  <img src="https://github.com/deepseek-ai/DeepSeek-V2/blob/main/figures/logo.svg?raw=true" width="60%" alt="DeepSeek-V3" />
+</div>
+<hr>
+<div align="center" style="line-height: 1;">
+  <a href="https://www.deepseek.com/" target="_blank" style="margin: 2px;">
+    <img alt="Homepage" src="https://github.com/deepseek-ai/DeepSeek-V2/blob/main/figures/badge.svg?raw=true" style="display: inline-block; vertical-align: middle;"/>
+  </a>
+  <a href="https://chat.deepseek.com/" target="_blank" style="margin: 2px;">
+    <img alt="Chat" src="https://img.shields.io/badge/🤖%20Chat-DeepSeek%20R1-536af5?color=536af5&logoColor=white" style="display: inline-block; vertical-align: middle;"/>
+  </a>
+  <a href="https://huggingface.co/deepseek-ai" target="_blank" style="margin: 2px;">
+    <img alt="Hugging Face" src="https://img.shields.io/badge/%F0%9F%A4%97%20Hugging%20Face-DeepSeek%20AI-ffc107?color=ffc107&logoColor=white" style="display: inline-block; vertical-align: middle;"/>
+  </a>
+</div>
+
+<div align="center" style="line-height: 1;">
+  <a href="https://discord.gg/Tc7c45Zzu5" target="_blank" style="margin: 2px;">
+    <img alt="Discord" src="https://img.shields.io/badge/Discord-DeepSeek%20AI-7289da?logo=discord&logoColor=white&color=7289da" style="display: inline-block; vertical-align: middle;"/>
+  </a>
+  <a href="https://github.com/deepseek-ai/DeepSeek-V2/blob/main/figures/qr.jpeg?raw=true" target="_blank" style="margin: 2px;">
+    <img alt="Wechat" src="https://img.shields.io/badge/WeChat-DeepSeek%20AI-brightgreen?logo=wechat&logoColor=white" style="display: inline-block; vertical-align: middle;"/>
+  </a>
+  <a href="https://twitter.com/deepseek_ai" target="_blank" style="margin: 2px;">
+    <img alt="Twitter Follow" src="https://img.shields.io/badge/Twitter-deepseek_ai-white?logo=x&logoColor=white" style="display: inline-block; vertical-align: middle;"/>
+  </a>
+</div>
+
+<div align="center" style="line-height: 1;">
+  <a href="https://github.com/deepseek-ai/DeepSeek-R1/blob/main/LICENSE" style="margin: 2px;">
+    <img alt="License" src="https://img.shields.io/badge/License-MIT-f5de53?&color=f5de53" style="display: inline-block; vertical-align: middle;"/>
+  </a>
+</div>
+
+
+<p align="center">
+  <a href="https://github.com/deepseek-ai/DeepSeek-R1/blob/main/DeepSeek_R1.pdf"><b>Paper Link</b>👁️</a>
+</p>
+
+
+## 1. Introduction
+
+We introduce our first-generation reasoning models, DeepSeek-R1-Zero and DeepSeek-R1. 
+DeepSeek-R1-Zero, a model trained via large-scale reinforcement learning (RL) without supervised fine-tuning (SFT) as a preliminary step, demonstrated remarkable performance on reasoning.
+With RL, DeepSeek-R1-Zero naturally emerged with numerous powerful and interesting reasoning behaviors.
+However, DeepSeek-R1-Zero encounters challenges such as endless repetition, poor readability, and language mixing. To address these issues and further enhance reasoning performance,
+we introduce DeepSeek-R1, which incorporates cold-start data before RL.
+DeepSeek-R1 achieves performance comparable to OpenAI-o1 across math, code, and reasoning tasks. 
+To support the research community, we have open-sourced DeepSeek-R1-Zero, DeepSeek-R1, and six dense models distilled from DeepSeek-R1 based on Llama and Qwen. DeepSeek-R1-Distill-Qwen-32B outperforms OpenAI-o1-mini across various benchmarks, achieving new state-of-the-art results for dense models.
+
+**NOTE: Before running DeepSeek-R1 series models locally, we kindly recommend reviewing the [Usage Recommendation](#usage-recommendations) section.**
+
+<p align="center">
+  <img width="80%" src="figures/benchmark.jpg">
+</p>
+
+## 2. Model Summary
+
+---
+
+**Post-Training: Large-Scale Reinforcement Learning on the Base Model**
+
+-  We directly apply reinforcement learning (RL) to the base model without relying on supervised fine-tuning (SFT) as a preliminary step. This approach allows the model to explore chain-of-thought (CoT) for solving complex problems, resulting in the development of DeepSeek-R1-Zero. DeepSeek-R1-Zero demonstrates capabilities such as self-verification, reflection, and generating long CoTs, marking a significant milestone for the research community. Notably, it is the first open research to validate that reasoning capabilities of LLMs can be incentivized purely through RL, without the need for SFT. This breakthrough paves the way for future advancements in this area.
+
+-   We introduce our pipeline to develop DeepSeek-R1. The pipeline incorporates two RL stages aimed at discovering improved reasoning patterns and aligning with human preferences, as well as two SFT stages that serve as the seed for the model's reasoning and non-reasoning capabilities.
+    We believe the pipeline will benefit the industry by creating better models. 
+
+---
+
+**Distillation: Smaller Models Can Be Powerful Too**
+
+-  We demonstrate that the reasoning patterns of larger models can be distilled into smaller models, resulting in better performance compared to the reasoning patterns discovered through RL on small models. The open source DeepSeek-R1, as well as its API, will benefit the research community to distill better smaller models in the future. 
+- Using the reasoning data generated by DeepSeek-R1, we fine-tuned several dense models that are widely used in the research community. The evaluation results demonstrate that the distilled smaller dense models perform exceptionally well on benchmarks. We open-source distilled 1.5B, 7B, 8B, 14B, 32B, and 70B checkpoints based on Qwen2.5 and Llama3 series to the community.
+
+## 3. Model Downloads
+
+### DeepSeek-R1 Models
+
+<div align="center">
+
+| **Model** | **#Total Params** | **#Activated Params** | **Context Length** | **Download** |
+| :------------: | :------------: | :------------: | :------------: | :------------: |
+| DeepSeek-R1-Zero | 671B | 37B | 128K   | [🤗 HuggingFace](https://huggingface.co/deepseek-ai/DeepSeek-R1-Zero)   |
+| DeepSeek-R1   | 671B | 37B |  128K   | [🤗 HuggingFace](https://huggingface.co/deepseek-ai/DeepSeek-R1)   |
+
+</div>
+
+DeepSeek-R1-Zero & DeepSeek-R1 are trained based on DeepSeek-V3-Base. 
+For more details regarding the model architecture, please refer to [DeepSeek-V3](https://github.com/deepseek-ai/DeepSeek-V3) repository.
+
+### DeepSeek-R1-Distill Models
+
+<div align="center">
+
+| **Model** | **Base Model** | **Download** |
+| :------------: | :------------: | :------------: |
+| DeepSeek-R1-Distill-Qwen-1.5B  | [Qwen2.5-Math-1.5B](https://huggingface.co/Qwen/Qwen2.5-Math-1.5B) | [🤗 HuggingFace](https://huggingface.co/deepseek-ai/DeepSeek-R1-Distill-Qwen-1.5B)   |
+| DeepSeek-R1-Distill-Qwen-7B  | [Qwen2.5-Math-7B](https://huggingface.co/Qwen/Qwen2.5-Math-7B) | [🤗 HuggingFace](https://huggingface.co/deepseek-ai/DeepSeek-R1-Distill-Qwen-7B)   |
+| DeepSeek-R1-Distill-Llama-8B  | [Llama-3.1-8B](https://huggingface.co/meta-llama/Llama-3.1-8B) | [🤗 HuggingFace](https://huggingface.co/deepseek-ai/DeepSeek-R1-Distill-Llama-8B)   |
+| DeepSeek-R1-Distill-Qwen-14B   | [Qwen2.5-14B](https://huggingface.co/Qwen/Qwen2.5-14B) | [🤗 HuggingFace](https://huggingface.co/deepseek-ai/DeepSeek-R1-Distill-Qwen-14B)   |
+|DeepSeek-R1-Distill-Qwen-32B  | [Qwen2.5-32B](https://huggingface.co/Qwen/Qwen2.5-32B) | [��� HuggingFace](https://huggingface.co/deepseek-ai/DeepSeek-R1-Distill-Qwen-32B)   |
+| DeepSeek-R1-Distill-Llama-70B  | [Llama-3.3-70B-Instruct](https://huggingface.co/meta-llama/Llama-3.3-70B-Instruct) | [🤗 HuggingFace](https://huggingface.co/deepseek-ai/DeepSeek-R1-Distill-Llama-70B)   |
+
+</div>
+
+DeepSeek-R1-Distill models are fine-tuned based on open-source models, using samples generated by DeepSeek-R1.
+We slightly change their configs and tokenizers. Please use our setting to run these models.
+
+## 4. Evaluation Results
+
+### DeepSeek-R1-Evaluation
+ For all our models, the maximum generation length is set to 32,768 tokens. For benchmarks requiring sampling, we use a temperature of $0.6$, a top-p value of $0.95$, and generate 64 responses per query to estimate pass@1.
+<div align="center">
+
+
+| Category | Benchmark (Metric) | Claude-3.5-Sonnet-1022 | GPT-4o 0513 | DeepSeek V3 | OpenAI o1-mini | OpenAI o1-1217 | DeepSeek R1 |
+|----------|-------------------|----------------------|------------|--------------|----------------|------------|--------------|
+| | Architecture | - | - | MoE | - | - | MoE |
+| | # Activated Params | - | - | 37B | - | - | 37B |
+| | # Total Params | - | - | 671B | - | - | 671B |
+| English | MMLU (Pass@1) | 88.3 | 87.2 | 88.5 | 85.2 | **91.8** | 90.8 |
+| | MMLU-Redux (EM) | 88.9 | 88.0 | 89.1 | 86.7 | - | **92.9** |
+| | MMLU-Pro (EM) | 78.0 | 72.6 | 75.9 | 80.3 | - | **84.0** |
+| | DROP (3-shot F1) | 88.3 | 83.7 | 91.6 | 83.9 | 90.2 | **92.2** |
+| | IF-Eval (Prompt Strict) | **86.5** | 84.3 | 86.1 | 84.8 | - | 83.3 |
+| | GPQA-Diamond (Pass@1) | 65.0 | 49.9 | 59.1 | 60.0 | **75.7** | 71.5 |
+| | SimpleQA (Correct) | 28.4 | 38.2 | 24.9 | 7.0 | **47.0** | 30.1 |
+| | FRAMES (Acc.) | 72.5 | 80.5 | 73.3 | 76.9 | - | **82.5** |
+| | AlpacaEval2.0 (LC-winrate) | 52.0 | 51.1 | 70.0 | 57.8 | - | **87.6** |
+| | ArenaHard (GPT-4-1106) | 85.2 | 80.4 | 85.5 | 92.0 | - | **92.3** |
+| Code | LiveCodeBench (Pass@1-COT) | 33.8 | 34.2 | - | 53.8 | 63.4 | **65.9** |
+| | Codeforces (Percentile) | 20.3 | 23.6 | 58.7 | 93.4 | **96.6** | 96.3 |
+| | Codeforces (Rating) | 717 | 759 | 1134 | 1820 | **2061** | 2029 |
+| | SWE Verified (Resolved) | **50.8** | 38.8 | 42.0 | 41.6 | 48.9 | 49.2 |
+| | Aider-Polyglot (Acc.) | 45.3 | 16.0 | 49.6 | 32.9 | **61.7** | 53.3 |
+| Math | AIME 2024 (Pass@1) | 16.0 | 9.3 | 39.2 | 63.6 | 79.2 | **79.8** |
+| | MATH-500 (Pass@1) | 78.3 | 74.6 | 90.2 | 90.0 | 96.4 | **97.3** |
+| | CNMO 2024 (Pass@1) | 13.1 | 10.8 | 43.2 | 67.6 | - | **78.8** |
+| Chinese | CLUEWSC (EM) | 85.4 | 87.9 | 90.9 | 89.9 | - | **92.8** |
+| | C-Eval (EM) | 76.7 | 76.0 | 86.5 | 68.9 | - | **91.8** |
+| | C-SimpleQA (Correct) | 55.4 | 58.7 | **68.0** | 40.3 | - | 63.7 |
+
+</div>
+
+
+### Distilled Model Evaluation
+
+
+<div align="center">
+
+| Model                                    | AIME 2024 pass@1 | AIME 2024 cons@64 | MATH-500 pass@1 | GPQA Diamond pass@1 | LiveCodeBench pass@1 | CodeForces rating |
+|------------------------------------------|------------------|-------------------|-----------------|----------------------|----------------------|-------------------|
+| GPT-4o-0513                          | 9.3              | 13.4              | 74.6            | 49.9                 | 32.9                 | 759               |
+| Claude-3.5-Sonnet-1022             | 16.0             | 26.7                 | 78.3            | 65.0                 | 38.9                 | 717               |
+| o1-mini                              | 63.6             | 80.0              | 90.0            | 60.0                 | 53.8                 | **1820**          |
+| QwQ-32B-Preview                              | 44.0             | 60.0                 | 90.6            | 54.5               | 41.9                 | 1316              |
+| DeepSeek-R1-Distill-Qwen-1.5B       | 28.9             | 52.7              | 83.9            | 33.8                 | 16.9                 | 954               |
+| DeepSeek-R1-Distill-Qwen-7B          | 55.5             | 83.3              | 92.8            | 49.1                 | 37.6                 | 1189              |
+| DeepSeek-R1-Distill-Qwen-14B         | 69.7             | 80.0              | 93.9            | 59.1                 | 53.1                 | 1481              |
+| DeepSeek-R1-Distill-Qwen-32B        | **72.6**         | 83.3              | 94.3            | 62.1                 | 57.2                 | 1691              |
+| DeepSeek-R1-Distill-Llama-8B         | 50.4             | 80.0              | 89.1            | 49.0                 | 39.6                 | 1205              |
+| DeepSeek-R1-Distill-Llama-70B        | 70.0             | **86.7**          | **94.5**        | **65.2**             | **57.5**             | 1633              |
+
+</div>
+
+
+## 5. Chat Website & API Platform
+You can chat with DeepSeek-R1 on DeepSeek's official website: [chat.deepseek.com](https://chat.deepseek.com), and switch on the button "DeepThink"
+
+We also provide OpenAI-Compatible API at DeepSeek Platform: [platform.deepseek.com](https://platform.deepseek.com/)
+
+## 6. How to Run Locally
+
+### DeepSeek-R1 Models
+
+Please visit [DeepSeek-V3](https://github.com/deepseek-ai/DeepSeek-V3) repo for more information about running DeepSeek-R1 locally.
+
+**NOTE: Hugging Face's Transformers has not been directly supported yet.**
+
+### DeepSeek-R1-Distill Models
+
+DeepSeek-R1-Distill models can be utilized in the same manner as Qwen or Llama models.
+
+For instance, you can easily start a service using [vLLM](https://github.com/vllm-project/vllm):
+
+```shell
+vllm serve deepseek-ai/DeepSeek-R1-Distill-Qwen-32B --tensor-parallel-size 2 --max-model-len 32768 --enforce-eager
+```
+
+You can also easily start a service using [SGLang](https://github.com/sgl-project/sglang)
+
+```bash
+python3 -m sglang.launch_server --model deepseek-ai/DeepSeek-R1-Distill-Qwen-32B --trust-remote-code --tp 2
+```
+
+### Usage Recommendations
+
+**We recommend adhering to the following configurations when utilizing the DeepSeek-R1 series models, including benchmarking, to achieve the expected performance:**
+
+1. Set the temperature within the range of 0.5-0.7 (0.6 is recommended) to prevent endless repetitions or incoherent outputs.
+2. **Avoid adding a system prompt; all instructions should be contained within the user prompt.**
+3. For mathematical problems, it is advisable to include a directive in your prompt such as: "Please reason step by step, and put your final answer within \boxed{}."
+4. When evaluating model performance, it is recommended to conduct multiple tests and average the results.
+
+Additionally, we have observed that the DeepSeek-R1 series models tend to bypass thinking pattern (i.e., outputting "\<think\>\n\n\</think\>") when responding to certain queries, which can adversely affect the model's performance.
+**To ensure that the model engages in thorough reasoning, we recommend enforcing the model to initiate its response with "\<think\>\n" at the beginning of every output.**
+
+## 7. License
+This code repository and the model weights are licensed under the [MIT License](https://github.com/deepseek-ai/DeepSeek-R1/blob/main/LICENSE).
+DeepSeek-R1 series support commercial use, allow for any modifications and derivative works, including, but not limited to, distillation for training other LLMs. Please note that:
+- DeepSeek-R1-Distill-Qwen-1.5B, DeepSeek-R1-Distill-Qwen-7B, DeepSeek-R1-Distill-Qwen-14B and DeepSeek-R1-Distill-Qwen-32B are derived from [Qwen-2.5 series](https://github.com/QwenLM/Qwen2.5), which are originally licensed under [Apache 2.0 License](https://huggingface.co/Qwen/Qwen2.5-1.5B/blob/main/LICENSE), and now finetuned with 800k samples curated with DeepSeek-R1.
+- DeepSeek-R1-Distill-Llama-8B is derived from Llama3.1-8B-Base and is originally licensed under [llama3.1 license](https://huggingface.co/meta-llama/Llama-3.1-8B/blob/main/LICENSE).
+- DeepSeek-R1-Distill-Llama-70B is derived from Llama3.3-70B-Instruct and is originally licensed under [llama3.3 license](https://huggingface.co/meta-llama/Llama-3.3-70B-Instruct/blob/main/LICENSE).
+
+## 8. 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}, 
+}
+
+```
+
+## 9. Contact
+If you have any questions, please raise an issue or contact us at [service@deepseek.com](service@deepseek.com).
+