Skip to content
Open
Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
18 commits
Select commit Hold shift + click to select a range
daf20d9
Merge remote-tracking branch 'upstream/develop' into develop
cloudforge1 Mar 6, 2026
6f1e63c
Merge remote-tracking branch 'upstream/develop' into develop
cloudforge1 Mar 6, 2026
4deb7a7
Merge remote-tracking branch 'upstream/develop' into develop
cloudforge1 Mar 9, 2026
676daf6
Merge remote-tracking branch 'upstream/develop' into develop
cloudforge1 Mar 9, 2026
9bcfdca
Merge remote-tracking branch 'upstream/develop' into develop
cloudforge1 Mar 10, 2026
2bfa878
Merge remote-tracking branch 'upstream/develop' into develop
cloudforge1 Mar 10, 2026
262c470
Merge remote-tracking branch 'upstream/develop' into develop
cloudforge1 Mar 11, 2026
171b4d3
Merge remote-tracking branch 'upstream/develop' into develop
cloudforge1 Mar 17, 2026
def0bd2
Merge remote-tracking branch 'upstream/develop' into develop
cloudforge1 Mar 19, 2026
4fad5dc
Merge remote-tracking branch 'upstream/develop' into develop
cloudforge1 Mar 20, 2026
99b9f88
Merge remote-tracking branch 'upstream/develop' into develop
cloudforge1 Mar 24, 2026
f9747ab
feat: add MiniMax-M1 (MiniMaxText01) model support
cloudforge1 Mar 24, 2026
d106147
fix: align HF weight keys, add output_gate/norm to linear attn, imple…
cloudforge1 Mar 24, 2026
e068f01
Add low-bit quantization support for MoE layer
cloudforge1 Mar 24, 2026
0cb6852
fix: address AI code review findings
cloudforge1 Apr 3, 2026
222946e
fix: address Copilot code review — KV history shape, block_size, tests
cloudforge1 Apr 3, 2026
55f9620
fix: TP-aware head sharding for Linear Attention + scope comment
cloudforge1 Apr 3, 2026
964ba08
fix: expert weight_loader safety, decode kernel padding, clone elim
cloudforge1 Apr 3, 2026
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
45 changes: 45 additions & 0 deletions docs/best_practices/MiniMax-M1.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,45 @@
[简体中文](../zh/best_practices/MiniMax-M1.md)

# MiniMax-M1 Model

## I. Environment Preparation

### 1.1 Support Requirements

MiniMax-M1 support in FastDeploy uses a hybrid decoder stack:

- Standard full-attention layers run through the existing FastDeploy attention backend.
- Linear-attention layers use the Lightning Attention Triton kernels in `fastdeploy/model_executor/ops/triton_ops/lightning_attn.py`.
- Current first-pass support targets BF16 inference.

### 1.2 Installing FastDeploy

Installation process reference document [FastDeploy GPU Installation](../get_started/installation/nvidia_gpu.md)

## II. How to Use

### 2.1 Basics: Starting the Service

```shell
MODEL_PATH=/models/MiniMax-Text-01

python -m fastdeploy.entrypoints.openai.api_server \
--model "$MODEL_PATH" \
--port 8180 \
--metrics-port 8181 \
--engine-worker-queue-port 8182 \
--max-model-len 32768 \
--max-num-seqs 32
```

### 2.2 Model Notes

- HuggingFace architecture: `MiniMaxText01ForCausalLM`
- Hybrid layer layout: 70 linear-attention layers and 10 full-attention layers
- MoE routing: 32 experts, top-2 experts per token

## III. Known Limitations

- This initial integration is focused on model structure and backend wiring.
- Low-bit quantization support still requires follow-up validation against MiniMax-M1 weights.
- Production validation should include GPU runtime checks for Lightning Attention decode/prefill paths.
1 change: 1 addition & 0 deletions docs/supported_models.md
Original file line number Diff line number Diff line change
Expand Up @@ -38,6 +38,7 @@ These models accept text input.
|⭐QWEN2.5|BF16/WINT8/FP8|Qwen/qwen2.5-72B;<br>Qwen/qwen2.5-32B;<br>Qwen/qwen2.5-14B;<br>Qwen/qwen2.5-7B;<br>Qwen/qwen2.5-3B;<br>Qwen/qwen2.5-1.5B;<br>Qwen/qwen2.5-0.5B, etc.|
|⭐QWEN2|BF16/WINT8/FP8|Qwen/Qwen/qwen2-72B;<br>Qwen/Qwen/qwen2-7B;<br>Qwen/qwen2-1.5B;<br>Qwen/qwen2-0.5B;<br>Qwen/QwQ-32, etc.|
|⭐DEEPSEEK|BF16/WINT4|unsloth/DeepSeek-V3.1-BF16;<br>unsloth/DeepSeek-V3-0324-BF16;<br>unsloth/DeepSeek-R1-BF16, etc.|
|MINIMAX-M1|BF16|[MiniMaxAI/MiniMax-Text-01](./best_practices/MiniMax-M1.md);<br>MiniMaxAI/MiniMax-Text-01-Large, etc.|
|⭐GPT-OSS|BF16/WINT8|unsloth/gpt-oss-20b-BF16, etc.|
|⭐GLM-4.5/4.6|BF16/wfp8afp8|zai-org/GLM-4.5-Air;<br>zai-org/GLM-4.6<br>&emsp;[最佳实践](./best_practices/GLM-4-MoE-Text.md) etc.|

Expand Down
45 changes: 45 additions & 0 deletions docs/zh/best_practices/MiniMax-M1.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,45 @@
[English](../../best_practices/MiniMax-M1.md)

# MiniMax-M1 模型

## 一、环境准备

### 1.1 支持说明

FastDeploy 中的 MiniMax-M1 采用混合解码器结构:

- 全注意力层复用 FastDeploy 现有 Attention 后端。
- 线性注意力层使用 `fastdeploy/model_executor/ops/triton_ops/lightning_attn.py` 中的 Lightning Attention Triton kernel。
- 当前首版支持以 BF16 推理为主。

### 1.2 安装 FastDeploy

安装流程可参考 [FastDeploy GPU 安装文档](../get_started/installation/nvidia_gpu.md)

## 二、使用方式

### 2.1 基础启动命令

```shell
MODEL_PATH=/models/MiniMax-Text-01

python -m fastdeploy.entrypoints.openai.api_server \
--model "$MODEL_PATH" \
--port 8180 \
--metrics-port 8181 \
--engine-worker-queue-port 8182 \
--max-model-len 32768 \
--max-num-seqs 32
```

### 2.2 模型特性

- HuggingFace 架构名:`MiniMaxText01ForCausalLM`
- 层类型分布:70 层线性注意力 + 10 层全注意力
- MoE 路由:32 个专家,每个 token 选择 top-2 专家

## 三、当前限制

- 当前版本优先完成模型组网与后端接线。
- 各类低比特量化推理能力还需要结合真实权重进一步验证。
- Lightning Attention 的 prefill/decode 路径仍需在 GPU 环境完成端到端验证。
1 change: 1 addition & 0 deletions docs/zh/supported_models.md
Original file line number Diff line number Diff line change
Expand Up @@ -36,6 +36,7 @@ python -m fastdeploy.entrypoints.openai.api_server \
|⭐QWEN2.5|BF16/WINT8/FP8|Qwen/qwen2.5-72B;<br>Qwen/qwen2.5-32B;<br>Qwen/qwen2.5-14B;<br>Qwen/qwen2.5-7B;<br>Qwen/qwen2.5-3B;<br>Qwen/qwen2.5-1.5B;<br>Qwen/qwen2.5-0.5B, etc.|
|⭐QWEN2|BF16/WINT8/FP8|Qwen/Qwen/qwen2-72B;<br>Qwen/Qwen/qwen2-7B;<br>Qwen/qwen2-1.5B;<br>Qwen/qwen2-0.5B;<br>Qwen/QwQ-32, etc.|
|⭐DEEPSEEK|BF16/WINT4|unsloth/DeepSeek-V3.1-BF16;<br>unsloth/DeepSeek-V3-0324-BF16;<br>unsloth/DeepSeek-R1-BF16, etc.|
|MINIMAX-M1|BF16|[MiniMaxAI/MiniMax-Text-01](./best_practices/MiniMax-M1.md);<br>MiniMaxAI/MiniMax-Text-01-Large, etc.|
|⭐GPT-OSS|BF16/WINT8|unsloth/gpt-oss-20b-BF16, etc.|
|⭐GLM-4.5/4.6|BF16/wfp8afp8|zai-org/GLM-4.5-Air;<br>zai-org/GLM-4.6<br>&emsp;[最佳实践](./best_practices/GLM-4-MoE-Text.md) etc.|

Expand Down
Loading
Loading