Skip to content

[AMD] Kimi-K2.5 MXFP4 ATOMESH disagg config #2172

Merged
Oseltamivir merged 19 commits into
mainfrom
amd/k2.5_atom_pd_fp4_0713
Jul 16, 2026
Merged

[AMD] Kimi-K2.5 MXFP4 ATOMESH disagg config #2172
Oseltamivir merged 19 commits into
mainfrom
amd/k2.5_atom_pd_fp4_0713

Conversation

@seungrokj

Copy link
Copy Markdown
Collaborator

Summary

  • Add Kimi-K2.5-MXFP4 entry to models_atom.yaml for ATOM PD-disaggregated inference with env vars (ATOM_DISABLE_MMAP, AITER_QUICK_REDUCE_QUANTIZATION=INT4, AITER_MXFP4_INTERMEDIATE=1, OMP_NUM_THREADS=1) and --kv_cache_dtype fp8
  • Implement scheduler_delay_factor as a new YAML-driven parameter in server_atom.sh (YAML > env var > unset), set to 1 for Kimi-K2.5
  • Update perf-changelog with the new config key kimik2.5-fp4-mi355x-atom-disagg

Test plan

  • Verify kimik2.5-fp4-mi355x-atom-disagg CI sweep launches correctly with the new models_atom.yaml entry
  • Confirm --scheduler-delay-factor 1 appears in prefill and decode server launch commands
  • Validate that models without scheduler_delay_factor in YAML are unaffected (flag not injected)

🤖 Generated with Claude Code

@github-actions

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 关于重新运行失败任务的文档

@seungrokj seungrokj changed the title [AMD][ATOM] Add Kimi-K2.5 MXFP4 disagg config and scheduler-delay-factor support [AMD] Kimi-K2.5 MXFP4 ATOMESH disagg config Jul 13, 2026
@seungrokj seungrokj added AMD full-sweep-fail-fast evals-only Suppress throughput and run only eval jobs; combine with all-evals to expand selection labels Jul 13, 2026
Comment thread perf-changelog.yaml
Comment on lines +4737 to +4742
- config-keys:
- kimik2.5-fp4-mi355x-atom-disagg
description:
- "Add Kimi-K2.5-MXFP4 entry to models_atom.yaml for ATOM disaggregated inference"
- "Set env: ATOM_DISABLE_MMAP=true, AITER_QUICK_REDUCE_QUANTIZATION=INT4, AITER_MXFP4_INTERMEDIATE=1, OMP_NUM_THREADS=1"
- "Add scheduler_delay_factor support to models_atom.yaml schema and server_atom.sh; set to 1 for Kimi-K2.5"

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.

🔴 The new perf-changelog entry at lines 4737-4742 has two blocking issues that will hard-fail this PR's own sweep CI before any GPU work runs: (1) missing the required pr-link field — every neighboring entry has one, and ChangelogEntry in utils/matrix_logic/validation.py:714 declares pr_link as required with extra="forbid", so ChangelogEntry.model_validate in utils/process_changelog.py:158 will raise a Pydantic ValidationError; (2) the referenced config-keys: [kimik2.5-fp4-mi355x-atom-disagg] does not exist in configs/amd-master.yaml — only the non-disagg kimik2.5-fp4-mi355x-atom (line 811) is defined, so get_config_keys_from_master in utils/process_changelog.py:101-102 will raise ValueError: Config key '\''kimik2.5-fp4-mi355x-atom-disagg'\'' not found in master configs. Fix by appending pr-link: https://github.com/SemiAnalysisAI/InferenceX/pull/2172 and either adding the kimik2.5-fp4-mi355x-atom-disagg entry to configs/amd-master.yaml or updating the changelog to reference an existing key.

Extended reasoning...

What the bug is

The new perf-changelog entry appended at perf-changelog.yaml:4737-4742 has two independent defects that both cause utils/process_changelog.py (invoked from .github/workflows/run-sweep.yml:242 on every labeled PR) to raise before the sweep does any real work.

Issue 1 — missing required pr-link

utils/matrix_logic/validation.py:708-714 defines:

class ChangelogEntry(BaseModel):
    model_config = ConfigDict(extra="forbid", populate_by_name=True)
    config_keys: List[str] = Field(alias="config-keys")
    description: List[str]
    pr_link: str = Field(alias="pr-link")   # no default → required

utils/process_changelog.py:158 runs ChangelogEntry.model_validate(entry_data) on every entry parsed out of the diff. The new entry has no pr-link: line, unlike every neighboring entry (e.g. lines 4710, 4718, 4726, 4735), so validation raises a Pydantic ValidationError: pr-link Field required.

Issue 2 — config-key does not exist in master config

configs/amd-master.yaml contains only kimik2.5-fp4-mi355x-atom (line 811, framework: atom, non-disagg). It has no kimik2.5-fp4-mi355x-atom-disagg key, even though sibling -atom-disagg keys exist for other models (dsv4-fp4-mi355x-atom-disagg L2344, minimaxm3-fp8-mi355x-atom-disagg L2651, minimaxm3-fp4-mi355x-atom-disagg L2721).

utils/process_changelog.py:87-105 get_config_keys_from_master raises ValueError('Config key "{k}" not found in master configs.') for any non-wildcard key not present in the loaded master config. The key here has no *, so it hits that branch and raises.

Step-by-step proof

  1. PR is labeled full-sweep-fail-fast (per the recipe-reminder bot on this PR).
  2. .github/workflows/run-sweep.yml:242 invokes python utils/process_changelog.py.
  3. process_changelog.py calls get_added_linesyaml.safe_load on the added entries.
  4. For the appended entry, it calls ChangelogEntry.model_validate({'config-keys': ['kimik2.5-fp4-mi355x-atom-disagg'], 'description': [...]}) — no pr-link key.
  5. Pydantic raises ValidationError: pr-link Field required.
  6. Even if pr-link were present, the next call get_config_keys_from_master(['kimik2.5-fp4-mi355x-atom-disagg'], master_config) would then raise ValueError: Config key 'kimik2.5-fp4-mi355x-atom-disagg' not found in master configs. — the key falls into the elif branch at line 101 because it has no * wildcard and is not present in the loaded YAML.
  7. The workflow step exits non-zero and the entire sweep is skipped.

Why existing code doesn't prevent it

Both checks are strict-by-design: extra="forbid" combined with an aliased required field, and get_config_keys_from_master explicitly raises rather than warning. This is intentional — the changelog is authoritative and stale/invalid keys should fail loud. Nothing in the PR touches configs/amd-master.yaml to define the referenced -atom-disagg variant, and nothing added pr-link to the new entry.

Impact

The PR's own full-sweep CI (and any future main-branch sweep processing this changelog line) hard-fails at the changelog validation step, before any GPU allocation. The new Kimi-K2.5 disagg config never gets exercised end-to-end.

How to fix

Two small changes to the entry / master config:

  1. Add pr-link: https://github.com/SemiAnalysisAI/InferenceX/pull/2172 under the new entry (matches every neighbor).
  2. Either add a kimik2.5-fp4-mi355x-atom-disagg entry to configs/amd-master.yaml alongside the models_atom.yaml / server_atom.sh changes (framework: atom-disagg, model: amd/Kimi-K2.5-MXFP4, multinode scenarios like the sibling MiniMax entries), or update the changelog line to reference an existing key such as kimik2.5-fp4-mi355x-atom if the disagg config is intentionally deferred.

@github-actions

Copy link
Copy Markdown
Contributor

@github-actions

Copy link
Copy Markdown
Contributor

@seungrokj seungrokj added full-sweep-enabled and removed full-sweep-fail-fast evals-only Suppress throughput and run only eval jobs; combine with all-evals to expand selection labels Jul 13, 2026
@github-actions

Copy link
Copy Markdown
Contributor

@github-actions

Copy link
Copy Markdown
Contributor

1 similar comment
@github-actions

Copy link
Copy Markdown
Contributor

@github-actions

Copy link
Copy Markdown
Contributor

seungrokj and others added 5 commits July 14, 2026 06:09
…tor support

Add Kimi-K2.5-MXFP4 entry to models_atom.yaml with env vars and
kv_cache_dtype from the single-node script. Implement scheduler_delay_factor
as a new YAML-driven server_atom.sh parameter so models can set
--scheduler-delay-factor per-model.

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
…rt, and perf-changelog

Add Kimi-K2.5-MXFP4 to models_atom.yaml for ATOM PD-disagg with env vars
from single-node script. Implement scheduler_delay_factor as a new
YAML-driven parameter in server_atom.sh. Update perf-changelog.

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
Add atom-disagg branch to engine-specific extra flags in bench.sh,
setting --trust-remote-code --tokenizer and MTP flags (--dsv4 or
--use-chat-template) matching the vllm-disagg and sglang patterns.

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
@seungrokj
seungrokj force-pushed the amd/k2.5_atom_pd_fp4_0713 branch from 6372d52 to ffe3e10 Compare July 13, 2026 21:10
…ogies

Replace previous 1P2D/2P1D/1P1D scenarios with 2P1D, 1P4D, and 1P2D
topologies for 8k/1k ISL/OSL. Trim concurrency lists for faster sweeps.

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
@github-actions

Copy link
Copy Markdown
Contributor

Remove 1P2D topology, keep 1P1D with extended concurrency list up to 1024.

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
@github-actions

Copy link
Copy Markdown
Contributor

seungrokj and others added 2 commits July 14, 2026 15:35
…sagg

Update image to atomesh_202607121715. Add 1P2D 8k/1k scenario alongside
existing 1P1D with same concurrency sweep up to 1024.

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
@github-actions

Copy link
Copy Markdown
Contributor

seungrokj and others added 2 commits July 14, 2026 22:17
Add explicit max_num_seqs=256 to match upstream, remove 1P2D topology,
and cap concurrency at 256.

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
@github-actions

Copy link
Copy Markdown
Contributor

@github-actions

Copy link
Copy Markdown
Contributor

@github-actions

Copy link
Copy Markdown
Contributor

seungrokj and others added 2 commits July 15, 2026 17:39
Scale decode to 2 workers across 2 nodes (TP8 each, DECODE_NODES=2).

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
Run both topologies: 1P1D at high concurrency [32,64,128,256] and
1P2D at low concurrency [1,2,4,8,16,32].

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
@github-actions

Copy link
Copy Markdown
Contributor

@github-actions

Copy link
Copy Markdown
Contributor

Move conc=16 from 1P2D to 1P1D; move conc=32 out of 1P2D.

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
@github-actions

Copy link
Copy Markdown
Contributor

@seungrokj

Copy link
Copy Markdown
Collaborator Author

/reuse-sweep-run

@seungrokj

Copy link
Copy Markdown
Collaborator Author

kimik2.5 atom PD recipe at ROCm/ATOM#1575

@chunfangamd chunfangamd 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. Link: https://github.com/SemiAnalysisAI/InferenceX/actions/runs/29406333352
  • Verified that this PR passes evals. Please link to GitHub Action workflow that shows this. Range: 97.35% - 97.50%, Link: https://github.com/SemiAnalysisAI/InferenceX/actions/runs/29406333352
  • Verified that speculative decoding PRs uses chat templates to align the AL distribution to real world
  • This PR is not for the agentic workloads (For agentic workloads: verified that speculative-decoding configs (EAGLE / MTP / draft models) run with simulated synthetic acceptance, with the acceptance-length value taken from the committed golden AL curve in golden_al_distribution/ for that model, thinking mode, and draft length. A submission may choose any supported draft length, but it may not substitute a different acceptance target.)
  • 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 every single-node vLLM/SGLang recipe in this PR is documented in the official vLLM recipes and/or the SGLang cookbook:
    • I linked the corresponding upstream PR in the vLLM recipe repo or SGLang repo and verified that it is MERGED before this InferenceX PR merges. An opened, draft, or closed-without-merge upstream PR does not satisfy this requirement. If the matching recipe was already published, I linked the published recipe/cookbook page in the additional detail section below.
  • Verified that this PR does not patch the inference engine or serving stack — the pinned image must run as shipped. This covers .patch files / git apply / patch, inline patches embedded in benchmark scripts (e.g. a python3/sed heredoc that rewrites installed engine sources before serving), in-place edits of site-packages, monkey-patching, overwriting container files, and installing forked/rebuilt engine wheels on top of the pinned image. The only exception is a patch covered by a filled-out waiver at docs/waiver/<PR_NUMBER>.md — named after the PR that introduces the patch and filed in that same PR, stating what is patched, why the unmodified upstream image cannot run this benchmark, the upstream PR/issue link, and the removal plan — which I have linked 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:

@chunfangamd chunfangamd 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. Link: https://github.com/SemiAnalysisAI/InferenceX/actions/runs/29406333352
  • Verified that this PR passes evals. Please link to GitHub Action workflow that shows this. Range: 97.35% - 97.50%, Link: https://github.com/SemiAnalysisAI/InferenceX/actions/runs/29406333352
  • Verified that speculative decoding PRs uses chat templates to align the AL distribution to real world
  • This PR is not for the agentic workloads (For agentic workloads: verified that speculative-decoding configs (EAGLE / MTP / draft models) run with simulated synthetic acceptance, with the acceptance-length value taken from the committed golden AL curve in golden_al_distribution/ for that model, thinking mode, and draft length. A submission may choose any supported draft length, but it may not substitute a different acceptance target.)
  • 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 every single-node vLLM/SGLang recipe in this PR is documented in the official vLLM recipes and/or the SGLang cookbook:
    • I linked the corresponding upstream PR in the vLLM recipe repo or SGLang repo and verified that it is MERGED before this InferenceX PR merges. An opened, draft, or closed-without-merge upstream PR does not satisfy this requirement. If the matching recipe was already published, I linked the published recipe/cookbook page in the additional detail section below.
  • Verified that this PR does not patch the inference engine or serving stack — the pinned image must run as shipped. This covers .patch files / git apply / patch, inline patches embedded in benchmark scripts (e.g. a python3/sed heredoc that rewrites installed engine sources before serving), in-place edits of site-packages, monkey-patching, overwriting container files, and installing forked/rebuilt engine wheels on top of the pinned image. The only exception is a patch covered by a filled-out waiver at docs/waiver/<PR_NUMBER>.md — named after the PR that introduces the patch and filed in that same PR, stating what is patched, why the unmodified upstream image cannot run this benchmark, the upstream PR/issue link, and the removal plan — which I have linked 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:

@Klaud-Cold

Copy link
Copy Markdown
Collaborator

✅✅✅ Verdict: PASS ✅✅✅

✅ Check 0 (CODEOWNER): PASS — @chunfangamd is a named owner of configs/amd-master.yaml; all other paths are catch-all (* @InferenceX/core), covered by a recognized CODEOWNER.
✅ Check 1 (green sweep+eval on in-PR commit): PASS — commit 63fe4352 (in the PR) has executed, non-skipped multi-node 8k1k / and multi-node eval / jobs (both topologies) at success: https://github.com/SemiAnalysisAI/InferenceX/actions/runs/29406333352
✅ Check 2 (evals accuracy): PASS — gsm8k em_strict 97.50% (1P1D TP4) / 97.35% (1P2D TP8), matching the sign-off range, on the same rocm/atom:...atomesh_202607121715 image as the PR config.
➖ Check 3 (recipe link/merged/complete): N/A — disaggregated/multi-node submission (framework: atom-disagg, multinode/disagg: true, files under benchmarks/multi_node/**); the recipe-link requirement applies to single-node recipes only.
✅ Check 4 (reuse-sweep command): PASS — /reuse-sweep-run posted by @seungrokj (COLLABORATOR).
✅ Check 5 (latest template): PASS — sign-off contains all current-template items; the evals box is left unchecked but carries its passing range + run link inline (evals independently confirmed in Check 2).
✅ Check 6 (upstream image / engine-first): PASS — engine-first satisfied: a vLLM entry for the same model+SKU already exists (kimik2.5-fp4-mi355x-vllm-disagg, runner: mi355x-disagg). The upstream-image rule targets vLLM/SGLang entries; this PR adds only an ATOM (atom-disagg) entry.
✅ Check 7 (no architecture hacks): PASS — only --scheduler-delay-factor, --kv_cache_dtype fp8, and AITER quant/precision env toggles; no --hf-overrides or FLOP-reducing edits.
➖ Check 8 (spec-decode chat templates): N/A — this config is spec-decoding: "none" (the added MTP branch in bench.sh uses --use-chat-template regardless).
✅ Check 9 (no engine patches): PASS — no .patch/git apply/sed -i on engine sources or forked-wheel installs; the server_atom.sh heredoc only reads model YAML to build launch args.
➖ Check 10 (agentic spec-decode golden AL): N/A — not agentic and no speculative decoding; no simulated-acceptance knobs present.

@Oseltamivir Oseltamivir 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, no patches, dram rule enforced, atom recipe merged, pr checklist done

generate_sweep_configs.py no longer hardcodes total_cpu_dram_gb = 0 for multinode. It folds multinode into agentic_dram_offload_gb, sizing from the prefill worker's per-node GPU footprint (worker_gpus_per_node), still min(node_DRAM, 3TB) × utilization × gpus_used/gpus_per_node. For this 1P1D TP8 config that's ≈ 2400 GB/node.

total_cpu_dram_gb is now a required field on MultiNodeAgenticMatrixEntry

@Oseltamivir
Oseltamivir merged commit 6b431f9 into main Jul 16, 2026
30 checks passed
@Oseltamivir
Oseltamivir deleted the amd/k2.5_atom_pd_fp4_0713 branch July 16, 2026 13:44
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