Skip to content

[docs] Kimi-K3: widen the H200 High-Throughput recipe to 4x8 TP32/EP32 - #32834

Merged
zijiexia merged 1 commit into
mainfrom
claude/kimi-k3-h200-high-throughput-4x8
Jul 30, 2026
Merged

zijiexia merged 1 commit into
mainfrom
claude/kimi-k3-h200-high-throughput-4x8

Conversation

@zijiexia

@zijiexia zijiexia commented Jul 30, 2026 •

Copy link
Copy Markdown
Collaborator

Motivation

The Kimi-K3 cookbook's H200 / Unified / High-Throughput cell was a copy of Balanced (2×8 TP16/EP16) with --mem-fraction-static 0.90 and extra_buffer_lazy. The shape actually run for that operating point is TP32/EP32 across 4 nodes, so the page shipped a recipe nobody serves.

Modifications

docs_new/src/snippets/configs/moonshotai/kimi-k3.jsx — the H200 Unified High-Throughput cell:

  • nnodes: 2 → 4, --tp-size/--ep-size 16 → 32
  • adds --dist-timeout 3600 and the cross-node fabric env the H100 4×8 cells already carry: SGLANG_HOST_IP, NCCL_SOCKET_IFNAME, GLOO_SOCKET_IFNAME (via the existing {{LOCAL_IP}} / {{NETWORK_IFACE}} placeholders), PYTORCH_CUDA_ALLOC_CONF=expandable_segments:True, SGLANG_K3_ATTN_RES_MODE=jit, SGLANG_MOE_FUSED_GATE_RADIX=1
  • unchanged: Marlin, FlashMLA, symm-mem, mem-frac 0.90, extra_buffer_lazy
  • --nnodes / --node-rank / --dist-init-addr stay out of the cell (engine-injected), and --mamba-full-memory-ratio stays out too so the ratio calculator keeps driving it

As run — DSPARK and HiCache L1+L2 layered on, ratio 0.058 — the static allocation leaves 12.54 GB free per GPU and 1940352 KV tokens. Recorded in the cell comment.

Node count is a cell property, so the three prose spots that state H200 = 2×8 are updated in Kimi-K3.mdx (hardware-recipe line, Strategy list, per-platform table), along with the h200 multi-node hint that said "BOTH ranks".

Checklist

  • mint validate passes
  • Rendered locally (mint dev): the H200 High-Throughput command emits --nnodes 4 --node-rank <rank> --dist-init-addr <node0-ip>:20000 with TP32/EP32
  • Docs-only change; no runtime code touched

CI States

Latest PR Test (Base): ✅ Run #30501811286
Latest PR Test (Extra): ❌ Run #30501811122

The H200 Unified High-Throughput cell was a copy of Balanced (2x8 TP16/EP16)
with mem-frac 0.90 and extra_buffer_lazy. Replace it with the shape that was
actually run: TP32/EP32 across 4 nodes, plus the cross-node fabric env the
H100 4x8 cells already carry (SGLANG_HOST_IP, NCCL/GLOO_SOCKET_IFNAME,
PYTORCH_CUDA_ALLOC_CONF, SGLANG_K3_ATTN_RES_MODE, SGLANG_MOE_FUSED_GATE_RADIX)
and --dist-timeout 3600.

As run — DSPARK and HiCache L1+L2 layered on, --mamba-full-memory-ratio 0.058 —
the static allocation leaves 12.54 GB free per GPU and 1940352 KV tokens.

Node count is a cell property, so the prose that states H200 is 2x8 is updated
in three places: the hardware-recipe line, the Strategy list, and the
per-platform table. The h200 multi-node hint said "BOTH ranks", which is no
longer true for this cell.

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
@gemini-code-assist

Copy link
Copy Markdown
Contributor

Caution

The consumer version of Gemini Code Assist on GitHub has been sunset. All code review activity has officially ceased.

@github-actions github-actions Bot added the documentation Improvements or additions to documentation label Jul 30, 2026
@mintlify

mintlify Bot commented Jul 30, 2026

Copy link
Copy Markdown
Contributor

Preview deployment for your docs. Learn more about Mintlify Previews.

Project Status Preview Updated (UTC)
lmsysorg 🟢 Ready View Preview Jul 30, 2026, 12:11 AM

💡 Tip: Enable Workflows to automatically generate PRs for you.

@mintlify

mintlify Bot commented Jul 30, 2026

Copy link
Copy Markdown
Contributor

Preview deployment for your docs. Learn more about Mintlify Previews.

Project Status Preview Updated (UTC)
lmsysorg 🟡 Building – Jul 30, 2026, 12:09 AM

💡 Tip: Enable Workflows to automatically generate PRs for you.

@zijiexia
zijiexia merged commit 3c9efaf into main Jul 30, 2026
88 of 92 checks passed
@zijiexia
zijiexia deleted the claude/kimi-k3-h200-high-throughput-4x8 branch July 30, 2026 00:18
saturn-acc pushed a commit to saturn-acc/sglang that referenced this pull request Aug 16, 2026
Atituiset pushed a commit to Atituiset/sglang that referenced this pull request Sep 10, 2026

This branch was successfully deployed

1 active deployment
staging - docs_new — 607f2a93 Deployed Jul 30, 2026 by mintlify[bot]
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

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants