Models / Moonshot AI
Kimi-K3
serving recipe.
Kimi-K3 is a 2.8T total, 16 experts/token + shared (of 896 routed) active mixture of experts model with a 1M tokens context window. vLLM publishes a tested serving recipe for it, and Wingsmith reads that recipe when you register the weights.
- Size
- 2.8T total, 16 experts/token + shared (of 896 routed) activeMixture of experts
- Context
- 1M tokensAs the recipe states it.
- Memory floor
- 1650 GBSmallest published, whole replica.
- vLLM
- 0.27.1 or laterMinimum version in the recipe.
01 / Memory
Precisions and memory floors.
Each variant is a precision vLLM tested, sometimes published as its own repository.
| Variant | Precision | Memory floor | Weights |
|---|---|---|---|
| default | MXFP4 | 1680 GB | moonshotai/Kimi-K3 |
| nvfp4 | NVFP4 | 1650 GB | RedHatAI/Kimi-K3-NVFP4 |
| W4A8 (Ascend) | INT4 | 1711 GB | Eco-Tech/Kimi-K3-w4a8 |
Floors are the minimum the vLLM recipe publishes across the whole replica, from vLLM's own runs. The control plane compares them with its own sizing from the model config.
02 / Parallelism
Layouts the recipe supports.
- Tensor Parallel (default)Fits inside one node's interconnect.
single_node_tp - Multi-Node Tensor ParallelSpans nodes.
multi_node_tp - Multi-Node Tensor + Expert ParallelSpans nodes.
multi_node_tep - Multi-Node TP + Pipeline ParallelSpans nodes.
multi_node_tp_pp - Multi-Node Data + Expert ParallelSpans nodes.
multi_node_dep - Prefill/Decode DisaggregationSpans nodes.
pd_cluster - Multi-Node TP + Data ParallelSpans nodes.
multi_node_tp_dp
03 / Hardware
Where vLLM ran it.
Node shapes the recipe reports an end-to-end run on.
- B200 · 8 GPUs
- B300 · 8 GPUs
- GB200 NVL4 · 4 GPUs
- GB300 NVL4 · 4 GPUs
- H200 · 8 GPUs
- MI355X · 8 GPUs
- Ascend 910C · 16 GPUs
Wingsmith runs models through NVIDIA Dynamo, so it serves on NVIDIA GPUs. Other vendors are listed as the recipe states them.
04 / Flags
The tested baseline.
Base flags, then the default variant, then the features that are on by default, as the recipe composes them.
vllm serve moonshotai/Kimi-K3 \
--trust-remote-code \
--gpu-memory-utilization 0.95 \
--enable-auto-tool-choice \
--tool-call-parser kimi_k3 \
--reasoning-parser kimi_k3Features
- Tool callingOn by defaultEnable automatic tool choice with the Kimi K3 tool-call parser.
- ReasoningOn by defaultParse Kimi K3 reasoning output separately from the final answer.
- Speculative decodingOpt-inUse DSpark speculative decoding.
- Text-only modeOpt-inSkip the vision encoder for text-only workloads. Mutually exclusive with encoder_parallel.
- Decode context parallelismOpt-inDecode context parallelism (DCP): shard the decode KV cache across the tensor-parallel ranks for decode-heavy long-context serving. The DCP size must divide the tensor-parallel size, so the args below assume the TP8 single-node layout. Pairs the TOKENSPEED_MLA decode backend with TRTLLM_RAGGED MLA prefill under FP8 KV.
05 / Dynamo
NVIDIA Dynamo recipes.
Deployment recipes NVIDIA publishes for these weights, for vLLM.
| Engine | Mode | Role | Card | Weights | Recipe |
|---|---|---|---|---|---|
| vLLM | Aggregated | decode | gb200 | moonshotai/Kimi-K3 | kimi-k3/vllm/agg-gb200-agentic ↗ |
| vLLM | Aggregated | decode | gb300 | moonshotai/Kimi-K3 | kimi-k3/vllm/agg-gb300-agentic ↗ |
| vLLM | Disaggregated | decode | gb200 | moonshotai/Kimi-K3 | kimi-k3/vllm/disagg-gb200-agentic ↗ |
| vLLM | Disaggregated | prefill | gb200 | moonshotai/Kimi-K3 | kimi-k3/vllm/disagg-gb200-agentic ↗ |
| vLLM | Disaggregated | decode | gb300 | moonshotai/Kimi-K3 | kimi-k3/vllm/disagg-gb300-agentic ↗ |
| vLLM | Disaggregated | prefill | gb300 | moonshotai/Kimi-K3 | kimi-k3/vllm/disagg-gb300-agentic ↗ |
Each recipe link opens the deployment file at the pinned commit, with its full worker arguments.
The one default the plane takes from them
For a workload on these weights, the plane defaults --max-num-seqs to the value the aggregated recipe publishes for the card it is placed on, or the lowest published value when there is none for that card. It is the only flag adopted, and the draft names it before you submit.
| Weights | Engine | Card | --max-num-seqs |
|---|---|---|---|
moonshotai/Kimi-K3 | vLLM | gb200 | 256 |
06 / Serve
Serve it with Wingsmith.
From a slug to an OpenAI-compatible endpoint, across your clusters.
Register the weights
In the console, or through the API. Resolving a slug proposes an artifact and writes nothing.
curl "http://localhost:8000/v1/artifacts/resolve?source=hf:moonshotai/Kimi-K3"Against the local control plane from the quickstart, where admin auth is off. Read the draft
The draft carries this recipe as upstream evidence: the tested flags, the precision and memory floor, the parallelism layouts, and the hardware vLLM verified, with links back to the recipe. Nothing from it is applied without you, and the draft warns when the plane's own sizing and the published floor differ by a quarter or more.
Create the workload
Choose the engine, device shape and scale. The plane picks the clusters, and each cluster's operator renders the deployment as a Dynamo graph. The one recipe default it applies, --max-num-seqs, is shown above.
Give it an endpoint
One model name for clients, routed by the gateway to deployments on every cluster serving it.
Questions
Common questions.
- How much GPU memory does Kimi-K3 need?The vLLM recipe publishes a minimum of 1650 GB across the whole replica for its NVFP4 variant; MXFP4 1680 GB, W4A8 (Ascend) 1711 GB. That is vLLM's own measurement, not a per-GPU figure.
- Which parallelism layouts does the Kimi-K3 recipe support?Tensor Parallel, Multi-Node Tensor Parallel, Multi-Node Tensor + Expert Parallel, Multi-Node TP + Pipeline Parallel, Multi-Node Data + Expert Parallel, Prefill/Decode Disaggregation and Multi-Node TP + Data Parallel. The recipe's default is Tensor Parallel.
- Can Wingsmith serve Kimi-K3?Wingsmith serves models through NVIDIA Dynamo on clusters with NVIDIA GPUs. Register moonshotai/Kimi-K3 and the plane attaches this vLLM recipe to the draft as evidence: its tested flags, precision and memory floor, for you to review rather than applied on your behalf.
- Does NVIDIA publish a Dynamo recipe for Kimi-K3?Yes: 6 deployment entries for vLLM, aggregated and disaggregated. When a workload is placed, the plane defaults --max-num-seqs to the value the aggregated recipe publishes for that card, and names it on the draft.
From the vLLM recipe for moonshotai/Kimi-K3 ↗ (snapshot at 4bcc189) and NVIDIA Dynamo's recipes at 165d854, Apache 2.0.
Status
Open source,
under Apache 2.0.
Wingsmith is pre-release. The first public release, and everything after it, will be under Apache 2.0.
Built and not built
Built
Multi-cluster placement and routing, Dynamo deployments, device inventory, endpoints and quotas, the console, the CLI, and three measurement tools.
Not built
Published images and charts, per-user roles and SSO, batch and training workloads, and a Helm chart for the control plane.
Pre-release. No tagged release, images, or charts yet, and APIs and protocols can change.