Skip to content

GLM-5.3-Flash cookbook: HiCache for LL, fusion-flag drop, EAGLE, default-cell numbers, DCP4 overlay - #36544

Merged
JustinTong0323 merged 11 commits into
sgl-project:mainfrom
JustinTong0323:docs/glm53-hicache-ll-enable
Aug 27, 2026
Merged

JustinTong0323 merged 11 commits into
sgl-project:mainfrom
JustinTong0323:docs/glm53-hicache-ll-enable

Conversation

@JustinTong0323

@JustinTong0323 JustinTong0323 commented Aug 26, 2026

Copy link
Copy Markdown
Collaborator

Motivation

Follow-ups to #36519 driven by measured evidence on the final weights:

  1. HiCache for Low Latency: the startup crash (bare DSA draft pool) is fixed in the release image and in Fix HiCache startup with bare DSA MTP draft pools #36538 — re-enable the HiCache options for LL (validated: startup, L2 host pool packs target 11 + draft 1, GSM8K-20 95% with 100% stop rate).
  2. --disable-shared-experts-fusion: no longer required — the fusion-gate fix makes the no-flag command build the unfused path at EP>1 (validated: 3/3 probes + GSM8K-20 20/20 with 100% stop rate, no flag).
  3. EAGLE spelling: upstream folded NEXTN into EAGLE; generated commands now use the canonical spelling (identical behavior at topk=1).
  4. HT numbers from the exact default cells: re-measured with the published commands verbatim (no pinned chunk/cap flags) — BF16 1,161.22 / 2,660.24 / 4,828.33 and FP8 1,227.07 / 2,738.61 / 4,977.02 output tok/s at concurrency 16 / 64 / 256, all rows 100% successful. Automatic sizing admits 434 running requests on GB300, so the concurrency-256 row runs at defaults; the earlier not-reproducible caveat is dropped. FP8 is 2.9-5.7% above BF16 on the curve.

Tests

  • All numbers above measured on 4x GB300 with the final weights (c5b82b63e37b) on the release-image tree.
  • node docs/scripts/check_cookbook_configs.mjs — OK; mint validate — passed.

CI States

Latest PR Test (Base): ✅ Run #33099967517
Latest PR Test (Extra): ✅ Run #33100069159
Latest PR Test (AMD ROCm 7.2): ➖ No AMD PR run found for this commit.

The DSA draft-pool fix shipped in lmsysorg/sglang:glm-5.3-flash
(gf13cb6f6a7.fix1): LL with HiCache L1+L2 starts, packs target 11 +
draft 1 layers, and passes GSM8K-20 at 95% with a 100% stop rate. The
temporary disable is no longer needed on the release image.
@github-actions github-actions Bot added the documentation Improvements or additions to documentation label Aug 26, 2026
Each measured entry now names the release image build
(glm-5.3-flash gf13cb6f6a7.fix1, which carries the HiCache and
fusion-gate fixes) alongside the rc2 source cut it was measured at.
The release image carries the fusion-gate fix, so the disable flag is no
longer required for correctness (validated: the no-flag serve builds the
unfused path and matches the flagged serve). The internal fix1 stamp is
not meaningful to public readers; the rc2 source anchor stays.
@JustinTong0323 JustinTong0323 changed the title GLM-5.3-Flash cookbook: re-enable HiCache for Low Latency GLM-5.3-Flash cookbook: re-enable HiCache for Low Latency and drop the fusion flag Aug 26, 2026
All speed rows now come from the current image tree (d6ab04b, the
canonical support branch): HT numbers are 3-26% above the earlier rc2
rows across both pairings, LL within 1%. GSM8K 97.35%/97.50% unchanged.
The HiCache overhead figures remain rc2-cut measurements and say so.
Notes now name the release-image tree (d6ab04b), quote the refreshed
deltas (FP8 1.6% on LL, 2.8-5.9% on HT), drop the fusion-flag disclosure
(cells no longer carry it; the gate fix makes it unnecessary), and mark
the HiCache overhead figures as rc2-cut measurements.
Upstream folded NEXTN into EAGLE (the enum no longer carries NEXTN; the
spelling survives only as a reserved alias). Generated commands now use
the canonical EAGLE spelling; runtime behavior is identical at topk=1.
…surements

Re-measured with the published cell commands verbatim (no pinned chunk,
caps, or fusion flag): BF16 1,161.22 / 2,660.24 / 4,828.33 and FP8
1,227.07 / 2,738.61 / 4,977.02 output tok/s at concurrency 16 / 64 / 256.
Automatic sizing admits 434 running requests on GB300, so the 256 row
runs at defaults — the old not-reproducible caveat is dropped. FP8 is
2.9-5.7% above BF16 on the curve.
@JustinTong0323 JustinTong0323 changed the title GLM-5.3-Flash cookbook: re-enable HiCache for Low Latency and drop the fusion flag GLM-5.3-Flash cookbook: re-enable HiCache for LL, drop the fusion flag, EAGLE spelling, default-cell HT numbers Aug 27, 2026
Defaults are expected to work; no need to say so.
Review follow-ups: fp8-vs-bf16 delta now 2.9-5.7% everywhere (MDX and
notes agree), KV pool absolutes are the default-cell values (12.6M/7.0M),
the fp8 stop rate is the d6ab gate (100%), the HT accuracy sentence uses
the shared-gate phrasing, and the HiCache L1+L2 figures quote the
16k-geometry measurements (within 4-5% of the non-HiCache rows) instead
of the chunk-confounded comparison. LL notes disclose the NEXTN/flag
measurement spelling.
…ll-enable

# Conflicts:
#	docs/cookbook/autoregressive/GLM/GLM-5.3-Flash.mdx
#	docs/src/snippets/configs/zai-org/glm-5.3-flash.jsx
Validated on 4x GB300 (TP4/EP4, adaptive MTP 5/1/6, full decode graph,
final weights on the d6ab04b tree): 1,680.61 output tok/s with FP8 +
TRT-LLM (native LSE), 1,565.8 with BF16 + TileLang (LSE fix in the
release image). The option is disabled off GB300, the gb300 LL cell is
Verified for either pairing with DCP4, and the HT DCP4 arm stays
unverified (target-only DCP not measured).
@JustinTong0323 JustinTong0323 changed the title GLM-5.3-Flash cookbook: re-enable HiCache for LL, drop the fusion flag, EAGLE spelling, default-cell HT numbers GLM-5.3-Flash cookbook: HiCache for LL, fusion-flag drop, EAGLE, default-cell numbers, DCP4 overlay Aug 27, 2026
@JustinTong0323
JustinTong0323 merged commit d1f1443 into sgl-project:main Aug 27, 2026
122 of 128 checks passed
saturn-acc pushed a commit to saturn-acc/sglang that referenced this pull request Aug 31, 2026
nzr-niu pushed a commit to nzr-niu/sglang that referenced this pull request Sep 1, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

documentation Improvements or additions to documentation run-ci run-ci-extra

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants