Skip to content

[feat](vllm): upgrade vllm to 0.26.1 - #1839

Merged
valarLip merged 15 commits into
mainfrom
vllm0.26.1
Aug 16, 2026
Merged

valarLip merged 15 commits into
mainfrom
vllm0.26.1

Conversation

@PerryZhang01

@PerryZhang01 PerryZhang01 commented Aug 10, 2026 •

Copy link
Copy Markdown
Contributor

Motivation

Upgrade the ATOM out-of-tree vLLM integration from vLLM 0.25.1 (752a3a504) to vLLM 0.26.1 (adbf08d97).

Technical Details

  • atom/plugin/vllm/models/kimi_k3.py: vLLM 0.26.1 supports dedicated KimiK3KDAMetadata; Kimi-K3 now uses KDA metadata instead of generic GDN metadata.

  • atom/plugin/vllm/kda_backend.py: Adds an ATOM KDA backend to handle KDA state shape, dtype, state copying, and padded FULL-graph decode requests.

  • atom/plugin/vllm/gdn_backend.py: Removes the legacy ATOM metadata compaction and uses vLLM’s native GDN padding handling.

  • atom/plugin/vllm/attention/backend.py: vLLM 0.26 separates logical KV block size from physical kernel block size; target AITER MHA uses physical block size 16, while draft Triton attention remains flexible.

  • atom/plugin/vllm/attention/layer_mha.py: Selects different block-size capabilities for target and draft layers, and routes non-16 pages through the Triton path.

  • atom/plugin/vllm/attention/layer_sparse_mla.py: Implements the new bind_kv_cache() contract for sparse-MLA indexer caches.

  • atom/plugin/vllm/attention/metadata.py: Uses the new KV-cache shard-count API and host-resident sequence-length metadata required by vLLM 0.26.

  • atom/plugin/vllm/deepseek_v4_prefix_patch.py: Preserves safe block reuse for DeepSeek-V4 and Mamba/GDN stateful caches after vLLM changed free-block ordering.

  • atom/plugin/vllm/deepseek_v4_bridge.py: Prevents DeepSeek-V4 proxy state from binding to temporary profiling KV caches.

  • atom/plugin/vllm/spec_decode_patch.py: Updates EAGLE3 type checks and speculative-decoding integration for the new proposer contracts.

  • atom/plugin/vllm/cudagraph_memory_profiler_patch.py: Skips unsafe temporary CUDA Graph memory capture on ROCm to prevent stale AITER graph-pool state.

Test Result

Model flexible-extract Threshold 状态
DeepSeek-V4-Flash TP4 0.8279 0.93 ❌
GLM-5.2-MXFP4-MTP TP4 0.9265 0.91 ✅
MiniMax-M3-MXFP4 TP4 0.9447 0.93 ✅
Kimi-K2.7-MXFP4 TP4 0.9500 0.92 ✅
Qwen3.5-397B-A17B-MXFP4 TP4 0.8302 0.83 ✅

DeepSeek-V4-Flash was fixed in other PR: #1809

@github-actions

Copy link
Copy Markdown
Contributor

🏷️ CI Guide

Runs automatically on every eligible PR before approval:

  • ✅ Pre Checkin: Black, Ruff, catalog schema validation, non-GPU unit tests

Heavy model tests:

  • ✅ Run after the PR is approved and Pre Checkin passes
  • ✅ Run immediately when an approval review is submitted
  • ✅ Can be requested before approval with labels
Label Tests
ci:full Run all heavy PR model tests: native ATOM, vLLM, and SGLang
ci:atom Run native ATOM model accuracy tests
ci:vllm Run ATOM vLLM OOT model accuracy tests
ci:sglang Run ATOM SGLang model accuracy tests

Heavy jobs are skipped when the PR is not approved and no matching ci:* label is present.
Add labels via the sidebar or gh pr edit 1839 --add-label <label>

zgplvyou and others added 13 commits August 15, 2026 22:01
Use vLLM's KDA contract with an ATOM decode adapter so active64 requests preserve recurrent state accuracy without changing generic GDN behavior.

Co-authored-by: Cursor <cursoragent@cursor.com>
Co-authored-by: Cursor <cursoragent@cursor.com>
Record the validated EvalScope max-effort protocol so local results use the same reasoning and repeat settings as the official benchmark guidance.

Co-authored-by: Cursor <cursoragent@cursor.com>
Honor vLLM's graph-memory profiling disable switch before temporary capture so AITER does not retain stale graph-pool state during FULL replay.

Co-authored-by: Cursor <cursoragent@cursor.com>
Move the ROCm FULL graph fix to the active vllm0.26.1 branch and remove the accidental documentation update from vllm_026.

Co-authored-by: Cursor <cursoragent@cursor.com>
Avoid temporary graph capture on ROCm so AITER does not retain stale graph-pool state during FULL replay, without changing accuracy catalogs or upgrade docs.

Co-authored-by: Cursor <cursoragent@cursor.com>
Remove the temporary concurrency-8 overrides now that the ROCm FULL graph root cause is fixed in the plugin.

Co-authored-by: Cursor <cursoragent@cursor.com>
Remove the temporary concurrency-8 override after validating MTP TP4 with FULL graphs at the default concurrency of 65.

Co-authored-by: Cursor <cursoragent@cursor.com>
Keep FULL-graph dummy rows from corrupting recurrent state while preserving Torch 2.13 and pip-based ROCm image compatibility.

Co-authored-by: Cursor <cursoragent@cursor.com>
Modernize annotations and mark immutable class mappings so the upgraded Ruff checks pass without changing runtime behavior.

Co-authored-by: Cursor <cursoragent@cursor.com>
Apply Black's canonical formatting so the vLLM 0.26.1 upgrade passes the shared Pre Checkin gate.

Co-authored-by: Cursor <cursoragent@cursor.com>
Port unified DeepSeek-V4 proxy geometry to vLLM 0.26, align packed state storage, and route Kimi-K3 CI around the incompatible AITER OPUS path.

Co-authored-by: Cursor <cursoragent@cursor.com>
zgplvyou and others added 2 commits August 15, 2026 22:17
Use Ruff's canonical max expressions and remove the unused test import so reviewdog no longer flags the PR diff.

Co-authored-by: Cursor <cursoragent@cursor.com>
Drop the transient vLLM 0.26.1 validation report and keep the Kimi-K3 recipe identical to main.

Co-authored-by: Cursor <cursoragent@cursor.com>
@valarLip
valarLip merged commit 8fac308 into main Aug 16, 2026
51 of 60 checks passed
@valarLip
valarLip deleted the vllm0.26.1 branch August 16, 2026 12:35
PerryZhang01 pushed a commit that referenced this pull request Sep 3, 2026
Every vllm-atom DeepSeek-V4 server has died at startup since #2042. All
four workers abort inside `determine_available_memory` -> `profile_run`:

    AttributeError: 'types.SimpleNamespace' object has no attribute
    'max_seqlen_q'
      atom/plugin/vllm/deepseek_v4_bridge.py:2164
      atom/utils/forward_context.py:296  running_tokens_from_bs

`force_dummy` builds `attn_metadata` as a bare namespace carrying only
`state` and `in_hipgraph` (#1839). That is deliberate: the real builder
allocates and copies tensors, which HIP forbids under stream capture.
The namespace has therefore never had a sequence length.

#2042 replaced `graph_bs=batch_size` at this call site with
`running_tokens_from_bs(...)`, which dereferences
`attn_metadata.max_seqlen_q` on its decode branch. `force_dummy` also
forces `is_prefill=False`, so the profile forward takes that branch
unconditionally -- it cannot not crash.

Pass the `None` the helper already documents as "count only", which
restores exactly the `batch_size` the replaced expression produced. The
fix goes at the call site, where `force_dummy` is known, rather than
loosening the helper: a real decode metadata that is missing
`max_seqlen_q` should still fail loudly instead of silently under-padding
the MoE all_gather.

Not a new-model or spec-decode issue -- it reproduces on plain
`DeepSeek-V4-Flash TP4`, the PR-CI accuracy job, and on the nightly's
`DeepSeek-V4-Pro TP8`, which shares this bridge.

Verified on 4x MI355X via the CI path itself
(`.github/scripts/atom_oot_test.sh accuracy ci`, matrix entry
"DeepSeek-V4-Flash TP4"): the job goes from dying at startup with no
score at all to gsm8k 20-shot flexible 0.9568 / strict 0.9568 against a
0.93 threshold, in 9 minutes.

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
gyohuangxin pushed a commit that referenced this pull request Sep 3, 2026
* Change atom-plugin CI runner to spur-runner-mi355x-8gpu

* Move plugin CI logs onto shared_nfs so Spur runners can write them.

Co-authored-by: Cursor <cursoragent@cursor.com>

* Write plugin CI logs under the GitHub runner workspace.

Co-authored-by: Cursor <cursoragent@cursor.com>

* Run vLLM and SGLang plugin CI directly on the GPU runner.

Co-authored-by: Cursor <cursoragent@cursor.com>

* fix(v4): keep the profile forward off the decode running_tokens branch

Every vllm-atom DeepSeek-V4 server has died at startup since #2042. All
four workers abort inside `determine_available_memory` -> `profile_run`:

    AttributeError: 'types.SimpleNamespace' object has no attribute
    'max_seqlen_q'
      atom/plugin/vllm/deepseek_v4_bridge.py:2164
      atom/utils/forward_context.py:296  running_tokens_from_bs

`force_dummy` builds `attn_metadata` as a bare namespace carrying only
`state` and `in_hipgraph` (#1839). That is deliberate: the real builder
allocates and copies tensors, which HIP forbids under stream capture.
The namespace has therefore never had a sequence length.

#2042 replaced `graph_bs=batch_size` at this call site with
`running_tokens_from_bs(...)`, which dereferences
`attn_metadata.max_seqlen_q` on its decode branch. `force_dummy` also
forces `is_prefill=False`, so the profile forward takes that branch
unconditionally -- it cannot not crash.

Pass the `None` the helper already documents as "count only", which
restores exactly the `batch_size` the replaced expression produced. The
fix goes at the call site, where `force_dummy` is known, rather than
loosening the helper: a real decode metadata that is missing
`max_seqlen_q` should still fail loudly instead of silently under-padding
the MoE all_gather.

Not a new-model or spec-decode issue -- it reproduces on plain
`DeepSeek-V4-Flash TP4`, the PR-CI accuracy job, and on the nightly's
`DeepSeek-V4-Pro TP8`, which shares this bridge.

Verified on 4x MI355X via the CI path itself
(`.github/scripts/atom_oot_test.sh accuracy ci`, matrix entry
"DeepSeek-V4-Flash TP4"): the job goes from dying at startup with no
score at all to gsm8k 20-shot flexible 0.9568 / strict 0.9568 against a
0.93 threshold, in 9 minutes.

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>

* fix(ci): give Kimi-K3 DCP8 enough budget to allocate a KV cache

`Accuracy (Kimi-K3 DSpark DCP8 TP8)` cannot start. The engine aborts
while sizing the KV cache:

    INFO gpu_worker.py:563] Available KV cache memory: -5.07 GiB
    ValueError: No available memory for the cache blocks.
                Try increasing `gpu_memory_utilization`

The job is red with no score at all, which reads like an accuracy or
spec-decode regression and is neither.

#2033 moved this entry to DCP8 and set `--gpu-memory-utilization` from
0.93 to 0.7. Kimi-K3 is ~187 GiB of weights per GPU at TP8; on a 288 GiB
MI355X a 0.7 budget is 201.6 GiB, which does not leave a KV cache behind
after weights and activations. The threshold to merely reach zero is
0.7 + 5.07/288 ~= 0.718, so 0.7 is not marginally low -- it is on the
wrong side of the window.

The window is narrow in both directions, which is why 0.7 looks like a
safe choice and is not: FULL cudagraph capture takes its scratch OUTSIDE
the vLLM budget, so a HIGHER utilization starves capture (0.85 dies with
`OutOfMemoryError` in `mla_decode_fwd`; 0.93 leaves so little headroom
that one rank stalls in allocation while the others leave the capture
context and its MoE all_reduce deadlocks). 0.75 is the value that
satisfies both ends.

Measured on 8x MI355X through the CI path itself
(`.github/scripts/atom_oot_test.sh accuracy ci`, this matrix entry), with
every GPU verified idle (<1 GiB) before each launch:

    gpu-mem   KV cache      FULL capture   outcome
    0.70      -5.07 GiB     never reached  engine abort (reproduced twice,
                                           bit-identical)
    0.75      +9.33 GiB     48/48 ok       serves; gsm8k 5-shot 0.9454,
                                           DSpark acceptance 0.514

The +14.40 GiB delta is exactly 0.05 x 287.98 GiB, confirming the budget
is the only variable in play.

Acceptance 0.514 matches the ~52% recorded for DCP8 + DSpark N=7, so the
draft head is healthy. Note the run still lands under the 0.95 accuracy
threshold; that is a separate question from being able to start at all,
and is being characterized separately -- this commit only restores a
server that can allocate a KV cache.

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>

* fix(vllm): restore the GDN FULL-cudagraph decode metadata compaction

vLLM pads a FULL-cudagraph decode batch out to a captured graph size and
leaves the padded request rows in the GDN metadata. ATOM's GDN decode
kernel is request-indexed, so it walks those rows and folds them into
ssm_state. #1985 deleted the pass that compacted them away, to fix
Qwen3.5-35B-A3B block-FP8 -- but it scoped only its MHA/MoE half to
35B-A3B and dropped the GDN pass for every GDN model. Kimi-K3 kept an
identical copy in its own KDA builder
(AtomKimiK3KDAMetadataBuilder._adapt_full_graph_decode_metadata);
Qwen3.5-397B was left with nothing.

That is what took Accuracy (Qwen3.5-397B-A17B-MXFP4 TP4) from the
0.85-0.86 it held on the nightly dashboard through 2026-08-24 down under
its 0.83 gate, on every branch that has run it since.

Put the pass back and give it the same 35B-A3B exemption the rest of
#1985 uses, so that fix is untouched. Measured on 4x gfx950 with the
runner's own image assembly (rocm/atom-dev:vllm-latest + the aiter
nightly wheel CI resolves + this branch), gsm8k 3-shot x1319 at the
harness's FULL_AND_PIECEWISE:

  as CI runs it today                     0.7817
  this change                             0.8544
  whole #1985 GDN revert (reference)      0.8431
  cudagraph_mode=PIECEWISE (reference)    0.8355

The 35B-A3B exemption is covered by unit tests but not by an end-to-end
35B block-FP8 run; that path keeps today's behavior either way.

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>

* fix(vllm): drop the model scope from the GDN metadata compaction

The previous commit kept the pass off for Qwen3.5-35B-A3B, mirroring how
#1985 scoped its MHA/MoE half. That guard was cargo-culted: a metadata
pass has no business knowing which model it is running under, and the
reason #1985 gave for removing the pass does not survive checking.

Why the pass is unconditionally needed. vLLM means to mark the padded
rows itself:

    non_spec_state_indices_tensor[num_decodes:].fill_(NULL_BLOCK_ID)

but num_decodes comes from split_decodes_and_prefills, whose fast path

    if max_query_len <= decode_threshold and ...:
        return num_reqs, 0, num_tokens, 0

fires for any pure-decode batch (max_query_len == 1) and returns
num_decodes = num_reqs, i.e. the *padded* request count under FULL-graph
replay. The fill therefore starts at num_decodes == batch_size and is a
no-op: the padded slots keep whatever block_table_tensor[:, 0] held, and
ATOM's request-indexed GDN decode kernel folds them into ssm_state. That
depends only on the decode batch being padded -- not on the model, its
quantization, or TP. It is the same reason Kimi-K3 carries the pass in
its own KDA builder.

Why #1985's reason does not hold. It removed the pass because it
"rewrote that metadata using num_actual_tokens (token-padded graph size)
and shrunk num_decodes". That was true of the original version
(2255001) and was fixed two versions earlier, in 441476e, which
switched to num_reqs with a comment saying exactly why.

Qwen3.5-397B-A17B-MXFP4 TP4, gsm8k 3-shot x1319, 4x gfx950, runner image
assembly, FULL_AND_PIECEWISE: 0.8423 (scoped variant measured 0.8544;
the two are within one stderr of each other, and both clear the 0.83
gate against 0.7817 before the fix).

The 35B-A3B block-FP8 path is now covered by the pass again. I could not
score it end to end -- this box has the checkpoint but no validated vLLM
plugin recipe for it, and my attempt floored at 0.05-0.07 under both
FULL and PIECEWISE, so it measured nothing.

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>

* fix(vllm): keep the MTP position-0 mask off the layer signature

Every vLLM-plugin MTP run has been dying in profile_run since the fused
FP8 prologue landed:

    TypeError: DeepSeekMultiTokenPredictorLayer.forward() takes from 5 to
    6 positional arguments but 7 were given

The plugin installed its position-0 input-embedding mask by rebinding
each draft layer's forward to a wrapper that re-called the original with
a hardcoded five-argument list. When the fused prologue gave the layer a
sixth argument (eh_input_quant), the wrapper kept advertising the old
arity -- and functools.wraps kept the original qualname, so the error
pointed at a model signature that was in fact correct.

The wrapper could not have worked on the fused path anyway: there the
embedding never materializes as a tensor the layer receives, so there is
nothing for a layer-level wrapper to mask.

Move the mask into the predictors, which own the embedding lookup on
both paths and cannot drift from their own layers. On the unfused path
it is the same torch.where as before. On the fused path the masked rows
are fed the sentinel id -1: the prologue kernel already emits a zero
embedding for any id outside [0, vocab_size), and RMSNorm(0) is 0, so
the result is bit-identical to zeroing inputs_embeds -- without
materializing the [num_tokens, hidden] tensor the fusion exists to
avoid.

The plugin now flips a flag instead of rewriting a signature, and raises
if an arch in _MTP_MASK_INPUT_ARCH has no predictor to flip it on,
rather than silently serving an unmasked draft.

The regression test lives in tests/ rather than tests/plugin/ because
run_unit_tests.sh skips the latter.

Fixes the GLM-5.2-MXFP4-MTP TP4 plugin accuracy job.

* ci: download plugin CI draft models like the target

Kimi-K3 DSpark failed because speculative-config pointed at a missing local draft path. Cache the draft the same way as the target and rewrite extra_args to the resolved directory.

Co-authored-by: Cursor <cursoragent@cursor.com>

* ci: SIGKILL leftover host/KFD VRAM holders after plugin docker cleanup

Plugin HIP smoke was failing on spur runners when VRAM stayed allocated by host PIDs after leftover containers were already gone.

Co-authored-by: Cursor <cursoragent@cursor.com>

---------

Co-authored-by: Cursor <cursoragent@cursor.com>
Co-authored-by: perzhang <perzhang@amd.com>
Co-authored-by: Claude Opus 5 (1M context) <noreply@anthropic.com>
Co-authored-by: PerryZhang01 <Perry.Zhang@amd.com>
Co-authored-by: Junyan Yang <junyyang@crs-m2m-cpu-spur-v2-009.us-east2-a.compute.internal>
Co-authored-by: Junyan Yang <junyyang@crs-m2m-cpu-spur-012.us-east2-a.compute.internal>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Projects

None yet

Development

Successfully merging this pull request may close these issues.

4 participants