recipe.toml 12 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221
  1. # r27 4x DCP4 cell — clone of the r18 4x-dcp4 recipe (2026-09-05, 161/176,
  2. # KV 4.84M @ 16 GiB) retargeted at the r27 engine (2026-09-07 night, all 4
  3. # nodes free after the pluto switch). Same model/flags/KV pin.
  4. # GLM-5.3-Flash NVFP4 — local-inference-lab quant (vLLM) — 2× DGX Spark, TP=2.
  5. #
  6. # local-inference-lab mixed quant: NVFP4 routed experts (layers 3–44,
  7. # group-16) + MXFP8 MTP experts (layer 45) + W4A4 input scales. Best agent
  8. # quant so far: tool-eval-bench 89/100 (vs 85 LibertAIDAI, 90 official FP8).
  9. # Model: https://huggingface.co/local-inference-lab/GLM-5.3-Flash-NVFP4
  10. # (~186 GB → 92.72 GiB weights/node; KV pinned at 10 GiB, see below)
  11. #
  12. # Image: glm53-flash-nvfp4-lab:local (docker-images/glm53-flash-nvfp4-lab/ —
  13. # day-0 arm64 image + NoPE-MLA mod + the four FujitsuPolycom lab-checkpoint
  14. # patches: model naming shim, modelopt MTP namespace fix, persistent_topk
  15. # CC-12.x guards). Their launch config is mirrored below.
  16. # PROVENANCE: https://github.com/FujitsuPolycom/glm53-flash-tp2-spark
  17. # (Apache-2.0; see patches/UPSTREAM.md) + forum 381350 #41.
  18. #
  19. # Deviations from their launch script (intentional):
  20. # * no --kda-prefill-backend flashkda (needs their base-image patch — skipped)
  21. # * --kv-cache-dtype fp8_ds_mla instead of `fp8` (same packed layout; this
  22. # spelling is what the NoPE-MLA mod booted with on the LibertAIDAI stack)
  23. # * --language-model-only + no mm-renderer patch/env (text-only)
  24. # * no bundled NCCL/LD_PRELOAD, no NCCL_* fabric block (our switched fabric
  25. # is configured via [nccl.ds4] + launcher GID auto-detect)
  26. # * no --moe-backend marlin: their proven stack uses the default backend for
  27. # THIS quant and reports clean evals. Sanity-check output for token loops
  28. # anyway (the silent FP4 MoE corruption gotcha) before trusting a new node.
  29. # * flashinfer autotune disabled via --kernel-config (their proven boot);
  30. # VLLM_ENGINE_READY_TIMEOUT_S stays high regardless.
  31. #
  32. # Boot success markers (engine log, in order):
  33. # "Model loading took 92.72 GiB" → "[quantprobe] ... algo=MXFP8" (MTP fix
  34. # active; algo=None means broken) → "GPU KV cache size: 1,164,369 tokens" →
  35. # "Application startup complete". ~700 s sequential weight load.
  36. #
  37. # Test request: chat completions need "chat_template_kwargs":{"reasoning_effort"
  38. # :"low"} — omitted/other values select MAX reasoning effort (empty content on
  39. # short max_tokens).
  40. #
  41. # Optional: instanttensor loader (~30 s weight load vs ~700 s):
  42. # FROM glm53-flash-nvfp4-lab:local + pip install --no-deps --no-build-isolation
  43. # instanttensor==0.1.9, then add --load-format instanttensor (--no-deps is
  44. # required: resolution would downgrade the image's NCCL).
  45. #
  46. # PREREQUISITES: weights cached on both nodes:
  47. # [A/B CELL 2026-09-03] ship recipe verbatim, checkpoint swapped to the lab
  48. # non-Spark NVFP4 (isolates checkpoint from image lineage vs the lab-image cell).
  49. # [BISECT A2 2026-09-03] EXACT 90/100 recipe (236ce5a) + instanttensor + JIT
  50. # mounts, on the CURRENT eugr-patched image. Isolates image lineage from the
  51. # execution-env/flag cluster (AOT/V2/b12x/card-env). Comparator: 124/138.
  52. # GLM-5.3-Flash NVFP4-Spark — local-inference-lab quant with the speculative
  53. # layers embedded — 2× DGX Spark, TP=2.
  54. #
  55. # local-inference-lab/GLM-5.3-Flash-NVFP4-Spark (rev 06972cdee7280cec849aedf05a02062b3e870246):
  56. # NVFP4 routed experts (layers 3+, group-16) + NVFP4 MTP expert layer in the
  57. # separate model-mtp-0000x.safetensors shards (mtp_tokens: 5 per their
  58. # lil.yaml), amax/nonexpert/inputscales side shards, Glm5NextForConditionalGeneration.
  59. # THE "DSpark speculative embedded" checkpoint — no separate DFlash2 download
  60. # needed; lil.yaml: default_speculator mtp, dflash2_tokens 7 (r12 doc fr: their
  61. # standalone-Q: MTP:3 254 tok/s CC1, 333 Sieve, 94 steps/s).
  62. #
  63. # Image: glm53-flash-nvfp4-lab:local (same proven day-0 arm64 stack + NoPE-MLA
  64. # mod + modelopt MTP namespace patch used by the 92/100 lab lane). The MTP
  65. # layer here is NVFP4 (not MXFP8) — the quantprobe marker may print
  66. # algo=NVFP4/- different; algo=None = patch missed (fall back to 4p67 image).
  67. #
  68. # Deviations from lab (unchanged mechanics): same fabric/env/GMU/KV pinning.
  69. # lil.yaml launch mirrors: block 256, disable_flashinfer_autotune, mm data
  70. # mode — our text-only flags identical to glm53-flash-nvfp4-lab.
  71. #
  72. # Boot markers: "Model loading took ~XX GiB" → "[quantprobe] ..." →
  73. # "GPU KV cache size" → "Application startup complete".
  74. #
  75. # PREREQUISITES: weights on the NAS hub (175 GiB): hf download local-inference-lab/GLM-5.3-Flash-NVFP4-Spark
  76. engine = "vllm"
  77. name = "GLM-5.3-Flash NVFP4 (r27 img, lab ckpt, 4x DCP4)"
  78. docker_image = "glm53-jovian-r27:local" # r27 clone-at-pin build (docker-images/glm53-jovian-r27)
  79. docker_image_dir = "glm53-jovian-r27"
  80. # Required: the clean r12 image follows the solar contract (ENTRYPOINT []
  81. # + CMD bash), so the recipe carries the entrypoint (the old day-0-based
  82. # r12 image had ["vllm","serve"] baked in, which is why this was absent
  83. # until the clean rebuild).
  84. entrypoint = ["vllm", "serve"]
  85. model = "local-inference-lab/GLM-5.3-Flash-NVFP4"
  86. required_nodes = 4
  87. tensor_parallel_size = 4
  88. pipeline_parallel_size = 1
  89. distributed_backend = "mp"
  90. shm_size = "32gb"
  91. args = [
  92. # Stable served name — quant-agnostic (shared across glm53 quants)
  93. "--served-model-name", "glm53",
  94. "--trust-remote-code",
  95. "--distributed-executor-backend", "mp",
  96. # GMU is ONLY a startup guardrail here (KV pool is pinned below): 0.90
  97. # demands 109.46 GiB free on GB10's 121.63 GiB, but driver reserve +
  98. # page cache routinely leave ~108.5 -> flaky
  99. # "Free memory ... less than desired" boot deaths (this was the class
  100. # of the old "54-second death"), and post-crash reruns see ~106.6 GiB.
  101. # 0.82 = 99.7 GiB, below any realistic dip; does NOT change what gets
  102. # allocated (weights ~93 + pinned KV 10 + activations).
  103. "--gpu-memory-utilization", "0.90",
  104. # Pinned 10 GiB KV (≈1.16M tokens) — GMU sizing has no headroom at
  105. # 92.72 GiB weights/node; pinning also keeps warmup off the swap path
  106. "--kv-cache-memory-bytes", "17179869184", # 16 GiB: 4x NVFP4 has the headroom (47.1 GiB weights/node vs 108 usable); 2x stays 10
  107. "--decode-context-parallel-size", "4",
  108. "--cp-kv-cache-interleave-size", "4",
  109. # No --kv-cache-dtype: let the r12 fork pick its default (the explicit
  110. # fp8 / fp8_ds_mla both failed auto-selection on this build).
  111. # The GLM5Next model wires the B12X sparse-MLA backend (sm_120/sm_121)
  112. # when the global backend is B12X (glm5next/nvidia/attention.py:
  113. # _select_sparse_backend); the sm12x auto-priority list never offers it
  114. # (FLASHINFER_MLA_SPARSE_SM120 only supports head 576, not GLM's 512).
  115. "--attention-backend", "B12X",
  116. # pure I/O loader (kept across every config; 171 GB in ~5.5 min vs ~16 NFS)
  117. "--load-format", "instanttensor",
  118. # [R17 FULL-CLUSTER TEST] lil manifest backends (quality gate: hardmode
  119. # must stay ≥88; r12-era this cluster dropped it to 74 — r17 may carry
  120. # the fix through — one boot decides).
  121. "--block-size", "256",
  122. # FINAL BISECT (2026-09-03, hardmode 176pt, r17 img):
  123. # knobs-only 87: d0 c1 24.1, d8192 23.8
  124. # +moe b12x 88: d0 c1 23.5, d8192 26.6 <- SHIP (2 pts d8192)
  125. # +linear b12x 44: W4A4 linear kernel destroys numerics (param-precision 0%)
  126. # +align 88: but d0 c1 18.6 (-5) — perf-negative, dropped
  127. # (all three together = 44-74; the lab needs its private packed package)
  128. "--max-model-len", "524288",
  129. "--max-num-seqs", "16",
  130. "--max-num-batched-tokens", "4096",
  131. "--enable-chunked-prefill",
  132. "--async-scheduling",
  133. "--enable-prefix-caching",
  134. # NO --disable-custom-all-reduce here: in the r27 fork the RoCEnante
  135. # adapter is gated on the custom-all-reduce enable flag
  136. # (use_roce_allreduce = use_custom_allreduce && VLLM_ENABLE_ROCE_ALLREDUCE).
  137. # On 2x/4x 1-GPU-node clusters vLLM's own CUDA-IPC custom AR is functionally
  138. # inert (no cross-node P2P), so dropping the flag only opens the b12x path;
  139. # the b12x-PCIe branch stays off (VLLM_ENABLE_PCIE_ALLREDUCE defaults False).
  140. # Their proven boot: no flashinfer autotune, no CuTe-DSL warmup
  141. "--kernel-config", """
  142. '{"enable_cutedsl_warmup":false,"enable_flashinfer_autotune":false}'""",
  143. # Built-in MTP draft, 3 tokens (the r12-qualified "mtp:3" mode — their
  144. # x86 numbers: 254 tok/s CC1, 2.37 accept; the checkpoint embeds up to
  145. # 5 via the model-mtp-0000x shards but 3 is the verified depth). This is
  146. # the checkpoint's own MTP head (Glm5NextMTPModel), NOT dspark — dspark
  147. # is the DeepSeek-V4 family's mechanism; GLM's other r12 mode is
  148. # dflash2:7 with a separate trained draft checkpoint.
  149. # The draft model's vllm_config takes its attention backend from the
  150. # SPECULATIVE config, not the global flag (eagle/utils.py:
  151. # _make_eagle_draft_vllm_config) — B12X here mirrors the main model's.
  152. "--speculative-config", """
  153. '{"method":"mtp","num_speculative_tokens":3,"attention_backend":"B12X"}'""",
  154. "--language-model-only",
  155. # MTP + CUDA graphs degrades OUTPUT QUALITY on the glm53 day-0 dev build
  156. # (forum #381350/#44, CONFIRMED by A/B bench 2026-08-28: same seed/flags,
  157. # graphs on = 89/100, eager = 92/100; decode unchanged 28.4 t/s @ c1,
  158. # c2 -7%, TTFT +1.6s). The b12x glm52 stack does NOT need this (its
  159. # graphs+MTP combo benches clean at 100/100) — bug is build-specific.
  160. # graphs moved BEFORE tool-call-parser; enforce-eager removed for the
  161. # r17-graphs test (bisect A2 was 88/100 eager; graphs+MTP fix is public
  162. # in r17 refs? verify by bench).
  163. "--tool-call-parser", "glm47",
  164. "--enable-auto-tool-choice",
  165. "--reasoning-parser", "glm45",
  166. ]
  167. [env]
  168. HF_HUB_OFFLINE = "1"
  169. # RoCEnante (b12x one-shot RoCE all-reduce/all-gather) — default on for r27
  170. # lanes since the 2026-09-08 A/B (4x DCP4: decode +31..+90%, quality 160 vs
  171. # 155, prefill within noise; specs/tech-architecture/glm53-recipe-state.md,
  172. # history/night-shifts/2026-09-07.md). Needs the CX-7 RoCE fabric (all of
  173. # ours); single-node serves skip it silently. Caps default 2MB AR / 16MB AG.
  174. VLLM_ENABLE_ROCE_ALLREDUCE = "1"
  175. # FlashInfer JIT (mxfp8_gemm_cutlass_sm120, ~12 kernels) compiles at first
  176. # boot with 12 parallel nvcc jobs -> OOM-killed (code 137) on GB10's
  177. # 121 GB unified while the 93 GB weights + 10 GB KV pin are resident.
  178. # MAX_JOBS caps ninja parallelism so the JIT fits in the remaining ~20 GB.
  179. MAX_JOBS = "2"
  180. # NoPE-MLA rope-pad runtime gate (mod baked into the image)
  181. VLLM_MLA_NOPE_PAD_ROPE = "1"
  182. VLLM_ENGINE_READY_TIMEOUT_S = "3600"
  183. # Upstream launch-script env (memory + compile knobs)
  184. PYTORCH_CUDA_ALLOC_CONF = "expandable_segments:True"
  185. VLLM_USE_AOT_COMPILE = "0"
  186. VLLM_USE_STANDALONE_COMPILE = "1"
  187. VLLM_USE_FLASHINFER_SAMPLER = "1"
  188. VLLM_USE_BREAKABLE_CUDAGRAPH = "0"
  189. TORCH_USE_RTLD_GLOBAL = "1"
  190. VLLM_NO_USAGE_STATS = "1"
  191. # Architecture (aarch64 / sm_121a DGX Spark)
  192. TORCH_CUDA_ARCH_LIST = "12.1a"
  193. FLASHINFER_CUDA_ARCH_LIST = "12.1f"
  194. CUTE_DSL_ARCH = "sm_121a"
  195. CMAKE_CUDA_ARCHITECTURES = "121"
  196. OMP_NUM_THREADS = "2"
  197. [[extra_mounts]]
  198. host = "~/sm121-cache/glm53-jit-121f/b12x"
  199. container = "/root/.cache/b12x"
  200. # JIT caches persist per-node across serves (was: cold /root/.cache per
  201. # container -> ~20 min flashinfer/torch recompile every serve). The host
  202. # dirs are shared between lanes of the same arch — each cache
  203. # self-namespaces by its engine version key internally.
  204. [[extra_mounts]]
  205. host = "~/sm121-cache/jit-121f/flashinfer"
  206. container = "/root/.cache/flashinfer"
  207. [[extra_mounts]]
  208. host = "~/sm121-cache/jit-121f/torchinductor"
  209. container = "/root/.cache/torchinductor"
  210. [[extra_mounts]]
  211. host = "~/sm121-cache/jit-121f/vllm"
  212. container = "/root/.cache/vllm"