.gitattributes CHANGED
@@ -34,11 +34,3 @@ saved_model/**/* filter=lfs diff=lfs merge=lfs -text
34
  *.zst filter=lfs diff=lfs merge=lfs -text
35
  *tfevents* filter=lfs diff=lfs merge=lfs -text
36
  tokenizer.json filter=lfs diff=lfs merge=lfs -text
37
- assets/bench_cn1.png filter=lfs diff=lfs merge=lfs -text
38
- assets/bench_en2.png filter=lfs diff=lfs merge=lfs -text
39
- assets/bench_cn2.png filter=lfs diff=lfs merge=lfs -text
40
- assets/bench_en1.png filter=lfs diff=lfs merge=lfs -text
41
- assets/benchmark_appendix_en_reasoning.png filter=lfs diff=lfs merge=lfs -text
42
- assets/benchmark_appendix_en_multimodal.png filter=lfs diff=lfs merge=lfs -text
43
- assets/benchmark_appendix_cn_reasoning.png filter=lfs diff=lfs merge=lfs -text
44
- assets/benchmark_appendix_cn_multimodal.png filter=lfs diff=lfs merge=lfs -text
 
34
  *.zst filter=lfs diff=lfs merge=lfs -text
35
  *tfevents* filter=lfs diff=lfs merge=lfs -text
36
  tokenizer.json filter=lfs diff=lfs merge=lfs -text
 
 
 
 
 
 
 
 
README.md CHANGED
@@ -14,8 +14,10 @@ tags:
14
 
15
  ---
16
 
 
 
17
  <p align="left">
18
- <a href="https://huggingface.co/dots-studio/dots3-note-prev-fp8/blob/main/README_CN.md">中文</a>&nbsp;|&nbsp;English
19
  </p>
20
  <br>
21
 
@@ -25,13 +27,13 @@ tags:
25
  </div>
26
 
27
  <div align="center" style="line-height: 1;">
28
- <a href="https://github.com/studio-dots-ai/dots3-note-prev"><img alt="GitHub: studio-dots-ai" src="https://img.shields.io/badge/GitHub-studio--dots--ai-181717?logo=github&amp;logoColor=white" /></a>
29
- <a href="https://github.com/huggingface/transformers/pull/47844"><img alt="Transformers: dots3-note" src="https://img.shields.io/badge/Transformers-dots3--note-yellow" /></a>
30
- <a href="https://github.com/sgl-project/sglang/pull/33829"><img alt="SGLang: dots3-note" src="https://img.shields.io/badge/SGLang-dots3--note-blue" /></a>
31
- <a href="https://recipes.vllm.ai/dots-studio/dots3-note-prev"><img alt="vLLM: dots3-note" src="https://img.shields.io/badge/vLLM-dots3--note-red" /></a>
32
- <a href="https://modelscope.cn/collections/dots-studio/dots3-note"><img alt="ModelScope: dots-studio" src="https://img.shields.io/badge/ModelScope-dots--studio-624AFF" /></a>
33
-
34
- <a href="https://www.xiaohongshu.com/user/profile/683ffe42000000001d021a4c"><img alt="Dots Studio" src="https://img.shields.io/badge/RedNote-Dots%20Studio-FF2442" /></a>
35
  <a href="https://discord.gg/haym6hEUE"><img alt="Discord" src="https://img.shields.io/badge/Discord-Join-5865F2?logo=discord&amp;logoColor=white" /></a>
36
  <a href="https://x.com/dotsstudioai"><img alt="X: dotsstudioai" src="https://img.shields.io/badge/X-%40dotsstudioai-black" /></a>
37
  <a href="#license"><img alt="License: Apache 2.0" src="https://img.shields.io/badge/License-Apache%202.0-blue" /></a>
@@ -39,12 +41,11 @@ tags:
39
 
40
  <p align="center">
41
  🌐&nbsp;<a href="https://studio.dots.ai/dots/dots3-en.html"><b>Tech Blog</b></a>&nbsp;&nbsp;|&nbsp;&nbsp;
 
42
  📄&nbsp;<b>Full Report (coming soon)</b>
43
  </p>
44
 
45
- <div align="center">
46
- <h3>Try <b>dots3-note Preview</b> for free at&nbsp;<a href="https://openrouter.ai/dots-studio/dots-3-note-preview:free" style="vertical-align: middle;"><img alt="OpenRouter: dots3-note" src="https://img.shields.io/badge/OpenRouter-dots3--note-6366F1?logo=openrouter&amp;logoColor=white" /></a></h3>
47
- </div>
48
 
49
  ---
50
 
@@ -52,38 +53,45 @@ tags:
52
  ## Table of Contents
53
 
54
  - [Model Introduction](#model-introduction)
55
- - [Model Overview](#model-overview)
56
- - [Evaluation Results](#evaluation-results)
57
- - [General Reasoning and Agent](#general-reasoning-and-agent)
58
- - [Multimodal Understanding](#multimodal-understanding)
59
  - [Model Links](#model-links)
60
  - [Quickstart](#quickstart)
61
  - [Deployment](#deployment)
62
  - [Transformers](#transformers)
63
  - [SGLang](#sglang)
64
  - [vLLM](#vllm)
65
- - [Benchmark Appendix](#benchmark-appendix)
66
  - [License](#license)
 
67
  - [Contact Us](#contact-us)
68
 
69
  ---
70
 
71
  ## Model Introduction
72
 
73
- dots3-note preview is the first open-weight model in the dots3 family. It is a Mixture-of-Experts model with 280B total parameters, 16B activated parameters, and support for a context length of up to 512K tokens. The model can understand text, images, video, and audio, and produces text outputs.
74
-
75
  dots3-note preview is optimized for a broad range of tasks, including:
 
 
 
 
 
 
 
 
 
 
 
 
 
 
76
 
77
- - General knowledge and instruction following;
78
- - Mathematical and logical reasoning;
79
- - Tool use and multi-step agent workflows;
80
- - Interactive tasks that require exploration, memory updates, and adaptation;
81
- - Code generation and code-based problem solving;
82
- - Image, document, chart, audio, and video understanding;
83
- - Long-context information processing.
84
 
85
- The dots3 family is designed to include models with different trade-offs among capability, latency, and inference cost. dots3-note preview is the most lightweight member of the family.
86
 
 
87
 
88
 
89
  ## Model Overview
@@ -95,10 +103,10 @@ The dots3 family is designed to include models with different trade-offs among c
95
  | Activated Parameters | 16B |
96
  | MTP | 1 shared layer, 1.13B |
97
  | Number of Layers | 1 dense + 45 MoE |
98
- | Hidden Size | 5120 |
99
- | FFN Hidden Size | 13824 (dense), 1536 (per expert) |
100
  | Experts | 256 routed + 1 shared, top-8 |
101
- | Attention | 13 DSA + 33 SWA (~1:3) |
102
  | DSA | Top-2048 |
103
  | Context Length | 512K |
104
  | Vocabulary Size | 152K |
@@ -113,18 +121,13 @@ The dots3 family is designed to include models with different trade-offs among c
113
 
114
  ### General Reasoning and Agent
115
 
116
- ![General Reasoning and Agent evaluation results](assets/bench_en1.png)
117
-
118
- ### Multimodal Understanding
119
-
120
- ![Multimodal Understanding evaluation results](assets/bench_en2.png)
121
 
122
  ## Model Links
123
 
124
  | Model Name | Description | HuggingFace | ModelScope |
125
  | --- | --- | --- | --- |
126
- | dots3-note-prev | Preview multimodal model | 🤗 [Model](https://huggingface.co/dots-studio/dots3-note-prev) | <span style="white-space: nowrap;"><img src="https://modelscope.cn/favicon.ico" width="16" alt="ModelScope" style="display: inline-block; vertical-align: middle; margin: 0;" />&nbsp;<a href="https://modelscope.cn/models/dots-studio/dots3-note-prev">Model</a></span> |
127
- | dots3-note-prev-fp8 | FP8-quantized preview multimodal model | 🤗 [Model](https://huggingface.co/dots-studio/dots3-note-prev-fp8) | <span style="white-space: nowrap;"><img src="https://modelscope.cn/favicon.ico" width="16" alt="ModelScope" style="display: inline-block; vertical-align: middle; margin: 0;" />&nbsp;<a href="https://modelscope.cn/models/dots-studio/dots3-note-prev-fp8">Model</a></span> |
128
 
129
  ## Quickstart
130
 
@@ -175,7 +178,7 @@ Video inputs include their audio track when available.
175
 
176
  The commands below target FP8 on one 8-GPU node. BF16 requires more memory. Tune the context length to available memory, concurrency, and input modalities.
177
 
178
- Native support is available on [vLLM](https://recipes.vllm.ai/dots-studio/dots3-note-prev) `main`. [Transformers #47844](https://github.com/huggingface/transformers/pull/47844) and [SGLang #33829](https://github.com/sgl-project/sglang/pull/33829) are still under review; until they are merged, use the PR revisions below.
179
 
180
  ### Transformers
181
 
@@ -208,7 +211,7 @@ outputs = model.generate(**inputs, max_new_tokens=128)
208
  print(processor.decode(outputs[0, inputs.input_ids.shape[1] :], skip_special_tokens=True))
209
  ```
210
 
211
- Use SGLang or vLLM for multi-GPU OpenAI-compatible serving.
212
 
213
  ### SGLang
214
 
@@ -221,8 +224,8 @@ Docker (the image downloads the checkpoint from Hugging Face on first run):
221
  docker run --gpus all --ipc=host -p 8000:8000 \
222
  lmsysorg/sglang:dev-dots3-note \
223
  sglang serve \
224
- --model-path dots-studio/dots3-note-prev-fp8 \
225
- --served-model-name dots3-note-prev \
226
  --host 0.0.0.0 \
227
  --port 8000 \
228
  --context-length 524288 \
@@ -240,7 +243,7 @@ docker run --gpus all --ipc=host -p 8000:8000 \
240
  --speculative-num-steps 3 \
241
  --speculative-eagle-topk 1 \
242
  --speculative-num-draft-tokens 4 \
243
- --speculative-draft-model-path dots-studio/dots3-note-prev-fp8
244
  ```
245
 
246
  Or install from source / the PR and run the same `sglang serve` arguments locally. `--attention-backend fa3` sets prefill, decode, and (when speculative decoding is enabled) draft attention. MTP/NEXTN (`--speculative-algorithm NEXTN` and the related flags) is optional and can reduce TPOT by more than 50%. Prefill CUDA graph is not supported yet.
@@ -257,7 +260,7 @@ Optional features:
257
 
258
  ### vLLM
259
 
260
- Native dots3-note preview support is available on [vLLM](https://recipes.vllm.ai/dots-studio/dots3-note-prev) `main`. Use a recent nightly build until it is included in a stable release.
261
 
262
  The following example deploys the FP8 checkpoint on eight NVIDIA H100 GPUs with TP=8 and EP=8:
263
 
@@ -282,15 +285,8 @@ Optional features:
282
 
283
  # Enable OpenAI-compatible automatic tool calling
284
  --enable-auto-tool-choice --tool-call-parser dots
285
-
286
  ```
287
 
288
- ## Benchmark Appendix
289
-
290
- ![General Reasoning and Agent benchmark appendix](assets/benchmark_appendix_en_reasoning.png)
291
-
292
- ![Multimodal benchmark appendix](assets/benchmark_appendix_en_multimodal.png)
293
-
294
  ## License
295
 
296
  Copyright (c) 2026 Xiaohongshu.
 
14
 
15
  ---
16
 
17
+ <!-- DRAFT: Replace all [TO FILL] fields before release. -->
18
+
19
  <p align="left">
20
+ <a href="https://huggingface.co/dots-studio/dots-3-note-prev-fp8/blob/main/README_CN.md">中文</a>&nbsp;|&nbsp;English
21
  </p>
22
  <br>
23
 
 
27
  </div>
28
 
29
  <div align="center" style="line-height: 1;">
30
+ <a href="https://studio.dots.ai/dots/dots3-en.html"><img alt="Blog: dots3" src="https://img.shields.io/badge/Blog-dots3-blue" /></a>
31
+ <a href="https://www.xiaohongshu.com/user/profile/683ffe42000000001d021a4c?xsec_token=YB7FKyZcxokO1lQbgGrFVcPREY5pD95pemGAVktUdvQ8c%3D&amp;xsec_source=app_share&amp;shareRedId=ODY0QTlGNTs2NzUyOTgwNjY0OTc7PkxL&amp;apptime=1786629429&amp;share_id=4537ac010ec1466d88b7a18f8362b763&amp;share_channel=copy_link&amp;appuid=602a6a1200000000010079fb&amp;xhsshare=CopyLink"><img alt="RedNote: dots-studio" src="https://img.shields.io/badge/RedNote-dots--studio-red" /></a>
32
+ <a href="https://modelscope.cn/organization/dots-studio"><img alt="ModelScope: dots-studio" src="https://img.shields.io/badge/ModelScope-dots--studio-624AFF" /></a>
33
+ <a href="https://github.com/studio-dots-ai"><img alt="GitHub: studio-dots-ai" src="https://img.shields.io/badge/GitHub-studio--dots--ai-181717?logo=github&amp;logoColor=white" /></a>
34
+ <a href="https://github.com/huggingface/transformers"><img alt="Transformers: dots3-note" src="https://img.shields.io/badge/Transformers-dots3--note-yellow" /></a>
35
+ <a href="https://github.com/sgl-project/sglang"><img alt="SGLang: dots3-note" src="https://img.shields.io/badge/SGLang-dots3--note-blue" /></a>
36
+ <a href="https://github.com/vllm-project/vllm"><img alt="vLLM: dots3-note" src="https://img.shields.io/badge/vLLM-dots3--note-red" /></a>
37
  <a href="https://discord.gg/haym6hEUE"><img alt="Discord" src="https://img.shields.io/badge/Discord-Join-5865F2?logo=discord&amp;logoColor=white" /></a>
38
  <a href="https://x.com/dotsstudioai"><img alt="X: dotsstudioai" src="https://img.shields.io/badge/X-%40dotsstudioai-black" /></a>
39
  <a href="#license"><img alt="License: Apache 2.0" src="https://img.shields.io/badge/License-Apache%202.0-blue" /></a>
 
41
 
42
  <p align="center">
43
  🌐&nbsp;<a href="https://studio.dots.ai/dots/dots3-en.html"><b>Tech Blog</b></a>&nbsp;&nbsp;|&nbsp;&nbsp;
44
+ 📕&nbsp;<a href="https://xhslink.cn/m/7vLoWFQV0wN"><b>Dots Studio</b></a>&nbsp;&nbsp;|&nbsp;&nbsp;
45
  📄&nbsp;<b>Full Report (coming soon)</b>
46
  </p>
47
 
48
+ <!-- TODO: Add the Technical Report link when available. -->
 
 
49
 
50
  ---
51
 
 
53
  ## Table of Contents
54
 
55
  - [Model Introduction](#model-introduction)
56
+ - [Multimodal Capabilities](#multimodal-capabilities)
57
+ - [Benchmark Eval](#benchmark-eval)
58
+ - [News](#news)
 
59
  - [Model Links](#model-links)
60
  - [Quickstart](#quickstart)
61
  - [Deployment](#deployment)
62
  - [Transformers](#transformers)
63
  - [SGLang](#sglang)
64
  - [vLLM](#vllm)
 
65
  - [License](#license)
66
+ - [Citation](#citation)
67
  - [Contact Us](#contact-us)
68
 
69
  ---
70
 
71
  ## Model Introduction
72
 
73
+ dots3-note preview is the first open-weight model in the dots-3 family. It is a Mixture-of-Experts model with 280B total parameters, 16B activated parameters, and support for a context length of up to 512K tokens. The model can understand text, images, and audio, and produces text outputs.
 
74
  dots3-note preview is optimized for a broad range of tasks, including:
75
+ general knowledge and instruction following;
76
+ mathematical and logical reasoning;
77
+ tool use and multi-step agent workflows;
78
+ interactive tasks that require exploration, memory updates, and adaptation.
79
+ code generation and code-based problem solving;
80
+ image, document, chart, audio and video understanding;
81
+ long-context information processing;
82
+ The dots-3 family is designed to include models with different trade-offs among capability, latency, and inference cost. dots3-note preview is the most lightweight member of the family.
83
+
84
+ <!--
85
+
86
+ TODO: Add the final architecture figure and uncomment the block below.
87
+
88
+ <p align="center">
89
 
90
+ <img src="assets/architecture.png" width="100%"/>
 
 
 
 
 
 
91
 
92
+ </p>
93
 
94
+ -->
95
 
96
 
97
  ## Model Overview
 
103
  | Activated Parameters | 16B |
104
  | MTP | 1 shared layer, 1.13B |
105
  | Number of Layers | 1 dense + 45 MoE |
106
+ | Hidden Size | 5,120 |
107
+ | FFN Hidden Size | 13,824 (dense), 1,536 (per expert) |
108
  | Experts | 256 routed + 1 shared, top-8 |
109
+ | Attention | MLA, 13 full + 33 SWA (~1:3) |
110
  | DSA | Top-2048 |
111
  | Context Length | 512K |
112
  | Vocabulary Size | 152K |
 
121
 
122
  ### General Reasoning and Agent
123
 
 
 
 
 
 
124
 
125
  ## Model Links
126
 
127
  | Model Name | Description | HuggingFace | ModelScope |
128
  | --- | --- | --- | --- |
129
+ | dots3-note-prev | Preview multimodal model | 🤗 [Model](https://huggingface.co/dots-studio/dots3-note-prev) | <img src="https://modelscope.cn/favicon.ico" width="16" alt="ModelScope" /> [Model](https://modelscope.cn/models/dots-studio/dots3-note-prev) |
130
+ | dots3-note-prev-fp8 | FP8-quantized preview multimodal model | 🤗 [Model](https://huggingface.co/dots-studio/dots3-note-prev-fp8) | <img src="https://modelscope.cn/favicon.ico" width="16" alt="ModelScope" /> [Model](https://modelscope.cn/models/dots-studio/dots3-note-prev-fp8) |
131
 
132
  ## Quickstart
133
 
 
178
 
179
  The commands below target FP8 on one 8-GPU node. BF16 requires more memory. Tune the context length to available memory, concurrency, and input modalities.
180
 
181
+ Native support is available on [vLLM](https://github.com/vllm-project/vllm) `main`. [Transformers #47844](https://github.com/huggingface/transformers/pull/47844) and [SGLang #33829](https://github.com/sgl-project/sglang/pull/33829) are still under review; until they are merged, use the PR revisions below.
182
 
183
  ### Transformers
184
 
 
211
  print(processor.decode(outputs[0, inputs.input_ids.shape[1] :], skip_special_tokens=True))
212
  ```
213
 
214
+ The first FP8 run downloads `kernels-community/finegrained-fp8` from the Hugging Face Hub unless cached. Use SGLang or vLLM for multi-GPU OpenAI-compatible serving.
215
 
216
  ### SGLang
217
 
 
224
  docker run --gpus all --ipc=host -p 8000:8000 \
225
  lmsysorg/sglang:dev-dots3-note \
226
  sglang serve \
227
+ --model-path dots-studio/dots-3-note-prev-fp8 \
228
+ --served-model-name dots-3-note-prev \
229
  --host 0.0.0.0 \
230
  --port 8000 \
231
  --context-length 524288 \
 
243
  --speculative-num-steps 3 \
244
  --speculative-eagle-topk 1 \
245
  --speculative-num-draft-tokens 4 \
246
+ --speculative-draft-model-path dots-studio/dots-3-note-prev-fp8
247
  ```
248
 
249
  Or install from source / the PR and run the same `sglang serve` arguments locally. `--attention-backend fa3` sets prefill, decode, and (when speculative decoding is enabled) draft attention. MTP/NEXTN (`--speculative-algorithm NEXTN` and the related flags) is optional and can reduce TPOT by more than 50%. Prefill CUDA graph is not supported yet.
 
260
 
261
  ### vLLM
262
 
263
+ Native dots3-note preview support is available on [vLLM](https://github.com/vllm-project/vllm) `main`. Use a recent nightly build until it is included in a stable release.
264
 
265
  The following example deploys the FP8 checkpoint on eight NVIDIA H100 GPUs with TP=8 and EP=8:
266
 
 
285
 
286
  # Enable OpenAI-compatible automatic tool calling
287
  --enable-auto-tool-choice --tool-call-parser dots
 
288
  ```
289
 
 
 
 
 
 
 
290
  ## License
291
 
292
  Copyright (c) 2026 Xiaohongshu.
README_CN.md DELETED
@@ -1,296 +0,0 @@
1
- <p align="left">
2
- <a href="https://huggingface.co/dots-studio/dots3-note-prev-fp8">English</a>&nbsp;|&nbsp;中文
3
- </p>
4
- <br>
5
-
6
- <div align="center">
7
- <img src="assets/dots%20logo@3x.png" alt="dots logo" width="200" />
8
- <h1>dots3-note Preview</h1>
9
- </div>
10
-
11
- <div align="center" style="line-height: 1;">
12
- <a href="https://github.com/studio-dots-ai/dots3-note-prev"><img alt="GitHub: studio-dots-ai" src="https://img.shields.io/badge/GitHub-studio--dots--ai-181717?logo=github&amp;logoColor=white" /></a>
13
- <a href="https://github.com/huggingface/transformers/pull/47844"><img alt="Transformers: dots3-note" src="https://img.shields.io/badge/Transformers-dots3--note-yellow" /></a>
14
- <a href="https://github.com/sgl-project/sglang/pull/33829"><img alt="SGLang: dots3-note" src="https://img.shields.io/badge/SGLang-dots3--note-blue" /></a>
15
- <a href="https://recipes.vllm.ai/dots-studio/dots3-note-prev"><img alt="vLLM: dots3-note" src="https://img.shields.io/badge/vLLM-dots3--note-red" /></a>
16
- <a href="https://modelscope.cn/collections/dots-studio/dots3-note"><img alt="ModelScope: dots-studio" src="https://img.shields.io/badge/ModelScope-dots--studio-624AFF" /></a>
17
-
18
- <a href="https://www.xiaohongshu.com/user/profile/683ffe42000000001d021a4c"><img alt="Dots Studio" src="https://img.shields.io/badge/RedNote-Dots%20Studio-FF2442" /></a>
19
- <a href="https://discord.gg/haym6hEUE"><img alt="Discord" src="https://img.shields.io/badge/Discord-Join-5865F2?logo=discord&amp;logoColor=white" /></a>
20
- <a href="https://x.com/dotsstudioai"><img alt="X: dotsstudioai" src="https://img.shields.io/badge/X-%40dotsstudioai-black" /></a>
21
- <a href="#许可证"><img alt="License: Apache 2.0" src="https://img.shields.io/badge/License-Apache%202.0-blue" /></a>
22
- </div>
23
-
24
- <p align="center">
25
- 🌐&nbsp;<a href="https://studio.dots.ai/dots/dots3-zh.html"><b>技术博客</b></a>&nbsp;&nbsp;|&nbsp;&nbsp;
26
- 📄&nbsp;<b>完整报告(即将发布)</b>
27
- </p>
28
-
29
- <div align="center">
30
- <h3>免费体验 <b>dots3-note Preview</b>&nbsp;<a href="https://openrouter.ai/dots-studio/dots-3-note-preview:free" style="vertical-align: middle;"><img alt="OpenRouter: dots3-note" src="https://img.shields.io/badge/OpenRouter-dots3--note-6366F1?logo=openrouter&amp;logoColor=white" /></a></h3>
31
- </div>
32
-
33
- ---
34
-
35
- ## 目录
36
-
37
- - [模型介绍](#模型介绍)
38
- - [模型概览](#模型概览)
39
- - [评测结果](#评测结果)
40
- - [通用推理与智能体](#通用推理与智能体)
41
- - [多模态理解](#多模态理解)
42
- - [模型链接](#模型链接)
43
- - [快速开始](#快速开始)
44
- - [部署](#部署)
45
- - [Transformers](#transformers)
46
- - [SGLang](#sglang)
47
- - [vLLM](#vllm)
48
- - [评测附录](#评测附录)
49
- - [许可证](#许可证)
50
- - [联系我们](#联系我们)
51
-
52
- ---
53
-
54
- ## 模型介绍
55
-
56
- dots3-note preview 是 dots3 系列首个开放权重模型。该模型采用混合专家(Mixture-of-Experts,MoE)架构,总参数量为 280B,激活参数量为 16B,支持最长 512K 个 token 的上下文。模型支持文本、图像、视频和音频理解,并生成文本输出。
57
-
58
- dots3-note preview 针对以下任务进行了优化:
59
-
60
- - 通用知识与指令遵循;
61
- - 数学与逻辑推理;
62
- - 工具使用与多步骤智能体工作流;
63
- - 需要探索、记忆更新和适应能力的交互式任务;
64
- - 代码生成与基于代码的问题求解;
65
- - 图像、文档、图表、音频和视频理解;
66
- - 长上下文信息处理。
67
-
68
- dots3 系列包含在能力、时延和推理成本之间采用不同权衡的多款模型,dots3-note preview 是该系列中最轻量级的成员。
69
-
70
- ## 模型概览
71
-
72
- | 属性 | 值 |
73
- | :--- | :--- |
74
- | 架构 | 多模态混合专家模型(MoE) |
75
- | 总参数量 | 280B |
76
- | 激活参数量 | 16B |
77
- | MTP | 1 个共享层,1.13B 参数 |
78
- | 层数 | 1 个稠密层 + 45 个 MoE 层 |
79
- | 隐藏层维度 | 5120 |
80
- | FFN 中间层维度 | 13824(稠密层),1536(每个专家) |
81
- | 专家数量 | 256 个路由专家 + 1 个共享专家,Top-8 激活 |
82
- | 注意力机制 | 13 DSA + 33 SWA(约 1:3) |
83
- | DSA | Top-2048 |
84
- | 上下文长度 | 512K |
85
- | 词表大小 | 152K |
86
- | 视觉编码器 | MoE ViT,总参数量 7B,激活参数量 1.2B |
87
- | 音频编码器 | 稠密模型,800M |
88
- | 支持精度 | BF16、FP8 |
89
- | 输入 | 文本、图像、视频、音频 |
90
- | 输出 | 文本 |
91
-
92
- ## 评测结果
93
-
94
- ### 通用推理与智能体
95
-
96
- ![通用推理与智能体评测结果](assets/bench_cn1.png)
97
-
98
- ### 多模态理解
99
-
100
- ![多模态理解评测结果](assets/bench_cn2.png)
101
-
102
- ## 模型链接
103
-
104
- | 模型名称 | 简介 | Hugging Face | ModelScope |
105
- | --- | --- | --- | --- |
106
- | dots3-note-prev | 预览版多模态模型 | 🤗 [模型](https://huggingface.co/dots-studio/dots3-note-prev) | <span style="white-space: nowrap;"><img src="https://modelscope.cn/favicon.ico" width="16" alt="ModelScope" style="display: inline-block; vertical-align: middle; margin: 0;" />&nbsp;<a href="https://modelscope.cn/models/dots-studio/dots3-note-prev">模型</a></span> |
107
- | dots3-note-prev-fp8 | FP8 量化预览版多模态模型 | 🤗 [模型](https://huggingface.co/dots-studio/dots3-note-prev-fp8) | <span style="white-space: nowrap;"><img src="https://modelscope.cn/favicon.ico" width="16" alt="ModelScope" style="display: inline-block; vertical-align: middle; margin: 0;" />&nbsp;<a href="https://modelscope.cn/models/dots-studio/dots3-note-prev-fp8">模型</a></span> |
108
-
109
- ## 快速开始
110
-
111
- 建议使用 [SGLang](#sglang) 或 [vLLM](#vllm),在单个 8 卡节点上部署 FP8 权重。
112
-
113
- ```python
114
- from openai import OpenAI
115
-
116
- client = OpenAI(base_url="http://127.0.0.1:8000/v1", api_key="EMPTY")
117
-
118
- response = client.chat.completions.create(
119
- model="dots3-note-prev",
120
- messages=[
121
- {"role": "user", "content": "你好!请简单介绍一下你自己。"},
122
- ],
123
- temperature=1.0,
124
- top_p=0.95,
125
- max_tokens=256,
126
- # 启用推理时设置 enable_thinking=True;设置为 False 时直接回复。
127
- extra_body={"chat_template_kwargs": {"enable_thinking": False}},
128
- )
129
- print(response.choices[0].message.content)
130
- ```
131
-
132
- 如需发起多模态请求,可将 `messages` 替换为以下任一公开示例:
133
-
134
- ```python
135
- examples = {
136
- "image": [
137
- {"type": "image_url", "image_url": {"url": "https://huggingface.co/datasets/huggingface/documentation-images/resolve/main/cats.png"}},
138
- {"type": "text", "text": "这张图片中有几只猫?"},
139
- ],
140
- "audio": [
141
- {"type": "audio_url", "audio_url": {"url": "https://huggingface.co/datasets/hf-internal-testing/dummy-audio-samples/resolve/main/mary_had_lamb.mp3"}},
142
- {"type": "text", "text": "请转写这段童谣。"},
143
- ],
144
- "video": [
145
- {"type": "video_url", "video_url": {"url": "https://huggingface.co/datasets/merve/vlm_test_images/resolve/main/concert.mp4"}},
146
- {"type": "text", "text": "请描述这场表演以及视频中可以听到的内容。"},
147
- ],
148
- }
149
- messages = [{"role": "user", "content": examples["image"]}]
150
- ```
151
-
152
- 如果视频包含音轨,模型也会同时处理其中的音频。
153
-
154
- ## 部署
155
-
156
- 以下命令面向单个 8 卡节点上的 FP8 部署。BF16 需要更多显存,请根据可用显存、并发量和输入模态调整上下文长度。
157
-
158
- [vLLM](https://recipes.vllm.ai/dots-studio/dots3-note-prev) 的 `main` 分支已原生支持 dots3-note preview。[Transformers #47844](https://github.com/huggingface/transformers/pull/47844) 和 [SGLang #33829](https://github.com/sgl-project/sglang/pull/33829) 仍在审核中;合并前请使用下文指定的 PR 版本。
159
-
160
- ### Transformers
161
-
162
- 请先安装 NVIDIA 驱动支持且相互兼容的 [PyTorch 和 torchvision](https://pytorch.org/get-started/locally/) 版本。若需处理音频和视频,还应安装与 PyTorch 兼容的 `torchcodec`(包含在下方命令中),并通过系统包管理器安装 FFmpeg。随后安装 [Transformers #47844](https://github.com/huggingface/transformers/pull/47844):
163
-
164
- ```bash
165
- pip install accelerate pillow torchcodec kernels==0.16.0 "transformers @ git+https://github.com/huggingface/transformers.git@refs/pull/47844/head"
166
- ```
167
-
168
- 运行最小化本地推理示例:
169
-
170
- ```python
171
- from transformers import AutoModelForMultimodalLM, AutoProcessor
172
-
173
- model_id = "dots-studio/dots3-note-prev-fp8"
174
- processor = AutoProcessor.from_pretrained(model_id)
175
- model = AutoModelForMultimodalLM.from_pretrained(model_id, dtype="auto", device_map="auto")
176
-
177
- messages = [
178
- {"role": "user", "content": "你好!请简单介绍一下你自己。"},
179
- ]
180
- inputs = processor.tokenizer.apply_chat_template(
181
- messages,
182
- add_generation_prompt=True,
183
- return_tensors="pt",
184
- return_dict=True,
185
- enable_thinking=False,
186
- ).to(model.device)
187
- outputs = model.generate(**inputs, max_new_tokens=128)
188
- print(processor.decode(outputs[0, inputs.input_ids.shape[1] :], skip_special_tokens=True))
189
- ```
190
-
191
- 如需提供多 GPU、兼容 OpenAI API 的服务,请使用 SGLang 或 vLLM。
192
-
193
- ### SGLang
194
-
195
- 推荐使用发布镜像 [lmsysorg/sglang:dev-dots3-note](https://hub.docker.com/r/lmsysorg/sglang/tags)。完整的单节点部署方案和调优说明请参阅 [Dots3-Note cookbook](https://github.com/sgl-project/sglang/blob/main/docs/cookbook/autoregressive/RedNote/Dots3-Note.mdx)。源码支持进展请参阅 [SGLang #33829](https://github.com/sgl-project/sglang/pull/33829)。
196
-
197
- Docker 部署(首次运行时,镜像会从 Hugging Face 下载模型权重):
198
-
199
- ```bash
200
- docker run --gpus all --ipc=host -p 8000:8000 \
201
- lmsysorg/sglang:dev-dots3-note \
202
- sglang serve \
203
- --model-path dots-studio/dots3-note-prev-fp8 \
204
- --served-model-name dots3-note-prev \
205
- --host 0.0.0.0 \
206
- --port 8000 \
207
- --context-length 524288 \
208
- --enable-dp-attention \
209
- --dp-size 8 \
210
- --tp-size 8 \
211
- --ep-size 8 \
212
- --moe-dense-tp-size 1 \
213
- --page-size 64 \
214
- --trust-remote-code \
215
- --attention-backend fa3 \
216
- --moe-a2a-backend deepep \
217
- --enable-multimodal \
218
- --speculative-algorithm NEXTN \
219
- --speculative-num-steps 3 \
220
- --speculative-eagle-topk 1 \
221
- --speculative-num-draft-tokens 4 \
222
- --speculative-draft-model-path dots-studio/dots3-note-prev-fp8
223
- ```
224
-
225
- 也可以从源码或相应 PR 安装,并在本地使用相同的 `sglang serve` 参数。`--attention-backend fa3` 会设置预填充、解码以及启用投机解码时的草稿模型注意力后端。MTP/NEXTN(`--speculative-algorithm NEXTN` 及相关参数)为可选功能,可将 TPOT 降低 50% 以上。目前尚不支持预填充阶段的 CUDA Graph。
226
-
227
- 可选功能:
228
-
229
- ```bash
230
- # 仅加载语言模型
231
- --language-only
232
-
233
- # 启用兼容 OpenAI API 的工具调用
234
- --tool-call-parser dots
235
- ```
236
-
237
- ### vLLM
238
-
239
- [vLLM](https://recipes.vllm.ai/dots-studio/dots3-note-prev) 的 `main` 分支已原生支持 dots3-note preview。在该功能进入稳定版本前,请使用较新的 nightly build。
240
-
241
- 以下示例使用 8 张 NVIDIA H100 GPU,以 TP=8、EP=8 部署 FP8 权重:
242
-
243
- ```bash
244
- vllm serve dots-studio/dots3-note-prev-fp8 \
245
- --served-model-name dots3-note-prev \
246
- --host 0.0.0.0 \
247
- --tensor-parallel-size 8 \
248
- --enable-expert-parallel \
249
- --moe-backend deep_gemm \
250
- --max-model-len 262144
251
- ```
252
-
253
- 可选功能:
254
-
255
- ```bash
256
- # 仅加载语言模型
257
- --language-model-only
258
-
259
- # 启用 3-token MTP 投机解码
260
- --speculative-config '{"method":"mtp","num_speculative_tokens":3}'
261
-
262
- # 启用兼容 OpenAI API 的自动工具调用
263
- --enable-auto-tool-choice --tool-call-parser dots
264
- ```
265
-
266
- ## 评测附录
267
-
268
- ![通用推理与智能体评测附录](assets/benchmark_appendix_cn_reasoning.png)
269
-
270
- ![多模态评测附录](assets/benchmark_appendix_cn_multimodal.png)
271
-
272
- ## 许可证
273
-
274
- Copyright (c) 2026 Xiaohongshu.
275
-
276
- 由 dots studio 开发并发布。
277
-
278
- 本仓库中的 dots3-note preview 模型权重和建模代码基于 Apache License 2.0 发布。
279
-
280
- 详情请参阅 LICENSE 文件。
281
-
282
- Transformers、SGLang、vLLM 及其他第三方软件适用其各自的许可证。
283
-
284
- ## 联系我们
285
-
286
- 如有问题或反馈,请通过以下方式联系我们:
287
-
288
- - 邮箱:dots-model-feedback@xiaohongshu.com
289
-
290
- ---
291
-
292
- <p align="center">
293
-
294
- <i>dots3-note preview is developed and released by dots studio.</i>
295
-
296
- </p>
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
assets/bench_cn1.png DELETED

Git LFS Details

  • SHA256: 473ed6125b2966f2cb9f51d8a29d2abef1bd23bf9043f72356dd16f213e63f1b
  • Pointer size: 131 Bytes
  • Size of remote file: 502 kB
assets/bench_cn2.png DELETED

Git LFS Details

  • SHA256: e795a70d82eb77ecac6743d0f61045dc3d037b40ea917b425645730043abdb27
  • Pointer size: 131 Bytes
  • Size of remote file: 290 kB
assets/bench_en1.png DELETED

Git LFS Details

  • SHA256: 9a2f88cde1353884bf9d7c2a47b278debd8c92757dbba9e61dc2dcfe00475fb6
  • Pointer size: 131 Bytes
  • Size of remote file: 730 kB
assets/bench_en2.png DELETED

Git LFS Details

  • SHA256: fcf1d2d99752ae9d36cff2e1e619ca1ef9c23901ac6ede46f1defb990efedda9
  • Pointer size: 131 Bytes
  • Size of remote file: 299 kB
assets/benchmark_appendix_cn_multimodal.png DELETED

Git LFS Details

  • SHA256: 1c41249b076ab0fe5d1daaa24c7e59721d155de1e25351467b7b065dd7cfeded
  • Pointer size: 131 Bytes
  • Size of remote file: 363 kB
assets/benchmark_appendix_cn_reasoning.png DELETED

Git LFS Details

  • SHA256: 9b3567487f2068e550cf6c0cfedf3b1b6b0148379df7a81ce1221b5fd0b129db
  • Pointer size: 131 Bytes
  • Size of remote file: 787 kB
assets/benchmark_appendix_en_multimodal.png DELETED

Git LFS Details

  • SHA256: 03a3cf92a37c3bf5efa507a07f522d916b238ec900c4cdebee03d50ae96fd51d
  • Pointer size: 131 Bytes
  • Size of remote file: 357 kB
assets/benchmark_appendix_en_reasoning.png DELETED

Git LFS Details

  • SHA256: 0dddc20ced4b0c43353d885c368e4e45306f744929def7a1821059c37f76420d
  • Pointer size: 131 Bytes
  • Size of remote file: 786 kB
assets/dots logo@3x.png DELETED
Binary file (41.4 kB)
 
config.json CHANGED
@@ -94,7 +94,7 @@
94
  "rope_theta": 80000000.0,
95
  "routed_scaling_factor": 1.0,
96
  "scoring_func": "sigmoid",
97
- "sliding_window_size": 513,
98
  "swa_attention_gate_type": "headwise",
99
  "swa_kv_lora_rank": 1024,
100
  "swa_num_attention_heads": 64,
 
94
  "rope_theta": 80000000.0,
95
  "routed_scaling_factor": 1.0,
96
  "scoring_func": "sigmoid",
97
+ "sliding_window_size": 512,
98
  "swa_attention_gate_type": "headwise",
99
  "swa_kv_lora_rank": 1024,
100
  "swa_num_attention_heads": 64,