Skip to content

[AMD] Minimax-M3-MXFP8 Eagle3 Draft attention backend override TRITON_ATTN for performance/Minimax-M3-MXFP8 Eagle3草稿模型的注意力后端固定为 TRITON_ATTN以提高性能#2107

Merged
cquil11 merged 4 commits into
mainfrom
hy/mm3-mxfp8-eagle-opt
Jul 7, 2026
Merged

[AMD] Minimax-M3-MXFP8 Eagle3 Draft attention backend override TRITON_ATTN for performance/Minimax-M3-MXFP8 Eagle3草稿模型的注意力后端固定为 TRITON_ATTN以提高性能#2107
cquil11 merged 4 commits into
mainfrom
hy/mm3-mxfp8-eagle-opt

Conversation

@hongxiayang

@hongxiayang hongxiayang commented Jul 6, 2026

Copy link
Copy Markdown
Collaborator

[AMD] Minimax-M3-MXFP8 Eagle3 Draft attention backend override TRITON_ATTN for performance

Tested on local 1k/1k and 8k/1k vs no override. the perf improves across all concurrencies.

在推测配置中将 EAGLE3 草稿模型的注意力后端固定为 TRITON_ATTN,避免回退到较慢的默认后端。在 MI355X TP4 MXFP8 上,1k/1k 和 8k/1k 各并发下吞吐均有提升

image

Associated vLLM recipe PR: vllm-project/recipes#615

…for perf

Signed-off-by: Hongxia Yang <hongxia.yang@amd.com>
@github-actions

github-actions Bot commented Jul 6, 2026

Copy link
Copy Markdown
Contributor

Thanks for the contribution! Please reach out to respective companies' CODEOWNER to fill in the latest PR_REVIEW_CHECKLIST.md before pinging core maintainer on Slack for review. In order for the signoff PR check bot to trigger, you must follow the PR_REVIEW_CHECKLIST.md template correctly, including the phrase As a PR reviewer and CODEOWNER, I have reviewed this and have.

For PR verification, add the full-sweep-fail-fast label (strongly recommended) to this PR — the benchmark sweep only runs on labeled PRs. Use full-sweep-enabled only if you need matrix jobs to keep running past a failure.

PR authors are responsible for ensuring that after merging, all GitHub Action jobs fully pass. A lot of the time, failures are just flakes and simply re-running the failed jobs will fix it. See GitHub's docs on re-running failed jobs


感谢你的贡献!请联系相应公司的 CODEOWNER 填写最新的 PR_REVIEW_CHECKLIST.md,然后再在 Slack 上联系核心维护者进行审阅。为了触发 signoff PR 检查机器人,你必须正确遵循 PR_REVIEW_CHECKLIST.md 模板,包括保留英文语句 As a PR reviewer and CODEOWNER, I have reviewed this and have

如需进行 PR 验证,请为此 PR 添加 full-sweep-fail-fast 标签(强烈推荐)— 基准测试 sweep 仅在带有标签的 PR 上运行。仅当需要矩阵任务在失败后继续运行时才使用 full-sweep-enabled

PR 作者有责任确保合并后所有 GitHub Action 任务完全通过。 很多时候失败只是偶发抖动(flake),重新运行失败的任务即可解决。参见 GitHub 关于重新运行失败任务的文档

Signed-off-by: Hongxia Yang <hongxia.yang@amd.com>
@hongxiayang hongxiayang marked this pull request as ready for review July 6, 2026 23:10
@hongxiayang hongxiayang requested a review from a team July 6, 2026 23:10
@claude

claude Bot commented Jul 6, 2026

Copy link
Copy Markdown
Contributor

Claude finished @hongxiayang's task in 1m 49s —— View job


PR Review

LGTM - no blocking issues found

Verified:

  • attention_backend in --speculative-config is a supported, established pattern — the CUDA MiniMax-M3 MTP recipes (minimaxm3_fp8_b200_mtp.sh, minimaxm3_fp8_b300_mtp.sh, minimaxm3_fp8_h100_mtp.sh, minimaxm3_fp8_h200_mtp.sh, etc.) already use the same key
  • MTP requirements: --use-chat-template present in the benchmark client (line 219)
  • Expert parallelism is correctly conditional on EP_SIZE / DP_ATTENTION
  • perf-changelog.yaml entry is appended at the end of the file with the correct config key (minimaxm3-fp8-mi355x-vllm-mtp) and PR link
  • Server launch command remains properly formatted with one argument per line

Non-blocking observation: the sibling AMD recipes minimaxm3_fp8_mi300x_mtp.sh and minimaxm3_fp8_mi325x_mtp.sh still carry the old "drafter needs no attention_backend override" comment. If the drafter fallback behavior is the same there, they may benefit from the same override in a follow-up — worth a local A/B when convenient.

@claude claude Bot left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

LGTM — small, self-contained recipe tweak adding an explicit attention_backend override for the EAGLE3 drafter, plus matching comment and changelog entry.

Extended reasoning...

Overview

This PR makes a single functional change to benchmarks/single_node/fixed_seq_len/minimaxm3_fp8_mi355x_mtp.sh: it adds "attention_backend": "TRITON_ATTN" to the JSON passed to --speculative-config, pinning the EAGLE3 drafter's attention backend rather than letting it fall back to a slow default. It also refreshes the recipe header comment to describe the new override and adds a corresponding entry to perf-changelog.yaml.

Security risks

None. This is a benchmark recipe script and a YAML changelog entry. No auth, crypto, permissions, or externally-exposed surface is touched. The change adds one string field to a JSON blob that's already interpolated into a CLI flag on the same line.

Level of scrutiny

Low. The recipe files under benchmarks/single_node/ are per-model launch scripts, not production inference code, and this PR touches exactly one line of vLLM CLI configuration on that recipe plus a matching changelog line. The full-sweep-fail-fast label is applied, so the change is being validated end-to-end by the benchmark sweep before merge. Follows the same pattern the CUDA EAGLE3 recipes already use for overriding the drafter's attention backend.

Other factors

The bug hunter surfaced only two nits: grammar wording in the perf-changelog entry / recipe comment ("falls to" vs "falls back to", missing subject in the parenthetical) and missing Chinese translations in the PR title/body per AGENTS.md. Neither affects correctness — they can be addressed in a quick follow-up edit or left as-is at author discretion. No prior human reviewer comments are outstanding.

Comment thread perf-changelog.yaml Outdated
Comment thread benchmarks/single_node/fixed_seq_len/minimaxm3_fp8_mi355x_mtp.sh
@github-actions

github-actions Bot commented Jul 7, 2026

Copy link
Copy Markdown
Contributor

@hongxiayang hongxiayang changed the title [AMD] Minimax-M3-MXFP8 Eagle3 Draft attention backend override TRITON_ATTN for performance [AMD] Minimax-M3-MXFP8 Eagle3 Draft attention backend override TRITON_ATTN for performance/Minimax-M3-MXFP8 Eagle3草稿模型的注意力后端固定为 TRITON_ATTN以提高性能 Jul 7, 2026
Signed-off-by: Hongxia Yang <hongxia.yang@amd.com>
@hongxiayang

Copy link
Copy Markdown
Collaborator Author

CC @seungrokj @chunfangamd as Codeowners to further review and signoff

@hongxiayang

Copy link
Copy Markdown
Collaborator Author

/reuse-sweep-run

@github-actions

github-actions Bot commented Jul 7, 2026

Copy link
Copy Markdown
Contributor

@seungrokj seungrokj added the AMD label Jul 7, 2026
@seungrokj seungrokj assigned seungrokj and unassigned seungrokj Jul 7, 2026

@seungrokj seungrokj left a comment

Copy link
Copy Markdown
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

As a PR reviewer and CODEOWNER, I have reviewed this and have:

  • Verified that as of the moment of typing this, this is the latest version of PR_REVIEW_CHECKLIST.md
  • Verified that the general code quality meets the InferenceX standard and does not make the code quality any worse.
  • Verified that this PR has passed PR validation. Please link to GitHub Action workflow that shows this.
  • Verified that this PR passes evals. Please link to GitHub Action workflow that shows this.
  • Verified that speculative decoding PRs uses chat templates to align the AL distribution to real world
  • Verified that the model architecture isn't changed with benchmark hacks like using --hf-overrides to skipping indexer for every x layers on models that don't natively support this. As a general rule, we won't accept optimizations that reduces the number of model architecture FLOPs. Anything that makes that same computation run faster is fair game; FLOPs at lower precisions is fine, given that the config passes private evals. As an general north star princple, we should only use optimizations which is used in production by customers that care about accuracy
  • If an company claims that they support vLLM/SGLang as first class LLM inference engines on their hardware, I have verified that the respective vLLM submission made using upstream https://hub.docker.com/u/vllm docker repo, upstream SGLang https://hub.docker.com/u/lmsysorg docker repo. The only exceptions are for new hardware, such as MI455X UALoE72, Vera Rubin NVL72, Rubin NVL8, etc., and for new model architectures where there is an actual reason why vLLM/SGLang does not fundamentally support them yet as supported by vLLM/SGLang community maintainers
  • If an company claims that they support vLLM/SGLang as first class upstream in-tree LLM inference engines on their hardware, I have have verified that the respective vLLM/SGLang submission has been made before additional frameworks (TRT-LLM, ATOM, etc.). The only exceptions are for new hardware, such as MI455X UALoE72, Vera Rubin NVL72, Rubin NVL8, etc., and for new model architectures where there is an actual reason why vLLM/SGLang does not fundamentally support them yet.
  • Verified that the single-node recipes are similar to the official vLLM recipes and/or theSGLang cookbook:
    • If they are not, I have verified that a PR has been opened in vLLM recipe repo or SGLang repo and linked it below in the additional detail section:
  • If any of the above criteria cannot reasonably be satisfied, I have provided additional reasoning below.

Additional detail section:

Signed: seungrokj

@seungrokj seungrokj self-requested a review July 7, 2026 10:38
@Klaud-Cold

Copy link
Copy Markdown
Collaborator

❌❌❌ REJECTED ❌❌❌

@seungrokj — the sign-off comment (id 4902845254) no longer exists on this PR (API returns 404 and no sign-off from you appears in the conversation or reviews), so the checklist and its additional-detail section cannot be verified. Please re-post the completed latest PR_REVIEW_CHECKLIST.md including the recipe link — everything else about this PR is to standard.

✅ Check 0 (CODEOWNER): PASS — @seungrokj is a recognized CODEOWNER (configs/amd-master.yaml owners); both changed files fall under the * catch-all, which any recognized CODEOWNER satisfies.
✅ Check 1 (sweep on in-PR commit): PASS — green executed single-node 1k1k/8k1k / + eval / jobs on in-PR commit b4ff7aa: run 28834955707.
✅ Check 2 (evals pass): PASS — GSM8K em_strict 0.962 (conc512) / 0.951 (conc128), n_eff=1319, run on the config's image vllm/vllm-openai-rocm:nightly-09663abde....
❌ Check 3 (recipe link in sign-off): FAIL — the sign-off's additional-detail section is gone with the deleted comment, so no recipe link is on record there; note vllm-project/recipes#615 (merged) matches this PR's change exactly (AMD override pinning the EAGLE3 drafter to attention_backend: TRITON_ATTN), so re-posting the sign-off with that link resolves this.
✅ Check 4 (/reuse-sweep-run): PASS — posted by hongxiayang (COLLABORATOR).
❌ Check 5 (latest checklist): FAIL — no sign-off checklist exists on the PR (comment deleted); nothing to compare against the current template.
➖ Check 6 (upstream image / engine-first): N/A — no configs/*-master.yaml entries changed; the existing minimaxm3-fp8-mi355x-vllm-mtp entry already uses upstream vllm/vllm-openai-rocm.
✅ Check 7 (no architecture hacks): PASS — the only server-arg change pins the drafter's attention backend (kernel selection); no FLOP-reducing overrides.
✅ Check 8 (spec-decode chat template): PASS — benchmark client drives the model with --use-chat-template.

@seungrokj seungrokj left a comment

Copy link
Copy Markdown
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

As a PR reviewer and CODEOWNER, I have reviewed this and have:

  • Verified that as of the moment of typing this, this is the latest version of PR_REVIEW_CHECKLIST.md
  • Verified that the general code quality meets the InferenceX standard and does not make the code quality any worse.
  • Verified that this PR has passed PR validation. Please link to GitHub Action workflow that shows this.
  • Verified that this PR passes evals. Please link to GitHub Action workflow that shows this.
  • Verified that speculative decoding PRs uses chat templates to align the AL distribution to real world
  • Verified that the model architecture isn't changed with benchmark hacks like using --hf-overrides to skipping indexer for every x layers on models that don't natively support this. As a general rule, we won't accept optimizations that reduces the number of model architecture FLOPs. Anything that makes that same computation run faster is fair game; FLOPs at lower precisions is fine, given that the config passes private evals. As an general north star princple, we should only use optimizations which is used in production by customers that care about accuracy
  • If an company claims that they support vLLM/SGLang as first class LLM inference engines on their hardware, I have verified that the respective vLLM submission made using upstream https://hub.docker.com/u/vllm docker repo, upstream SGLang https://hub.docker.com/u/lmsysorg docker repo. The only exceptions are for new hardware, such as MI455X UALoE72, Vera Rubin NVL72, Rubin NVL8, etc., and for new model architectures where there is an actual reason why vLLM/SGLang does not fundamentally support them yet as supported by vLLM/SGLang community maintainers
  • If an company claims that they support vLLM/SGLang as first class upstream in-tree LLM inference engines on their hardware, I have have verified that the respective vLLM/SGLang submission has been made before additional frameworks (TRT-LLM, ATOM, etc.). The only exceptions are for new hardware, such as MI455X UALoE72, Vera Rubin NVL72, Rubin NVL8, etc., and for new model architectures where there is an actual reason why vLLM/SGLang does not fundamentally support them yet.
  • Verified that the single-node recipes are similar to the official vLLM recipes and/or theSGLang cookbook:
    • If they are not, I have verified that a PR has been opened in vLLM recipe repo or SGLang repo and linked it below in the additional detail section:
  • If any of the above criteria cannot reasonably be satisfied, I have provided additional reasoning below.

Additional detail section:

Signed: seungrokj

@Klaud-Cold

Copy link
Copy Markdown
Collaborator

✅✅✅ Verdict: PASS ✅✅✅

Supersedes the earlier REJECTED verdict for this SHA — the sign-off is now on record as a review with the recipe link, resolving Checks 3 and 5.

✅ Check 0 (CODEOWNER): PASS — @seungrokj is a recognized CODEOWNER (configs/amd-master.yaml); both changed files fall under the * catch-all, satisfied by any recognized CODEOWNER.
✅ Check 1 (sweep on in-PR commit): PASS — green executed single-node 1k1k/8k1k / + eval / jobs on in-PR commit b4ff7aa: run 28834955707 (f4d6b31 is also green via run 28829536843).
✅ Check 2 (evals pass): PASS — GSM8K em_strict 0.962 (c512) / 0.951 (c128), n_eff=1319, MiniMax-M3-MXFP8 on MI355X TP4, run on the config's image vllm/vllm-openai-rocm:nightly-09663abde....
✅ Check 3 (recipe): PASS — sign-off links MiniMax-M3.yaml; its AMD spec-decoding override is exactly this PR's change (eagle3 + Inferact/MiniMax-M3-EAGLE3 + 3 tokens + attention_backend: TRITON_ATTN), and all other major args match (MXFP8 TP4 on gfx950, --block-size 128, --attention-backend TRITON_ATTN, fp8 KV, --linear-backend emulation, AITER/QuickReduce env). Remaining diffs are harness-only (ports, sweep ranges, MAX_NUM_BATCHED_TOKENS).
✅ Check 4 (/reuse-sweep-run): PASS — posted by hongxiayang (COLLABORATOR).
✅ Check 5 (latest checklist): PASS — every item of the current docs/PR_REVIEW_CHECKLIST.md template is present and checked in the sign-off.
➖ Check 6 (upstream image / engine-first): N/A — no configs/*-master.yaml entries changed; the validated run used upstream vllm/vllm-openai-rocm regardless.
✅ Check 7 (no architecture hacks): PASS — the only server-arg change pins the drafter's attention backend (kernel selection); no FLOP-reducing overrides.
✅ Check 8 (spec-decode chat template): PASS — benchmark client drives the model with --use-chat-template.

@seungrokj

Copy link
Copy Markdown
Collaborator

@functionstackx @Oseltamivir can you plz merge this ?

@cquil11 cquil11 left a comment

Copy link
Copy Markdown
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

LGTM

@cquil11 cquil11 merged commit 17ba74b into main Jul 7, 2026
54 checks passed
@cquil11 cquil11 deleted the hy/mm3-mxfp8-eagle-opt branch July 7, 2026 15:46
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Projects

Development

Successfully merging this pull request may close these issues.

4 participants