Skip to content

docs: add GLM-5.2 model page and update supported-models tables - #2216

Merged
Zhichenzzz merged 8 commits into
mainfrom
shi/add-glm52-docs
Aug 10, 2026
Merged

docs: add GLM-5.2 model page and update supported-models tables#2216
Zhichenzzz merged 8 commits into
mainfrom
shi/add-glm52-docs

Conversation

@Shi-Dong

@Shi-Dong Shi-Dong commented Aug 5, 2026

Copy link
Copy Markdown
Contributor

Stacked on #2220 (base branch yueming/glm52-tbench2-example); merge that first.

Summary

  • Add a dedicated docs page for GLM-5.2 (docs/models/glm/glm5-2.md), covering the scripts/run_glm5_2_744b_a40b.py recipe: supported variants (zai-org/GLM-5.2 and the 5-layer pruned smoke-test model), checkpoint validation + HF → Megatron conversion, the three parallelism branches (1-node 5-layer, ≥16-node GB300 4-GPU/node, ≥16-node 8-GPU/node), GRPO + TIS, the FP8-KV-cache SGLang rollout config (fp8_e4m3, flashmla_kv decode / flashmla_sparse prefill), and the launcher flags (--fp8-rollout, --enable-mtp, --enable-pd, --sglang-config, --use-deepep with the GB300 caveat).
  • Reference the terminal-bench-2 × Daytona agentic RL example from Add the GLM-5.2 744B x terminal-bench-2 Daytona example #2220 (examples/experimental/openenv/glm52_tbench2/) in a new §4.2 of the page, with a cross-link to the Fully Async Rollout docs.
  • Register the new page in the docs/docs.json navigation.
  • Add GLM-5.2 to the supported-models tables in docs/index.md and docs/models/index.md, and to the GLM family index (docs/models/glm/index.md: description, intro, variants table, "Which variant do I pick?").
  • Cross-link the new page from the GLM-5 page (and fix a dangling sentence there).
  • Root-anchor the glm/ pattern in .gitignore (→ /glm/): unanchored, it matches docs/models/glm/ too and silently blocks git add of any new page in that directory. The entry sits among local-scratch patterns (wandb/, outputs/, local/), so it is clearly meant for a repo-root scratch dir only.

All facts are taken from scripts/run_glm5_2_744b_a40b.py, scripts/models/glm5.2-744B-A40B.sh, and the #2220 example README; the page follows the same six-section structure as the existing GLM-5 page.

Shi-Dong and others added 2 commits August 5, 2026 13:24
Fully-async agentic RL on 16 GB300 nodes (4 GPUs each): 8 training nodes
(TP2/CP4/PP4/EP8, optimizer state streamed to node-local disk) and 8
inference nodes (one 4-GPU dp-attention fp8 sglang engine per node). Each
episode is a multi-turn terminal agent solving one terminal-bench-2 task in
its own Daytona sandbox built from that task's official image, scored by
the task's canonical test.sh.

The recipe's defaults are the reference configuration, so

    python3 run_glm5_2_744b_a40b_daytona.py train --num-nodes 16

reproduces it; launch_16node_slurm.sh is a ~60-line site adapter (container
+ Ray bring-up) that forwards its CLI args to the recipe. Reference run:
100 rollout steps in 21h, truncation 0.0-0.3, prefix-cache hit rate ~0.96,
engine fleet saturated at --async-max-concurrent-samples 128.

The recipe also carries the two debugging paths that shaped it:
--debug-replay-data replays recorded rollout dumps through the training
side alone (parallelism/OOM changes validated in minutes, no sandboxes),
and --load-from + --start-rollout-id 0 scores an existing checkpoint via
the pre-train eval.
Comment thread docs/models/glm/glm5-2.md Outdated
Comment thread docs/models/glm/glm5-2.md Outdated
@Shi-Dong
Shi-Dong changed the base branch from main to yueming/glm52-tbench2-example August 6, 2026 22:17
Base automatically changed from yueming/glm52-tbench2-example to main August 10, 2026 06:51
Conflicts, both resolved in favour of main:

- docs/index.md: #2271 refreshed the homepage table (trimmed to recent
  releases, added Kimi-K3 / Nemotron-3-Ultra / Gemma-4 / JoyAI /
  Inkling-Small) and already carries the GLM-5.2 link this branch was
  adding, so main's table is taken wholesale.
- examples/experimental/openenv/glm52_tbench2/README.md: the example
  landed on main separately as #2220 with a reworded "Container image"
  prerequisite; main's copy wins and this branch no longer touches the
  example.

Net diff against main is now just the GLM-5.2 docs: the new
docs/models/glm/glm5-2.md page, its nav entry, the GLM and models
index rows, the cross-reference from glm5.md, and the /glm/ .gitignore
anchor.
The rule matched a directory named glm at any depth, so docs/models/glm/
was ignored and new pages under it — such as the GLM-5.2 page this branch
adds — needed git add -f. Nothing in the tree needs a glm/ ignore, so the
rule goes away rather than being anchored to the repo root.
@Zhichenzzz
Zhichenzzz merged commit 77ca8ab into main Aug 10, 2026
13 of 20 checks passed
@Zhichenzzz
Zhichenzzz deleted the shi/add-glm52-docs branch August 10, 2026 21:20
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants