[GLM5.2 FP8/MXFP4] optimize GLM5.2#1458
Merged
Merged
Conversation
zejunchen-zejun
marked this pull request as ready for review
July 7, 2026 08:14
Contributor
There was a problem hiding this comment.
Pull request overview
Updates ATOM’s DeepSeek/GLM shared codepaths to enable GLM‑5.2 performance optimizations (fused indexer path + MXFP8 online quant behavior) and documents server launch recipes for GLM‑5.2 FP8/MXFP4.
Changes:
- Add a GLM-specific env toggle (
ATOM_ENABLE_GLM_FUSED_INDEXER) and use it to allow GLM‑5.2 (glm_moe_dsa) to take the fused indexer kernel path. - Force
scale_type=fp8_e8m0for MXFP8 (per_1x32 + fp8) online weight quant to match expected scale buffer/kernel consumption. - Document GLM‑5.2 FP8/MXFP4 server and MTP server launch recipes (docker image + example commands).
Reviewed changes
Copilot reviewed 4 out of 4 changed files in this pull request and generated 1 comment.
| File | Description |
|---|---|
| recipes/GLM-5.md | Adds GLM‑5.2 FP8/MXFP4 server launch recipes and environment hints. |
| atom/utils/envs.py | Introduces ATOM_ENABLE_GLM_FUSED_INDEXER env toggle for GLM fused indexer enablement. |
| atom/quantization/quark/utils.py | Adjusts MXFP8 online weight quant to force e8m0 scale output. |
| atom/models/deepseek_v2.py | Allows glm_moe_dsa configs to use fused indexer kernel path when env-gated. |
💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.
zejunchen-zejun
force-pushed
the
zejun/opt_GLM5.2_0701
branch
from
July 7, 2026 12:19
f4c157f to
18eaab4
Compare
Signed-off-by: zejunchen-zejun <zejun.chen@amd.com>
Signed-off-by: zejunchen-zejun <zejun.chen@amd.com>
Signed-off-by: zejunchen-zejun <zejun.chen@amd.com>
GLM-5.2 (glm_moe_dsa) was hard-excluded from the fused indexer path added for DeepSeek-V3.2 in #788, forcing the indexer's rope + fp8-quant + kv-cache write to run as 5-6 separate ops per layer per token. GLM's indexer is structurally identical to V3.2 (index_head_dim=128, qk_rope_head_dim=64, per_1x128 fp8 quant, always-neox indexer rope), so the fused indexer_qk_rope_quant_and_cache kernel is math-equivalent to the per-op path. Notably the recent GLM acc fix (da360a2) fixed a bug that only exists in the per-op path (dropping q_nope on recombine); the fused kernel never had it. - Allow glm_moe_dsa through _supports_fused_indexer_kernel_config, gated by a new env ATOM_ENABLE_GLM_FUSED_INDEXER (default on) for easy A/B + rollback. - Keep the wk+weights_proj GEMM merge OFF for GLM (decoupled in _can_fuse_indexer_wk_weights_proj): that fusion requires merging two checkpoint tensors and GLM names weights_proj "indexers_proj" without a pre-mergeable layout. The dominant win (rope+quant+cache) needs no merge. DeepSeek-V3.2 behavior is unchanged. Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
Remove the guard that kept the indexer wk+weights_proj GEMM-merge off for glm_moe_dsa. The guard was overly conservative: it assumed GLM checkpoints ship the projection under a non-standard "indexers_proj" name that couldn't feed the packed_modules_mapping merge. In fact "indexers_proj" only appears in the HF quant config's modules_to_not_convert (remapped via quant_exclude_name_mapping); the actual checkpoint tensors use the standard indexer.wk (fp8 block-scale) + indexer.weights_proj (bf16) paths — exactly the layout IndexerWkWeightsProjLinear's fp8-wk load and the merge expect. GLM now takes the same path as DeepSeek-V3.2: wk + weights_proj collapse into a single BF16 GEMM (IndexerWkWeightsProjLinear), on top of the already-enabled qk-rope+quant+cache fusion. Still gated by ATOM_ENABLE_GLM_FUSED_INDEXER for rollback. DeepSeek-V3.2 behavior unchanged. Verify on GPU: weights load without missing indexer.wk / indexer.weights_proj, accuracy unchanged, and the two small indexer GEMMs collapse to one in the decode breakdown. Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
Signed-off-by: zejunchen-zejun <zejun.chen@amd.com>
Signed-off-by: zejunchen-zejun <zejun.chen@amd.com>
Signed-off-by: whx-sjtu <xiaowang990929@gmail.com>
Signed-off-by: zejunchen-zejun <zejun.chen@amd.com>
* enable ar+norm+quant fusion * fix fusion with online quant
Signed-off-by: zejunchen-zejun <zejun.chen@amd.com>
Signed-off-by: zejunchen-zejun <zejun.chen@amd.com>
zejunchen-zejun
force-pushed
the
zejun/opt_GLM5.2_0701
branch
from
July 8, 2026 02:52
3fe3c11 to
5aacdc6
Compare
Comment on lines
+92
to
+96
| # GLM-5.2 (glm_moe_dsa): enable the fused indexer qk-rope + fp8-quant + kv-cache | ||
| # kernel (indexer_qk_rope_quant_and_cache), same path DeepSeek-V3.2 uses. GLM's | ||
| # indexer dims (index_head_dim=128, qk_rope_head_dim=64, per_1x128, neox rope) are | ||
| # identical to V3.2, so the fusion is math-equivalent to the unfused path. Set to | ||
| # "0" to fall back to the per-op Python path if a regression is suspected. |
Comment on lines
+172
to
+176
| # GLM-5.2 (glm_moe_dsa) shares DeepSeek-V3.2's sparse-MLA indexer: same dims | ||
| # (index_head_dim=128, qk_rope_head_dim=64), same per_1x128 fp8 quant, and the | ||
| # indexer rope is always neox for both. The fused kernel path is therefore | ||
| # math-equivalent to the per-op path, so allow it here (gated by an env flag for | ||
| # easy rollback). This also enables the wk+weights_proj GEMM-merge for GLM — its |
Signed-off-by: zejunchen-zejun <zejun.chen@amd.com>
| @@ -2006,8 +2034,16 @@ def forward( | |||
| hidden_states: torch.Tensor, | |||
quant draft model to fp8 Signed-off-by: zejunchen-zejun <zejun.chen@amd.com>
Comment on lines
221
to
224
| "model_name": "GLM-5.2-MXFP4", | ||
| "model_path": "amd/GLM-5.2-MXFP4", | ||
| "extraArgs": "--kv_cache_dtype fp8 -tp 4 --default-chat-template-kwargs '{\"enable_thinking\":false}' --online_quant_config '{\"global_quant_config\": \"ptpc_fp8\", \"exclude_layer\": [\"lm_head\", \"model.embed_tokens\", \"*.mlp.gate\", \"*expert*\"]}'", | ||
| "extraArgs": "--kv_cache_dtype fp8 -tp 4 --online_quant_config '{\"global_quant_config\": \"ptpc_fp8\", \"exclude_layer\": [\"lm_head\", \"model.embed_tokens\", \"*.mlp.gate\", \"*expert*\"]}'", | ||
| "env_vars": "AITER_QUICK_REDUCE_QUANTIZATION=INT4\nAITER_USE_FLYDSL_MOE_SORTING=1", |
Comment on lines
233
to
236
| "model_name": "GLM-5.2-MXFP4 MTP", | ||
| "model_path": "amd/GLM-5.2-MXFP4", | ||
| "extraArgs": "--kv_cache_dtype fp8 -tp 4 --default-chat-template-kwargs '{\"enable_thinking\":false}' --online_quant_config '{\"global_quant_config\": \"ptpc_fp8\", \"exclude_layer\": [\"lm_head\", \"model.embed_tokens\", \"*.mlp.gate\", \"*expert*\"]}' --method mtp --num-speculative-tokens 3", | ||
| "extraArgs": "--kv_cache_dtype fp8 -tp 4 --online_quant_config '{\"global_quant_config\": \"ptpc_fp8\", \"exclude_layer\": [\"lm_head\", \"model.embed_tokens\", \"*.mlp.gate\", \"model.layers.[0-9].mlp.*expert*\", \"model.layers.[1-6][0-9].mlp.*expert*\", \"model.layers.7[0-7].mlp.*expert*\"]}' --method mtp --num-speculative-tokens 3", | ||
| "env_vars": "AITER_QUICK_REDUCE_QUANTIZATION=INT4\nAITER_USE_FLYDSL_MOE_SORTING=1", |
Comment on lines
180
to
184
| if getattr(config, "model_type", None) == "glm_moe_dsa": | ||
| return False | ||
| if not ENABLE_GLM_FUSED_INDEXER: | ||
| return False | ||
| return ( | ||
| getattr(config, "index_head_dim", None) == 128 |
Comment on lines
180
to
183
| Tips on server configuration: | ||
| - Use `--kv_cache_dtype bf16` for the DSA sparse-attention path on CDNA4 (gfx950). | ||
| - `--gpu-memory-utilization 0.8` leaves headroom for the per-layer DSA index cache; higher values may OOM during KV-cache allocation. | ||
| - Use the FP8, MXFP4, or MXFP4 MTP server recipes above for GLM-5.2. | ||
| - Use `--kv_cache_dtype fp8` with the optimized GLM-5.2 server recipes unless you are intentionally comparing against the older bf16 KV-cache baseline. | ||
| - No `--trust-remote-code` is needed — ATOM has built-in support for `GlmMoeDsaForCausalLM`. |
Comment on lines
+92
to
+96
| # GLM-5.2 (glm_moe_dsa): enable the fused indexer qk-rope + fp8-quant + kv-cache | ||
| # kernel (indexer_qk_rope_quant_and_cache), same path DeepSeek-V3.2 uses. GLM's | ||
| # indexer dims (index_head_dim=128, qk_rope_head_dim=64, per_1x128, neox rope) are | ||
| # identical to V3.2, so the fusion is math-equivalent to the unfused path. Set to | ||
| # "0" to fall back to the per-op Python path if a regression is suspected. |
Comment on lines
+345
to
+349
| if self.use_fused_quant and self.quant_type.value in ( | ||
| _QV_PER_1X128, | ||
| _QV_PER_TOKEN, | ||
| ): | ||
| # Combined AllReduce + RMSNorm + FP8 quant: the downstream GEMM |
Signed-off-by: zejunchen-zejun <zejun.chen@amd.com>
| "model_name": "GLM-5.2-MXFP4 MTP", | ||
| "model_path": "amd/GLM-5.2-MXFP4", | ||
| "extraArgs": "--kv_cache_dtype fp8 -tp 4 --default-chat-template-kwargs '{\"enable_thinking\":false}' --online_quant_config '{\"global_quant_config\": \"ptpc_fp8\", \"exclude_layer\": [\"lm_head\", \"model.embed_tokens\", \"*.mlp.gate\", \"*expert*\"]}' --method mtp --num-speculative-tokens 3", | ||
| "extraArgs": "-tp 4 --online_quant_config '{\"global_quant_config\": \"ptpc_fp8\", \"exclude_layer\": [\"lm_head\", \"model.embed_tokens\", \"*.mlp.gate\", \"model.layers.[0-9].mlp.*expert*\", \"model.layers.[1-6][0-9].mlp.*expert*\", \"model.layers.7[0-7].mlp.*expert*\"]}' --method mtp --num-speculative-tokens 3", |
Comment on lines
+27
to
+32
| python -m atom.entrypoints.openai_server \ | ||
| --model "$model_path" \ | ||
| --server-port 7777 \ | ||
| --kv_cache_dtype fp8 \ | ||
| --no-enable_prefix_caching \ | ||
| -tp $TP 2>&1 | tee server.log & |
valarLip
approved these changes
Jul 11, 2026
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Uh oh!
There was an error while loading. Please reload this page.