Skip to content
Merged
Show file tree
Hide file tree
Changes from 1 commit
Commits
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
8 changes: 8 additions & 0 deletions AGENTS.md
Original file line number Diff line number Diff line change
Expand Up @@ -50,6 +50,14 @@ Then validate it in the receiving script after sourcing the shared helper:
check_env_vars IS_MULTINODE MODEL_NAME PRECISION
```

## Deprecating benchmark configs

- Move deprecated entries out of the active master config into [`configs/deprecated/amd-master.yaml`](configs/deprecated/amd-master.yaml) or [`configs/deprecated/nvidia-master.yaml`](configs/deprecated/nvidia-master.yaml), matching the vendor. These are the only deprecated master-config files; do not create separate files per model, scenario, or deprecation.
- For a partial deprecation, archive only the retired scenarios and retain the supported scenarios in the active entry. Preserve archived settings and explanatory comments; do not update historical image pins or runners during archival.
- Keep every archive key unique. If a key already exists with different settings, preserve both versions with a descriptive suffix on the historical key and a comment recording its original config key. Existing colliding 1k1k versions use `-deprecated-1k1k`. Never overwrite an archived version or add duplicate YAML keys.
- Check retirement statements in [`MODELS.md`](MODELS.md) against active configs and script routing in the same PR, and update `MODELS.md` plus `MODELS_zh.md` together. Preserve explicitly documented exceptions and conditional retirement policies; do not treat planned retirement as completed.
- Keep these archives out of active sweep inputs. Follow the existing benchmark-script archival convention, moving retired scripts into the sibling `deprecated/` directory only when no active config still uses them.

## Runner launchers (one file per pool)

- The reusable workflows run `bash ./runners/launch_${RUNNER_NAME%%_*}.sh`. The runner-name prefix before the first underscore is the only routing key, so each self-hosted pool maps to exactly one `runners/launch_<pool>.sh`, and every `runners/launch_*.sh` must be the launcher of a pool listed in [`configs/runners.yaml`](configs/runners.yaml). For example, runner `b200-nscale-slurm_03` runs `runners/launch_b200-nscale-slurm.sh`. See [Stage 4 in `docs/architecture.md`](docs/architecture.md#stage-4-launcher-and-runtime-execution).
Expand Down
6 changes: 4 additions & 2 deletions MODELS.md
Original file line number Diff line number Diff line change
Expand Up @@ -42,7 +42,7 @@ The A/B retirements below concern standalone non-spec-decode baselines maintaine

**Thursday, August 6, 2026** is the last day for the **Single-turn 8k1k** scenario on **Kimi-K2.5/2.6/2.7-Code** (`kimik2.5`). The scenario is deprecated for these models after that date. Rationale: Kimi-K3 launched on July 27, 2026, so GPU cluster time shifts to the newer frontier model. Combined with the Agentic coding deprecation above, this leaves `kimik2.5` with no active scenario. The model is **fully retired after August 6, 2026**.

**Enacted on 2026-08-07** in [#2527](https://github.com/SemiAnalysisAI/InferenceX/pull/2527): 17 `kimik2.5` config keys were removed from the active master configs and archived under [`configs/deprecated/`](configs/deprecated/) as `nvidia-kimik2.5-8k1k-master.yaml` (10) and `amd-kimik2.5-8k1k-master.yaml` (7), and their 12 benchmark scripts were moved to the sibling `deprecated/` directories. `kimik2.5` now has **no active configuration in any master config** and is fully retired. The same PR archived `kimik2.5-int4-h100-vllm`, an agentic-coding key that #2493 left behind in `nvidia-master.yaml` after moving its script to `benchmarks/single_node/agentic/deprecated/`. It is now in `nvidia-kimik2.5-agentic-master.yaml` with its siblings. The SPEED-Bench acceptance-length script `benchmarks/single_node/speedbench/kimik2.5_fp4_b300_vllm.sh` is intentionally kept. Speedbench is driven by `speedbench-al.yml`, not the master configs, matching how #2493 treated MiniMax-M3.
**Enacted on 2026-08-07** in [#2527](https://github.com/SemiAnalysisAI/InferenceX/pull/2527): 17 `kimik2.5` config keys were removed from the active master configs and archived under [`configs/deprecated/`](configs/deprecated/), now consolidated in `configs/deprecated/nvidia-master.yaml` (10) and `configs/deprecated/amd-master.yaml` (7), and their 12 benchmark scripts were moved to the sibling `deprecated/` directories. `kimik2.5` now has **no active configuration in any master config** and is fully retired. The same PR archived `kimik2.5-int4-h100-vllm`, an agentic-coding key that #2493 left behind in `nvidia-master.yaml` after moving its script to `benchmarks/single_node/agentic/deprecated/`. It is now in `configs/deprecated/nvidia-master.yaml` with its siblings. The SPEED-Bench acceptance-length script `benchmarks/single_node/speedbench/kimik2.5_fp4_b300_vllm.sh` is intentionally kept. Speedbench is driven by `speedbench-al.yml`, not the master configs, matching how #2493 treated MiniMax-M3.

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.

🟣 Maintainers following the new deprecation-audit mandate will trust a false claim: kimik2.5-int4-h100-vllm is said to now live in configs/deprecated/nvidia-master.yaml, but that key does not exist anywhere in the repo. Pre-existing (the claim already pointed at a nonexistent nvidia-kimik2.5-agentic-master.yaml before this PR); this diff rewrites the sentence to point at the new consolidated file without checking the entry actually exists there, so the fabricated claim survives the PR's own "deprecation parity audit." Fix: verify every named config key in this paragraph resolves via a real search of the archives before restating its location, and either add the missing entry or correct/remove the sentence.

Why this was flagged

MODELS.md:45 (and the mirrored MODELS_zh.md:45) states kimik2.5-int4-h100-vllm was archived by PR #2527 and 'is now in configs/deprecated/nvidia-master.yaml with its siblings'. Repo-wide grep for kimik2.5-int4-h100-vllm and for int4-h100 at HEAD finds only these two prose lines, never a YAML key, in configs/deprecated/nvidia-master.yaml, configs/nvidia-master.yaml, or any benchmark script under benchmarks/single_node/agentic/deprecated/. AGENTS.md's new 'Deprecating benchmark configs' section (added by this same diff) tells future agents to check MODELS.md retirement statements against active configs and script routing; a maintainer trusting this line would search for a sibling that was never created. The PR's own 'Deprecation parity audit (2026-09-21)' bullet added just below claims active configs and script locations were checked against enacted retirements, yet this stale, unverifiable claim was carried forward unchanged.

Verification: pre-existing. MODELS.md:45 states the PR archived kimik2.5-int4-h100-vllm and "It is now in configs/deprecated/nvidia-master.yaml with its siblings." That key exists nowhere in the repo at HEAD: a repo-wide grep for kimik2.5-int4-h100-vllm and for int4-h100 returns matches only in MODELS.md:45 and MODELS_zh.md:45 (the prose), never a YAML key. The NVIDIA deprecated config's 10 kimik2.5…


### Tuesday, September 8, 2026

Expand All @@ -54,7 +54,9 @@ The A/B retirements below concern standalone non-spec-decode baselines maintaine

Rationale: `dsv4` carries the largest single-turn footprint in the repository. 45 active config keys use the 8k1k scenario, 32 in `configs/nvidia-master.yaml` and 13 in `configs/amd-master.yaml`, spanning H200, B200, B300, GB200, GB300, MI300X, MI325X, and MI355X across vLLM, SGLang, TensorRT-LLM, ATOM, Dynamo, and llm-d. That is a large share of every full sweep. AgentX trace replay is the scenario AI labs and the ML community ask about, and DeepSeek-V4-Pro's 19 agentic config keys are the part of `dsv4` that feeds the published North Star Pareto frontier. Retiring the fixed-sequence-length arm frees cluster hours for AgentX and for new frontier models such as Qwen3.8-Flash-Next without reducing what we publish for this model. Single-turn 8k1k stays active for the other models that still list it.

**Enacted on 2026-09-09** in [#2921](https://github.com/SemiAnalysisAI/InferenceX/pull/2921): 46 `dsv4` 8k1k config keys were removed from the active master configs and archived under [`configs/deprecated/`](configs/deprecated/) as `nvidia-dsv4-8k1k-master.yaml` (33) and `amd-dsv4-8k1k-master.yaml` (13), and their 28 benchmark scripts were moved to the sibling `deprecated/` directories (25 under `benchmarks/single_node/fixed_seq_len/`, 3 under `benchmarks/multi_node/`), matching how [#2493](https://github.com/SemiAnalysisAI/InferenceX/pull/2493) and [#2527](https://github.com/SemiAnalysisAI/InferenceX/pull/2527) were carried out. The count is 46 rather than the 45 quoted above because `dsv4-fp4-b200-dynamo-sglang` landed after this notice was written. The 19 agentic-coding keys are untouched: `dsv4` continues to run and publish with agentic coding as its only scenario. The SPEED-Bench acceptance-length scripts for `dsv4` are intentionally kept. Speedbench is driven by `speedbench-al.yml`, not the master configs. The srt-slurm and llm-d recipe YAMLs referenced by the archived multi-node keys stay in place as inert reference data, as #2493 and #2527 left theirs.
**Enacted on 2026-09-09** in [#2921](https://github.com/SemiAnalysisAI/InferenceX/pull/2921): 46 `dsv4` 8k1k config keys were removed from the active master configs and archived under [`configs/deprecated/`](configs/deprecated/), now consolidated in `configs/deprecated/nvidia-master.yaml` (33) and `configs/deprecated/amd-master.yaml` (13), and their 28 benchmark scripts were moved to the sibling `deprecated/` directories (25 under `benchmarks/single_node/fixed_seq_len/`, 3 under `benchmarks/multi_node/`), matching how [#2493](https://github.com/SemiAnalysisAI/InferenceX/pull/2493) and [#2527](https://github.com/SemiAnalysisAI/InferenceX/pull/2527) were carried out. The count is 46 rather than the 45 quoted above because `dsv4-fp4-b200-dynamo-sglang` landed after this notice was written. The 19 agentic-coding keys are untouched: `dsv4` continues to run and publish with agentic coding as its only scenario. The SPEED-Bench acceptance-length scripts for `dsv4` are intentionally kept. Speedbench is driven by `speedbench-al.yml`, not the master configs. The srt-slurm and llm-d recipe YAMLs referenced by the archived multi-node keys stay in place as inert reference data, as #2493 and #2527 left theirs.

**Deprecation parity audit (2026-09-21):** Active master configs and benchmark-script locations match the enacted retirements above and in the support matrix below. GLM-5.1 B200 TileRT remains the documented exception to the earlier GLM-5/5.1 and 1k1k retirements. Conditional A/B baseline retirement remains pending; non-speculative Pareto contributors remain supported. Deprecated configs are consolidated in [`configs/deprecated/amd-master.yaml`](configs/deprecated/amd-master.yaml) and [`configs/deprecated/nvidia-master.yaml`](configs/deprecated/nvidia-master.yaml).

## Scenarios

Expand Down
6 changes: 4 additions & 2 deletions MODELS_zh.md
Original file line number Diff line number Diff line change
Expand Up @@ -42,7 +42,7 @@ InferenceX-e2e 运行在数量固定且有限的 GPU 资源池上,并由一支

**2026 年 8 月 6 日(星期四)**为 **Kimi-K2.5/2.6/2.7-Code**(`kimik2.5`)**单轮 8k1k** 场景的最后运行日,此后该场景对这些模型弃用。原因:Kimi-K3 已于 2026 年 7 月 27 日发布,GPU 集群时间将转向更新的前沿模型。叠加上文的智能体编码弃用,`kimik2.5` 将不再有任何启用场景。该模型将于 **2026 年 8 月 6 日后完全退役**。

**已于 2026-08-07 执行**([#2527](https://github.com/SemiAnalysisAI/InferenceX/pull/2527)):从启用的主配置中移除 17 个 `kimik2.5` 配置项,归档至 [`configs/deprecated/`](configs/deprecated/),分别为 `nvidia-kimik2.5-8k1k-master.yaml`(10 个)与 `amd-kimik2.5-8k1k-master.yaml`(7 个)。对应的 12 个基准测试脚本移入同级 `deprecated/` 目录。此后 `kimik2.5` 在所有主配置中**均无启用配置**,正式完全退役。同一 PR 还归档了 `kimik2.5-int4-h100-vllm`。#2493 将其脚本移入 `benchmarks/single_node/agentic/deprecated/` 时,该智能体编码配置项被遗留在 `nvidia-master.yaml` 中,现已与同类项一并归入 `nvidia-kimik2.5-agentic-master.yaml`。SPEED-Bench 接受长度脚本 `benchmarks/single_node/speedbench/kimik2.5_fp4_b300_vllm.sh` 予以保留。Speedbench 由 `speedbench-al.yml` 驱动,不经过主配置,与 #2493 处理 MiniMax-M3 的方式一致。
**已于 2026-08-07 执行**([#2527](https://github.com/SemiAnalysisAI/InferenceX/pull/2527)):从启用的主配置中移除 17 个 `kimik2.5` 配置项,归档至 [`configs/deprecated/`](configs/deprecated/),现分别合并至 `configs/deprecated/nvidia-master.yaml`(10 个)与 `configs/deprecated/amd-master.yaml`(7 个)。对应的 12 个基准测试脚本移入同级 `deprecated/` 目录。此后 `kimik2.5` 在所有主配置中**均无启用配置**,正式完全退役。同一 PR 还归档了 `kimik2.5-int4-h100-vllm`。#2493 将其脚本移入 `benchmarks/single_node/agentic/deprecated/` 时,该智能体编码配置项被遗留在 `nvidia-master.yaml` 中,现已与同类项一并归入 `configs/deprecated/nvidia-master.yaml`。SPEED-Bench 接受长度脚本 `benchmarks/single_node/speedbench/kimik2.5_fp4_b300_vllm.sh` 予以保留。Speedbench 由 `speedbench-al.yml` 驱动,不经过主配置,与 #2493 处理 MiniMax-M3 的方式一致。

### 2026 年 9 月 8 日(星期二)

Expand All @@ -54,7 +54,9 @@ InferenceX-e2e 运行在数量固定且有限的 GPU 资源池上,并由一支

原因:`dsv4` 是本仓库中单轮场景占用最大的模型。当前有 45 个启用的配置项使用 8k1k 场景(`configs/nvidia-master.yaml` 32 个,`configs/amd-master.yaml` 13 个),覆盖 H200、B200、B300、GB200、GB300、MI300X、MI325X 与 MI355X,涉及 vLLM、SGLang、TensorRT-LLM、ATOM、Dynamo 与 llm-d,在每一轮完整 sweep 中占比可观。AgentX 轨迹回放才是 AI 实验室与 ML 社区真正关注的场景,而 DeepSeek-V4-Pro 的 19 个智能体编码配置项正是 `dsv4` 中支撑已发布北极星(North Star)帕累托前沿的部分。下线固定序列长度分支可为 AgentX 以及 Qwen3.8-Flash-Next 等新前沿模型腾出集群机时,同时不减少该模型对外发布的内容。对于仍列有该场景的其他模型,单轮 8k1k 保持启用。

**已于 2026-09-09 执行**([#2921](https://github.com/SemiAnalysisAI/InferenceX/pull/2921)):46 个 `dsv4` 8k1k 配置项已从启用的主配置中移除并归档至 [`configs/deprecated/`](configs/deprecated/),即 `nvidia-dsv4-8k1k-master.yaml`(33 个)与 `amd-dsv4-8k1k-master.yaml`(13 个);对应的 28 个基准测试脚本移入同级 `deprecated/` 目录(`benchmarks/single_node/fixed_seq_len/` 下 25 个,`benchmarks/multi_node/` 下 3 个),与 [#2493](https://github.com/SemiAnalysisAI/InferenceX/pull/2493) 和 [#2527](https://github.com/SemiAnalysisAI/InferenceX/pull/2527) 的做法一致。数量为 46 而非上文所述的 45,是因为 `dsv4-fp4-b200-dynamo-sglang` 在本公告发布后才合入。19 个智能体编码配置项未做改动:`dsv4` 以智能体编码为唯一场景继续运行与发布。`dsv4` 的 SPEED-Bench 接受长度脚本予以保留。Speedbench 由 `speedbench-al.yml` 驱动,不经过主配置。已归档多节点配置项所引用的 srt-slurm 与 llm-d 配方 YAML 作为惰性参考数据原地保留,与 #2493 和 #2527 的处理一致。
**已于 2026-09-09 执行**([#2921](https://github.com/SemiAnalysisAI/InferenceX/pull/2921)):46 个 `dsv4` 8k1k 配置项已从启用的主配置中移除并归档至 [`configs/deprecated/`](configs/deprecated/),现合并至 `configs/deprecated/nvidia-master.yaml`(33 个)与 `configs/deprecated/amd-master.yaml`(13 个);对应的 28 个基准测试脚本移入同级 `deprecated/` 目录(`benchmarks/single_node/fixed_seq_len/` 下 25 个,`benchmarks/multi_node/` 下 3 个),与 [#2493](https://github.com/SemiAnalysisAI/InferenceX/pull/2493) 和 [#2527](https://github.com/SemiAnalysisAI/InferenceX/pull/2527) 的做法一致。数量为 46 而非上文所述的 45,是因为 `dsv4-fp4-b200-dynamo-sglang` 在本公告发布后才合入。19 个智能体编码配置项未做改动:`dsv4` 以智能体编码为唯一场景继续运行与发布。`dsv4` 的 SPEED-Bench 接受长度脚本予以保留。Speedbench 由 `speedbench-al.yml` 驱动,不经过主配置。已归档多节点配置项所引用的 srt-slurm 与 llm-d 配方 YAML 作为惰性参考数据原地保留,与 #2493 和 #2527 的处理一致。

**弃用状态一致性核查(2026-09-21):** 启用的主配置及基准测试脚本位置与上述已执行的退役事项和下方支持矩阵一致。GLM-5.1 B200 TileRT 仍是文档明确保留的例外,不受此前 GLM-5/5.1 和 1k1k 退役范围限制。有条件的 A/B 基线退役仍待执行;对 Pareto 前沿有贡献的非投机解码配置继续受支持。弃用配置现统一归档至 [`configs/deprecated/amd-master.yaml`](configs/deprecated/amd-master.yaml) 和 [`configs/deprecated/nvidia-master.yaml`](configs/deprecated/nvidia-master.yaml)。

## 场景

Expand Down
Loading
Loading