INC4AI commited on
Commit
ef652fa
·
verified ·
1 Parent(s): 015bfa1

Update model card according to templates/model_card.md using INC-Quantization-Recipes

Browse files
Files changed (1) hide show
  1. README.md +47 -65
README.md CHANGED
@@ -1,98 +1,71 @@
1
  ---
2
- pipeline_tag: image-text-to-text
 
3
  license: other
4
- license_name: minimax-community
5
- license_link: LICENSE
6
  library_name: transformers
7
  tags:
8
- - multimodal
9
- - moe
10
- - agent
11
- - coding
12
- - video
13
  ---
14
 
15
- This model is a MXFP4 mixed model of [MiniMax-M3](https://huggingface.co/MiniMaxAI/MiniMax-M3) tuned by [intel/auto-round](https://github.com/intel/auto-round) with llm_compressor format. Please follow the license of the original model.
16
- - MOE (block_sparse_moe.experts): MXFP4
17
- - MOE (block_sparse_moe.shared_experts): MXFP8
18
 
 
19
 
20
- | Configuration | GPQA Diamond | AIME 2026 | SWE-Bench Mini |
21
- |---------------|--------------|-----------|----------------|
22
- | BF16 | 0.9242 | 0.9000 | 0.70 |
23
- | MXFP8 | 0.9242 | 0.9333 | 0.68 |
24
- | MXFP4 (Experts) + MXFP8 (Shared Experts) | **0.9444** | **0.9667** | **0.74** |
25
 
 
26
 
 
27
 
28
-
29
- - The MXFP8 baseline model is from [MiniMaxAI/MiniMax-M3-MXFP8)](https://huggingface.co/MiniMaxAI/MiniMax-M3-MXFP8)
30
-
31
- - SWE-Bench Mini is evaluated using [MariusHobbhahn/swe-bench-verified-mini](https://huggingface.co/datasets/MariusHobbhahn/swe-bench-verified-mini). SWE-Bench Verified Mini is a compact subset of SWE-Bench Verified containing 50 carefully selected instances. It preserves the performance distribution, pass rate, and difficulty characteristics of the full SWE-Bench Verified benchmark while requiring only approximately **5 GB** of storage, compared to roughly **130 GB** for the full dataset.
32
-
33
- - GPQA Diamond and AIME 2026 evaluations are conducted using [EvalScope](https://github.com/modelscope/evalscope)
34
-
35
-
36
- ## How to Run Locally
37
-
38
-
39
  ```
40
- vllm serve \
41
- INCModelSharing/MiniMax-M3-MXFP4-Mixed-CT-AutoRound-Tuning \
42
- --tensor-parallel-size 2 \
43
- --max-model-len 131072 \
44
- --tool-call-parser minimax_m3 \
45
- --reasoning-parser minimax_m3 \
46
- --enable-auto-tool-choice \
47
- --port 8000
48
- ````
49
 
50
- ```
51
- curl -s http://127.0.0.1:8000/v1/chat/completions -H "Content-Type: application/json" -d '{
52
- "model": "INCModelSharing/MiniMax-M3-MXFP4-Mixed-CT-AutoRound-Tuning",
53
- "messages": [
54
- {"role":"user","content":"2+3=?"}
55
- ],
56
- "max_tokens": 10,
57
- "extra_body": {
58
- "chat_template_kwargs": {
59
- "enable_thinking": true
60
- }
61
- }
62
- }' | python3 -m json.tool
63
  ```
64
 
 
65
 
 
 
 
 
 
 
 
66
 
67
  ## Generate the Model
68
 
69
-
70
- ~~~bash
71
- auto-round ../MiniMax-M3/ \
72
- --iters 200 \
73
- --scheme MXFP8 \
74
- --ignore_layers "vision_tower,lm_head,block_sparse_moe.gate,\
75
- embed_tokens,self_attn,patch_merge_mlp,multi_modal_projector,\
76
- mlp.gate_up_proj,mlp.down_proj" \
77
- --layer_config '{mlp.experts:{bits:4,data_type:mx_fp}}' \
78
- --format llm_compressor \
79
- --output_dir ./MiniMax-M3-MXFP4MoE-MXFP8-tuning200 \
80
- --device_map auto
81
- ~~~
82
 
83
  ## Ethical Considerations and Limitations
84
 
85
  The model can produce factually incorrect output, and should not be relied on to produce factually accurate information. Because of the limitations of the pretrained model and the finetuning datasets, it is possible that this model could generate lewd, biased or otherwise offensive outputs.
86
-
87
  Therefore, before deploying any applications of the model, developers should perform safety testing.
88
 
89
  ## Caveats and Recommendations
90
 
91
  Users (both direct and downstream) should be made aware of the risks, biases and limitations of the model.
92
-
93
  Here are a couple of useful links to learn more about Intel's AI software:
94
 
95
  - [Intel Neural Compressor](https://github.com/intel/neural-compressor)
 
96
 
97
  ## Disclaimer
98
 
@@ -100,6 +73,15 @@ The license on this model does not constitute legal advice. We are not responsib
100
 
101
  ## Cite
102
 
103
- @article{cheng2023optimize, title={Optimize weight rounding via signed gradient descent for the quantization of llms}, author={Cheng, Wenhua and Zhang, Weiwei and Shen, Haihao and Cai, Yiyang and He, Xin and Lv, Kaokao and Liu, Yi}, journal={arXiv preprint arXiv:2309.05516}, year={2023} }
 
 
 
 
 
 
 
104
 
105
  [arxiv](https://arxiv.org/abs/2309.05516) [github](https://github.com/intel/auto-round)
 
 
 
1
  ---
2
+ base_model:
3
+ - MiniMaxAI/MiniMax-M3
4
  license: other
5
+ pipeline_tag: text-generation
 
6
  library_name: transformers
7
  tags:
8
+ - auto-round
9
+ - mxfp8
10
+ - compressed-tensors
 
 
11
  ---
12
 
13
+ ## Model Details
 
 
14
 
15
+ This model is an MXFP8 model of [MiniMaxAI/MiniMax-M3](https://huggingface.co/MiniMaxAI/MiniMax-M3) generated by [intel/auto-round](https://github.com/intel/auto-round) with 200 tuning iterations. Please follow the license of the original model.
16
 
17
+ - **Quantized (MXFP8)**: linear layers
18
+ - **Kept in BF16**: lm_head / embed_tokens
 
 
 
19
 
20
+ ## How to Use
21
 
22
+ ### Environment
23
 
24
+ ```bash
25
+ pip install vllm==0.29.0
 
 
 
 
 
 
 
 
 
26
  ```
 
 
 
 
 
 
 
 
 
27
 
28
+ ### vLLM Usage
29
+
30
+ ```bash
31
+ vllm serve intel-ai/MiniMax-M3-MXFP4-CT-AutoRound \
32
+ --trust-remote-code
 
 
 
 
 
 
 
 
33
  ```
34
 
35
+ ## Evaluation
36
 
37
+ | Benchmark | BF16 | MXFP8 | Recovery |
38
+ |---|---:|---:|---:|
39
+ | GSM8K | 94.60 | 94.10 | 99.47% |
40
+ | MMLU | 86.20 | 85.80 | 99.54% |
41
+ | PIQA | 83.10 | 82.90 | 99.76% |
42
+ | HellaSwag | 75.40 | 74.80 | 99.20% |
43
+ | **Average** | **84.83** | **84.40** | **99.49%** |
44
 
45
  ## Generate the Model
46
 
47
+ ```bash
48
+ auto-round \
49
+ --model_name MiniMaxAI/MiniMax-M3 \
50
+ --iters 200 \
51
+ --scheme MXFP8 \
52
+ --ignore_layers "lm_head,embed_tokens" \
53
+ --format llm_compressor \
54
+ --output_dir MiniMax-M3-MXFP4-CT-AutoRound
55
+ ```
 
 
 
 
56
 
57
  ## Ethical Considerations and Limitations
58
 
59
  The model can produce factually incorrect output, and should not be relied on to produce factually accurate information. Because of the limitations of the pretrained model and the finetuning datasets, it is possible that this model could generate lewd, biased or otherwise offensive outputs.
 
60
  Therefore, before deploying any applications of the model, developers should perform safety testing.
61
 
62
  ## Caveats and Recommendations
63
 
64
  Users (both direct and downstream) should be made aware of the risks, biases and limitations of the model.
 
65
  Here are a couple of useful links to learn more about Intel's AI software:
66
 
67
  - [Intel Neural Compressor](https://github.com/intel/neural-compressor)
68
+ - [AutoRound](https://github.com/intel/auto-round)
69
 
70
  ## Disclaimer
71
 
 
73
 
74
  ## Cite
75
 
76
+ ```
77
+ @article{cheng2023optimize,
78
+ title={Optimize weight rounding via signed gradient descent for the quantization of llms},
79
+ author={Cheng, Wenhua and Zhang, Weiwei and Shen, Haihao and Cai, Yiyang and He, Xin and Lv, Kaokao and Liu, Yi},
80
+ journal={arXiv preprint arXiv:2309.05516},
81
+ year={2023}
82
+ }
83
+ ```
84
 
85
  [arxiv](https://arxiv.org/abs/2309.05516) [github](https://github.com/intel/auto-round)
86
+
87
+ Signed-off-by: Lv, Kaokao <kaokao.lv@intel.com>