Qwen3.8-Flash-Next#
A hybrid architecture interleaving Gated-DeltaNet (GDN) linear-attention
layers with Qwen Sparse Attention (QSA) full-attention layers
(architecture Qwen4ExpForConditionalGeneration, one full-attention layer
every four). QSA picks its history from compressed keys, so while a compression
group is still open its raw keys sit in a small per-request scratch ring that
LMCache skips; see Hybrid Attention Models for the general handling of
Mamba / linear-attention models.
Note
Despite the name, this model does not share the
Qwen3_5ForConditionalGeneration architecture used by the
Qwen3.5 / Qwen3.6 / Qwen3.8 series; it has its own
architecture and its own unified block size.
Validated models#
Qwen/Qwen3.8-Flash-Next (8 GPUs)
Engine documentation:
Qwen3.8-Flash-Next in vLLM supported models
(architecture Qwen4ExpForConditionalGeneration).
Status: Validated with LMCache.
Like the other GDN hybrids, this model needs the same settings: the
align Mamba cache mode, prefix caching, and
--separate-object-groups on the LMCache server. The chunk size is
negotiated from vLLM’s unified block size, which vLLM logs at startup
as Setting attention block size to N tokens:
Model |
Unified block size |
GPUs |
|---|---|---|
|
400 |
8 |
Start the LMCache MP server. The connector negotiates the configured
minimum up to N; see Chunk-Size Negotiation:
lmcache server \
--chunk-size 400 \
--separate-object-groups \
--l1-size-gb 100 \
--eviction-policy LRU
Start vLLM with the LMCache MP connector (8 GPUs):
vllm serve Qwen/Qwen3.8-Flash-Next \
--tensor-parallel-size 8 \
--enable-prefix-caching \
--mamba-cache-mode align \
--kv-transfer-config \
'{"kv_connector":"LMCacheMPConnector", "kv_role":"kv_both"}'
--mamba-cache-mode align is required (GDN does not support the all
mode). --separate-object-groups (server) is required for hybrid models
so the linear-attention layers get their own cache objects.
Adjust --tensor-parallel-size to match your hardware. For the generic
LMCache + vLLM wiring (ports, remote hosts), see
Quickstart.
Status: Not validated with LMCache.
Status: Not validated with LMCache.
CacheBlend support#
Not supported: the hybrid groups’ cached pages are byte-opaque (see Caveats).
Compression support#
Method |
Status |
Notes |
|---|---|---|
Not supported |
Hybrid groups’ cached pages are byte-opaque. |
MTP (speculative decoding) support#
The checkpoint ships multi-token-prediction layers (mtp,
mtp_num_hidden_layers). Status: Not yet validated with LMCache.
Caveats#
QSA scratch state is not cached. The per-request QSA compressor ring (
CircularBufferSpec) is marked non-prefix-cacheable by vLLM and is skipped by LMCache end to end, so it is recomputed rather than restored. It shows up as a0entry in the connector’s loggedgroup_tokens_per_block, which is expected.Cached pages for the linear-attention and full-attention groups are byte-opaque views, so content-aware processing does not apply, and cache entries must not be shared across engines with different attention backends or kernel block sizes.
vLLM’s Mamba prefix caching in
alignmode is experimental.Generation is not guaranteed bit-exact between a cached and a fresh run, since GDN backends do not support vLLM’s batch-invariant mode. (The validation run for this recipe did reproduce the cold output exactly, but treat score-level equivalence as the contract.)
Qwen/Qwen3.8-Flash-Nextis a vision-language checkpoint; the LMCache validation covers text generation. Caching of image/video KV is not validated.