Skip to content

[KV offload] Disable parallel-agnostic fs-tier cache on V2 model runner - #2

Closed
Etelis wants to merge 6 commits into
claude/upstream-sync-idbaw3from
claude/kv-offload-v2-guard
Closed

Etelis wants to merge 6 commits into
claude/upstream-sync-idbaw3from
claude/kv-offload-v2-guard

Conversation

@Etelis

@Etelis Etelis commented Jun 18, 2026

Copy link
Copy Markdown
Owner

Purpose

Disable the parallel-agnostic fs-tier KV cache (vllm-project#44733) when the V2 model runner
is active. The parallelism-invariant assumption it relies on does not hold under
V2.

The parallel-agnostic fs-tier cache (vllm-project#44733) collapses tp/pp/pcp/dcp and
rank out of the cache namespace for a single full-attention group, on the
assumption that the offloaded KV blocks are parallelism-invariant. That
invariant is not known to hold under the V2 model runner, whose KV layout
may differ, so sharing a cache directory across layouts there could alias
distinct blocks.

Gate the opt-in on the canonical vllm_config.use_v2_model_runner property
(not a raw env-var read, so config-driven V2 defaults such as diffusion
models are handled correctly). The check sits alongside the existing MLA
and multi-group exclusions in FileMapper, keeping the call sites unchanged.

Adds a regression test asserting tp/rank are not collapsed when the V2
model runner is active.

Co-authored-by: Claude
Signed-off-by: Itay Etelis <etelis2019@gmail.com>
Co-authored-by: Claude
Signed-off-by: Itay Etelis <etelis2019@gmail.com>
@Etelis
Etelis changed the base branch from main to claude/upstream-sync-idbaw3 June 18, 2026 09:31
@Etelis Etelis added the ready label Jun 18, 2026 — with Claude
Signed-off-by: Itay Etelis <etelis2019@gmail.com>
@Etelis Etelis closed this Jun 18, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants