GitHub – Deepseek-ai/DeepSeek-V3

We provide DeepSeek-V3, a strong Mixture-of-Experts (MoE) language design with 671B total specifications with 37B activated for each token. To accomplish efficient inference and economical training, DeepSeek-V3 adopts Multi-head Latent Attention (MLA) and DeepSeekMoE architectures, which were completely verified in DeepSeek-V2. Furthermore, DeepSeek-V3 leaders an auxiliary-loss-free method for load balancing and sets a multi-token forecast training objective for more powerful performance. We pre-train DeepSeek-V3 on 14.8 trillion varied and premium tokens, followed by Supervised Fine-Tuning and Reinforcement Learning stages to totally harness its abilities. Comprehensive examinations expose that DeepSeek-V3 exceeds other open-source designs and attains efficiency similar to leading closed-source designs. Despite its exceptional efficiency, DeepSeek-V3 requires only 2.788 M H800 GPU hours for its full training. In addition, its training process is remarkably steady. Throughout the whole training process, we did not experience any irrecoverable loss spikes or perform any rollbacks.

2. Model Summary

Architecture: Innovative Load Balancing Strategy and Training Objective

– On top of the efficient architecture of DeepSeek-V2, we pioneer an auxiliary-loss-free method for load balancing, which decreases the efficiency degradation that emerges from motivating load .
– We investigate a Multi-Token Prediction (MTP) goal and prove it beneficial to model performance. It can likewise be used for speculative decoding for inference velocity.

Pre-Training: Towards Ultimate Training Efficiency

– We design an FP8 combined accuracy training framework and, for the first time, validate the expediency and effectiveness of FP8 training on an exceptionally massive design.
– Through co-design of algorithms, structures, and hardware, we conquer the interaction bottleneck in cross-node MoE training, nearly accomplishing complete computation-communication overlap.
This considerably enhances our training efficiency and reduces the training expenses, allowing us to even more scale up the design size without extra overhead.
– At a cost-effective expense of only 2.664 M H800 GPU hours, we complete the pre-training of DeepSeek-V3 on 14.8 T tokens, producing the presently greatest open-source base design. The subsequent training stages after pre-training require only 0.1 M GPU hours.

Post-Training: Knowledge Distillation from DeepSeek-R1

– We present an ingenious methodology to distill reasoning capabilities from the long-Chain-of-Thought (CoT) design, particularly from one of the DeepSeek R1 series designs, into standard LLMs, especially DeepSeek-V3. Our pipeline elegantly incorporates the verification and reflection patterns of R1 into DeepSeek-V3 and especially improves its thinking performance. Meanwhile, we likewise keep a control over the output design and length of DeepSeek-V3.

3. Model Downloads

The total size of DeepSeek-V3 designs on Hugging Face is 685B, that includes 671B of the Main Model weights and 14B of the Multi-Token Prediction (MTP) Module weights. **

To guarantee optimal efficiency and versatility, we have actually partnered with open-source neighborhoods and hardware vendors to offer multiple methods to run the model locally. For detailed guidance, have a look at Section 6: How_to Run_Locally.

For designers seeking to dive much deeper, we recommend exploring README_WEIGHTS. md for information on the Main Model weights and the Multi-Token Prediction (MTP) Modules. Please note that MTP assistance is currently under active development within the community, and we invite your contributions and feedback.

4. Evaluation Results

Base Model

Standard Benchmarks

Best outcomes are displayed in strong. Scores with a space not going beyond 0.3 are considered to be at the exact same level. DeepSeek-V3 attains the very best performance on most standards, especially on math and code jobs. For more evaluation details, please examine our paper.

Context Window

Evaluation results on the Needle In A Haystack (NIAH) tests. DeepSeek-V3 carries out well across all context window lengths as much as 128K.

Chat Model

Standard Benchmarks (Models bigger than 67B)

All designs are assessed in a configuration that limits the output length to 8K. Benchmarks including fewer than 1000 samples are tested several times using differing temperature level settings to obtain robust final outcomes. DeepSeek-V3 stands as the best-performing open-source design, and likewise shows competitive performance against frontier closed-source models.

Open Ended Generation Evaluation

English open-ended conversation assessments. For AlpacaEval 2.0, we use the length-controlled win rate as the metric.

5. Chat Website & API Platform

You can chat with DeepSeek-V3 on DeepSeek’s official site: chat.deepseek.com

We likewise offer OpenAI-Compatible API at DeepSeek Platform: platform.deepseek.com

6. How to Run Locally

DeepSeek-V3 can be released locally utilizing the following hardware and open-source neighborhood software:

DeepSeek-Infer Demo: We supply a basic and lightweight demonstration for FP8 and BF16 inference.
SGLang: Fully support the DeepSeek-V3 design in both BF16 and FP8 inference modes, with Multi-Token Prediction coming soon.
LMDeploy: Enables effective FP8 and BF16 inference for local and cloud deployment.
TensorRT-LLM: Currently supports BF16 reasoning and INT4/8 quantization, with FP8 support coming soon.
vLLM: Support DeepSeek-V3 model with FP8 and BF16 modes for tensor parallelism and pipeline parallelism.
AMD GPU: Enables running the DeepSeek-V3 design on AMD GPUs through SGLang in both BF16 and FP8 modes.
Huawei Ascend NPU: Supports running DeepSeek-V3 on Huawei Ascend gadgets.
Since FP8 training is natively adopted in our structure, we just provide FP8 weights. If you need BF16 weights for experimentation, you can use the provided conversion script to perform the transformation.

Here is an example of transforming FP8 weights to BF16:

Hugging Face’s Transformers has actually not been directly supported yet. **

6.1 Inference with DeepSeek-Infer Demo (example only)

System Requirements

Note

Linux with Python 3.10 just. Mac and Windows are not supported.

Dependencies:

Model Weights & Demo Code Preparation

First, clone our DeepSeek-V3 GitHub repository:

Navigate to the reasoning folder and set up reliances noted in requirements.txt. Easiest method is to use a plan manager like conda or uv to produce a new virtual environment and set up the dependencies.

Download the design weights from Hugging Face, and put them into/ path/to/DeepSeek-V 3 folder.

Model Weights Conversion

Convert Hugging Face model weights to a particular format:

Run

Then you can chat with DeepSeek-V3:

Or batch reasoning on a provided file:

6.2 Inference with SGLang (suggested)

SGLang currently supports MLA optimizations, DP Attention, FP8 (W8A8), FP8 KV Cache, and Torch Compile, providing advanced latency and throughput performance amongst open-source structures.

Notably, SGLang v0.4.1 completely supports running DeepSeek-V3 on both NVIDIA and AMD GPUs, making it a highly versatile and robust solution.

SGLang also supports multi-node tensor parallelism, allowing you to run this model on several network-connected devices.

Multi-Token Prediction (MTP) remains in advancement, and progress can be tracked in the optimization plan.

Here are the launch directions from the SGLang group: https://github.com/sgl-project/sglang/tree/main/benchmark/deepseek_v3

6.3 Inference with LMDeploy (recommended)

LMDeploy, a versatile and high-performance reasoning and serving framework tailored for big language designs, now supports DeepSeek-V3. It uses both offline pipeline processing and online release abilities, seamlessly incorporating with PyTorch-based workflows.

For extensive detailed guidelines on running DeepSeek-V3 with LMDeploy, please describe here: InternLM/lmdeploy # 2960

6.4 Inference with TRT-LLM (suggested)

TensorRT-LLM now supports the DeepSeek-V3 design, using precision options such as BF16 and INT4/INT8 weight-only. Support for FP8 is currently in development and will be released quickly. You can access the custom branch of TRTLLM particularly for DeepSeek-V3 assistance through the following link to experience the brand-new functions directly: https://github.com/NVIDIA/TensorRT-LLM/tree/deepseek/examples/deepseek_v3.

6.5 Inference with vLLM (recommended)

vLLM v0.6.6 supports DeepSeek-V3 reasoning for FP8 and BF16 modes on both NVIDIA and AMD GPUs. Aside from standard techniques, vLLM offers pipeline parallelism enabling you to run this design on numerous machines linked by networks. For comprehensive guidance, please describe the vLLM directions. Please feel complimentary to follow the improvement strategy as well.

6.6 Recommended Inference Functionality with AMD GPUs

In collaboration with the AMD group, we have accomplished Day-One support for AMD GPUs using SGLang, with full compatibility for both FP8 and BF16 accuracy. For in-depth assistance, please describe the SGLang instructions.

6.7 Recommended Inference Functionality with Huawei Ascend NPUs

The MindIE structure from the Huawei Ascend community has successfully adapted the BF16 version of DeepSeek-V3. For detailed assistance on Ascend NPUs, please follow the guidelines here.

7. License

This code repository is accredited under the MIT License. Making use of DeepSeek-V3 Base/Chat designs goes through the Model License. DeepSeek-V3 series (including Base and Chat) supports business usage.