We provide DeepSeek-V3, a strong Mixture-of-Experts (MoE) language design with 671B overall specifications with 37B activated for each token. To accomplish effective inference and cost-efficient training, DeepSeek-V3 adopts Multi-head Latent Attention (MLA) and DeepSeekMoE architectures, which were thoroughly verified in DeepSeek-V2. Furthermore, DeepSeek-V3 pioneers an auxiliary-loss-free method for load balancing and sets a multi-token prediction training goal for more powerful performance. We pre-train DeepSeek-V3 on 14.8 trillion diverse and premium tokens, followed by Supervised Fine-Tuning and Reinforcement Learning phases to fully harness its abilities. Comprehensive evaluations reveal that DeepSeek-V3 exceeds other open-source designs and accomplishes efficiency similar to leading closed-source models. Despite its outstanding performance, DeepSeek-V3 needs only 2.788 M H800 GPU hours for its full training. In addition, its training process is remarkably steady. Throughout the whole training procedure, 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 leader an auxiliary-loss-free method for load balancing, which lessens the performance degradation that arises from motivating load balancing.
- We investigate a Multi-Token Prediction (MTP) goal and show it beneficial to model performance. It can also be utilized for speculative decoding for reasoning velocity.


Pre-Training: Towards Ultimate Training Efficiency


- We create an FP8 mixed precision training framework and, for the very first time, validate the expediency and efficiency of FP8 training on a very large-scale design.
- Through co-design of algorithms, frameworks, and hardware, we conquer the interaction bottleneck in cross-node MoE training, almost accomplishing complete computation-communication overlap.
This considerably improves our training effectiveness and reduces the training costs, allowing us to further scale up the design size without additional overhead.
- At an affordable cost 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 need just 0.1 M GPU hours.


Post-Training: Knowledge Distillation from DeepSeek-R1


- We present an ingenious approach to boil down reasoning abilities from the long-Chain-of-Thought (CoT) model, particularly from one of the DeepSeek R1 series designs, into basic LLMs, particularly DeepSeek-V3. Our pipeline elegantly integrates the confirmation and reflection patterns of R1 into DeepSeek-V3 and notably improves its reasoning efficiency. Meanwhile, we likewise keep a control over the output design and length of DeepSeek-V3.


3. Model Downloads


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


To make sure optimal efficiency and flexibility, we have actually partnered with open-source neighborhoods and hardware vendors to provide multiple methods to run the design locally. For step-by-step guidance, have a look at Section 6: How_to Run_Locally.


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


4. Evaluation Results


Base Model


Standard Benchmarks


Best results are displayed in strong. Scores with a gap not exceeding 0.3 are thought about to be at the same level. DeepSeek-V3 accomplishes the best performance on a lot of benchmarks, specifically on mathematics 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 approximately 128K.


Chat Model


Standard Benchmarks (Models larger than 67B)


All models are evaluated in a configuration that restricts the output length to 8K. Benchmarks including fewer than 1000 samples are checked several times utilizing varying temperature level settings to obtain robust outcomes. DeepSeek-V3 stands as the best-performing open-source model, and likewise displays competitive efficiency against frontier closed-source designs.


Open Ended Generation Evaluation


English open-ended conversation examinations. For AlpacaEval 2.0, we utilize 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 supply OpenAI-Compatible API at DeepSeek Platform: platform.deepseek.com


6. How to Run Locally


DeepSeek-V3 can be deployed in your area using the following hardware and open-source neighborhood software application:


DeepSeek-Infer Demo: We offer a simple and light-weight demonstration for FP8 and BF16 reasoning.
SGLang: Fully support the DeepSeek-V3 model in both BF16 and FP8 reasoning modes, with Multi-Token Prediction coming soon.
LMDeploy: Enables efficient FP8 and BF16 inference for local and cloud release.
TensorRT-LLM: Currently supports BF16 inference and INT4/8 quantization, with FP8 support coming quickly.
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 by means of SGLang in both BF16 and FP8 modes.
Huawei Ascend NPU: Supports running DeepSeek-V3 on Huawei Ascend devices.
Since FP8 training is natively adopted in our framework, we only offer FP8 weights. If you require BF16 weights for experimentation, you can utilize the offered conversion script to carry out the change.


Here is an example of transforming FP8 weights to BF16:


Hugging Face's Transformers has actually not been straight 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 inference folder and set up reliances noted in requirements.txt. Easiest way is to utilize a package supervisor like conda or uv to create a new virtual environment and set up the reliances.


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


Model Weights Conversion


Convert Hugging Face model weights to a specific format:


Run


Then you can chat with DeepSeek-V3:


Or batch reasoning on a given file:


6.2 Inference with SGLang (advised)


SGLang presently supports MLA optimizations, DP Attention, FP8 (W8A8), FP8 KV Cache, and Torch Compile, delivering modern latency and throughput efficiency amongst open-source structures.


Notably, SGLang v0.4.1 fully supports running DeepSeek-V3 on both NVIDIA and AMD GPUs, making it an extremely versatile and robust service.


SGLang also supports multi-node tensor parallelism, enabling you to run this design on multiple network-connected devices.


Multi-Token Prediction (MTP) is in development, and progress can be tracked in the optimization strategy.


Here are the launch guidelines from the SGLang group: https://github.com/sgl-project/sglang/t … eepseek_v3


6.3 Inference with LMDeploy (recommended)


LMDeploy, a flexible and high-performance inference and serving framework tailored for large language models, now supports DeepSeek-V3. It uses both offline pipeline processing and online release abilities, flawlessly incorporating with PyTorch-based workflows.


For detailed step-by-step instructions on running DeepSeek-V3 with LMDeploy, please refer to here: InternLM/lmdeploy # 2960


6.4 Inference with TRT-LLM (suggested)


TensorRT-LLM now supports the DeepSeek-V3 model, using precision choices such as BF16 and INT4/INT8 weight-only. Support for FP8 is presently in development and will be launched soon. You can access the customized branch of TRTLLM specifically for DeepSeek-V3 support through the following link to experience the brand-new functions directly: https://github.com/NVIDIA/TensorRT-LLM/ … epseek_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 basic techniques, vLLM offers pipeline parallelism permitting you to run this model on several machines linked by networks. For comprehensive guidance, please refer to the vLLM directions. Please do not hesitate to follow the enhancement plan also.


6.6 Recommended Inference Functionality with AMD GPUs


In collaboration with the AMD team, we have actually attained Day-One assistance for AMD GPUs using SGLang, with complete compatibility for both FP8 and BF16 precision. For comprehensive assistance, please describe the SGLang guidelines.


6.7 Recommended Inference Functionality with Huawei Ascend NPUs


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


7. License


This code repository is certified under the MIT License. The use of DeepSeek-V3 Base/Chat designs undergoes the Model License. DeepSeek-V3 series (consisting of Base and Chat) supports commercial use.