Introduction
DeepSeek-V4-Flash is one of two models in the V4 series released by DeepSeek. It uses a Mixture of Experts (MoE) architecture with 284B total parameters, only 13B of which are activated, and supports a context length of up to 1 million tokens. Architecturally, the model introduces a hybrid attention mechanism, manifold-constrained hyperconnections, and the Muon optimizer. Pre-training data exceeds 32T tokens, and post-training follows a two-stage paradigm — first independently cultivating domain experts via SFT and GRPO reinforcement learning, then unifying multi-domain capabilities into a single model through online policy distillation. In maximum reasoning mode, a larger thinking budget allows its reasoning performance to approach that of the Pro version; however, due to its smaller parameter scale, it falls slightly short of Pro on pure knowledge tasks and the most complex agent workflows.
Integrated Deployment
- Out-of-the-box inference scripts with pre-configured hardware and software parameters
- Released FlagOS-Kunlunxin container image supporting deployment within minutes
Consistency Validation
- Rigorously evaluated through benchmark testing: Performance and results from the FlagOS software stack are compared against native stacks on multiple public.
Evaluation Results
Benchmark Result
| Metrics | DeepSeek-V4-Flash-Nvidia-Origin | DeepSeek-V4-Flash-Kunlunxin-FlagOS |
|---|
| GPQA | 0.697 | 0.6111 |
| Aime | 0.7333 | 0.6667 |
User Guide
Environment Setup
| Item | Version |
|---|
| Docker Version | Docker version 28.2.2, build e6534b4 |
| Operating System | 22.04.4 LTS (Jammy Jellyfish) |
Operation Steps
Download FlagOS Image
1
2docker pull harbor.baai.ac.cn/flagrelease-public/flagrelease-kunlunxin-deepseek:202604232050
3
Download Open-source Model Weights
1pip install modelscope
2modelscope download --model FlagRelease/DeepSeek-V4-Flash-kunlunxin-FlagOS --local_dir /data/DeepSeek-V4-Flash-kunlunxin-FlagOS
Start the Container
1docker run -dti --name flagos \
2 --net=host --security-opt=seccomp=unconfined \
3 --cap-add=SYS_PTRACE --shm-size=256g --cap-add=SYS_ADMIN \
4 --device /dev/fuse --restart=always --ulimit=memlock=-1 \
5 --ulimit=nofile=120000 --ulimit=stack=67108864 \
6 -v /tmp:/tmp \
7 -v /data:/data \
8 -v /public-nvme:/public-nvme \
9 --cpuset-cpus=0-120 \
10 --device=/dev/xpu0:/dev/xpu0 --device=/dev/xpu1:/dev/xpu1 \
11 --device=/dev/xpu2:/dev/xpu2 --device=/dev/xpu3:/dev/xpu3 \
12 --device=/dev/xpu4:/dev/xpu4 --device=/dev/xpu5:/dev/xpu5 \
13 --device=/dev/xpu6:/dev/xpu6 --device=/dev/xpu7:/dev/xpu7 \
14 --device=/dev/xpuctrl:/dev/xpuctrl --privileged \
15 harbor.baai.ac.cn/flagrelease-public/flagrelease-kunlunxin-deepseek:202604232050 /bin/bash
16docker exec -it flagos /bin/bash
Service Invocation
Invocation Script
1cd /workspace/code_ds_v4/
2# 测试三条gpqa
3bash test_gpqa_0.sh
4bash test_gpqa_2.sh
5bash test_gpqa_5.sh
6
7# The reasoning answers are DDA
8
Using FlagOS Source Code for Installation and Deployment
Installing the FlagOS Operator Library
1# Install base dependencies
2pip install -r requirements.txt
3pip install flag-gems==5.0.2
Installing the FlagOS Compiler
1# The installation command uses the NVIDIA platform as an example:
2python3 -m pip uninstall -y triton
3python3 -m pip install flagtree===0.5.0 --index-url=https://resource.flagos.net/repository/flagos-pypi-hosted/simple
Deploying with the DeepSeek-V4-FlagOS Code Repository
Use the following command, or run bash run_mp8.sh directly:
1export USE_FLAGGEMS=1 # Enable acceleration
2torchrun --nproc-per-node 8 generate.py \
3 --max-new-tokens 64 \
4 --ckpt-path /path/to/model_bf16_mp8 \
5 --config config_from_bf16.json \
6 --input-file prompt.txt
Node 0:
Use the following command, or run bash run_node_0.sh directly on Node 0:
1export NCCL_SOCKET_IFNAME=eth0
2export NCCL_IB_DISABLE=1
3export USE_FLAGGEMS=1
4export USE_OGROUPS_COMM=1
5
6torchrun --nnodes=2 --nproc_per_node=8 --node_rank=0 \
7 --master_addr=<master_ip> --master_port=29500 generate.py \
8 --ckpt-path /path/to/model_bf16_mp16 \
9 --config config_from_bf16.json \
10 --input-file prompt.txt \
11 --max-new-tokens 64
Node 1:
Use the following command, or run bash run_node_1.sh directly on Node 1:
1export NCCL_SOCKET_IFNAME=eth0
2export NCCL_IB_DISABLE=1
3export USE_FLAGGEMS=1
4export USE_OGROUPS_COMM=1
5
6torchrun --nnodes=2 --nproc_per_node=8 --node_rank=1 \
7 --master_addr=<master_ip> --master_port=29500 generate.py \
8 --ckpt-path /path/to/model_bf16_mp16 \
9 --config config_from_bf16.json \
10 --input-file prompt.txt \
11 --max-new-tokens 64
Technical Overview
FlagOS is a fully open-source system software stack designed to unify the "model–system–chip" layers and foster an open, collaborative ecosystem. It enables a “develop once, run anywhere” workflow across diverse AI accelerators, unlocking hardware performance, eliminating fragmentation among vendor-specific software stacks, and substantially lowering the cost of porting and maintaining AI workloads. With core technologies such as the FlagScale, together with vllm-plugin-fl, distributed training/inference framework, FlagGems universal operator library, FlagCX communication library, and FlagTree unified compiler, the FlagRelease platform leverages the FlagOS stack to automatically produce and release various combinations of <chip + open-source model>. This enables efficient and automated model migration across diverse chips, opening a new chapter for large model deployment and application.
FlagGems
FlagGems is a high-performance, generic operator libraryimplemented in
Triton language. It is built on a collection of backend-neutralkernels that aims to accelerate LLM (Large-Language Models) training and inference across diverse hardware platforms.
FlagTree
FlagTree is an open source, unified compiler for multipleAI chips project dedicated to developing a diverse ecosystem of AI chip compilers and related tooling platforms, thereby fostering and strengthening the upstream and downstream Triton ecosystem. Currently in its initial phase, the project aims to maintain compatibility with existing adaptation solutions while unifying the codebase to rapidly implement single-repository multi-backend support. Forupstream model users, it provides unified compilation capabilities across multiple backends; for downstream chip manufacturers, it offers examples of Triton ecosystem integration.
FlagScale and vllm-plugin-fl
Flagscale is a comprehensive toolkit designed to supportthe entire lifecycle of large models. It builds on the strengths of several prominent open-source projects, including
Megatron-LM and
vLLM, to provide a robust, end-to-end solution for managing and scaling large models.
vllm-plugin-fl is a vLLM plugin built on the FlagOS unified multi-chip backend, to help flagscale support multi-chip on vllm framework.
FlagCX
FlagCX is a scalable and adaptive cross-chip communication library. It serves as a platform where developers, researchers, and AI engineers can collaborate on various projects, contribute to the development of cutting-edge AI solutions, and share their work with the global community.
FlagEval Evaluation Framework
FlagEval is a comprehensive evaluation system and open platform for large models launched in 2023. It aims to establish scientific, fair, and open benchmarks, methodologies, and tools to help researchers assess model and training algorithm performance. It features:
- Multi-dimensional Evaluation: Supports 800+ modelevaluations across NLP, CV, Audio, and Multimodal fields,covering 20+ downstream tasks including language understanding and image-text generation.
- Industry-Grade Use Cases: Has completed horizonta1 evaluations of mainstream large models, providing authoritative benchmarks for chip-model performance validation.
Contributing
We warmly welcome global developers to join us:
- Submit Issues to report problems
- Create Pull Requests to contribute code
- Improve technical documentation
- Expand hardware adaptation support
License
The model weights are derived from deepseek-ai/DeepSeek-V4-Flash and are open‑sourced under the Apache License 2.0:
https://www.apache.org/licenses/LICENSE-2.0.txt