Instructions to use RadixArk/Kimi-K3-DSpark with libraries, inference providers, notebooks, and local apps. Follow these links to get started.
- Libraries
- Transformers
How to use RadixArk/Kimi-K3-DSpark with Transformers:
# Use a pipeline as a high-level helper from transformers import pipeline pipe = pipeline("text-generation", model="RadixArk/Kimi-K3-DSpark", trust_remote_code=True)# Load model directly from transformers import AutoTokenizer, AutoModel tokenizer = AutoTokenizer.from_pretrained("RadixArk/Kimi-K3-DSpark", trust_remote_code=True) model = AutoModel.from_pretrained("RadixArk/Kimi-K3-DSpark", trust_remote_code=True, device_map="auto") - Notebooks
- Google Colab
- Kaggle
- Local Apps Settings
- vLLM
How to use RadixArk/Kimi-K3-DSpark with vLLM:
Install from pip and serve model
# Install vLLM from pip: pip install vllm # Start the vLLM server: vllm serve "RadixArk/Kimi-K3-DSpark" # Call the server using curl (OpenAI-compatible API): curl -X POST "http://localhost:8000/v1/completions" \ -H "Content-Type: application/json" \ --data '{ "model": "RadixArk/Kimi-K3-DSpark", "prompt": "Once upon a time,", "max_tokens": 512, "temperature": 0.5 }'Use Docker
docker model run hf.co/RadixArk/Kimi-K3-DSpark
- SGLang
How to use RadixArk/Kimi-K3-DSpark with SGLang:
Install from pip and serve model
# Install SGLang from pip: pip install sglang # Start the SGLang server: python3 -m sglang.launch_server \ --model-path "RadixArk/Kimi-K3-DSpark" \ --host 0.0.0.0 \ --port 30000 # Call the server using curl (OpenAI-compatible API): curl -X POST "http://localhost:30000/v1/completions" \ -H "Content-Type: application/json" \ --data '{ "model": "RadixArk/Kimi-K3-DSpark", "prompt": "Once upon a time,", "max_tokens": 512, "temperature": 0.5 }'Use Docker images
docker run --gpus all \ --shm-size 32g \ -p 30000:30000 \ -v ~/.cache/huggingface:/root/.cache/huggingface \ --env "HF_TOKEN=<secret>" \ --ipc=host \ lmsysorg/sglang:latest \ python3 -m sglang.launch_server \ --model-path "RadixArk/Kimi-K3-DSpark" \ --host 0.0.0.0 \ --port 30000 # Call the server using curl (OpenAI-compatible API): curl -X POST "http://localhost:30000/v1/completions" \ -H "Content-Type: application/json" \ --data '{ "model": "RadixArk/Kimi-K3-DSpark", "prompt": "Once upon a time,", "max_tokens": 512, "temperature": 0.5 }' - Docker Model Runner
How to use RadixArk/Kimi-K3-DSpark with Docker Model Runner:
docker model run hf.co/RadixArk/Kimi-K3-DSpark
Kimi K3 DSpark speculator
Overview
A long-context DSpark speculator for Kimi K3. It supports context lengths of up to 1 million tokens.
A DSpark speculator for the Kimi K3 target, enabling faster inference through speculative decoding. DSpark extends the DFlash parallel-draft backbone with a Markov logit-bias head and a per-position confidence head. This checkpoint was trained with SpecForge using hidden states from a live SGLang target engine.
Model Specifications
- Base model:
moonshotai/Kimi-K3 - Format: Safetensors (single-file BF16, 2,249,289,601 parameters)
- Draft: 5 full-attention Qwen3-style GQA layers, hidden size 7168,
64 query heads / 16 KV heads, and
block_size=7 - Verification width: 1 current token + 7 draft tokens
- Auxiliary target layers:
[7, 23, 51, 67, 83] - Trained context: 65,536 tokens
- Target weights: embedding and unembedding weights are not included
Evaluation Results
acc_len is SGLang's histogram-native request acceptance length, averaged
within each question and then equally across questions.
| Dataset | Questions | acc_len |
|---|---|---|
| GSM8K | 1,319 | 5.4176 |
| MATH500 | 500 | 4.1329 |
| HumanEval | 164 | 5.5121 |
| MBPP | 257 | 5.1980 |
| MT-Bench | 80 | 3.9342 |
| AIME26 | 30 | 2.9893 |
| RULER V2 1M (MK/MV/QA) | 150 (50 per partition) | 4.2553 |
RULER V2 uses the 1M input configuration. Actual prompts span 1,000,432β1,047,925 tokens; partition acc_len is 4.4658 for MK, 4.3081 for MV, and 3.9919 for QA.
AIME26 acc_len by output length
| Output-token bucket | Questions | Actual output range | acc_len |
|---|---|---|---|
| 0β1K | 13 | 192β885 | 3.1310 |
| 1β2K | 5 | 1,359β1,828 | 2.5773 |
| 2β4K | 6 | 2,210β3,732 | 2.5632 |
| 4β8K | 4 | 5,187β7,750 | 2.7174 |
| 8β16K | 0 | β | β |
| 16β32K | 0 | β | β |
| 32K+ | 2 | 54,545β224,703 | 4.9194 |
Serving with SGLang
sglang serve \
--trust-remote-code \
--model-path moonshotai/Kimi-K3 \
--tp-size 8 \
--dcp-size 8 \
--mem-fraction-static 0.85 \
--max-mamba-cache-size 160 \
--max-running-requests 32 \
--cuda-graph-max-bs-decode 32 \
--reasoning-parser kimi_k3 \
--tool-call-parser kimi_k3 \
--host 0.0.0.0 \
--port 30000 \
--speculative-algorithm DSPARK \
--speculative-draft-model-path RadixArk/Kimi-K3-DSpark-0731 \
--speculative-dspark-block-size 7 \
--speculative-draft-attention-backend trtllm_mha \
--enable-linear-replayssm-spec \
--context-length 1048576 \
--chunked-prefill-size 16384
YaRN-16 is enabled in the published draft config by default with
original_max_position_embeddings=65536 and
max_position_embeddings=1048576; no separate draft config override is
required.
Training Details
- Framework: SpecForge online distillation, with hidden states captured from a frozen Kimi K3 target served by a live SGLang engine. Draft trained from random initialization.
- Loss:
0.1 CE + 0.9 L1 distillation + 1.0 confidence BCE, decay gamma 4.0, with 512 sampled anchors per sequence andblock_size=7. - Topology: 4 nodes Γ 4 GB300 (16 ranks) β 2 Γ TP8 target replicas, DP2 sampler, FSDP16
SHARD_GRAD_OPon the draft, TP-batch scatter. Batch 8 per replica Γ 32 accumulation steps Γ 2 replicas = global batch 512.
- Downloads last month
- 147,291
docker model run hf.co/RadixArk/Kimi-K3-DSpark