launcher/recipes/mimo26-flash-mopd-4x-vllm/recipe.toml

# MiMo-V2.6-Flash-MOPD on 4x DGX Spark via vLLM + B12X — the engine A/B twin
# of mimo26-flash-mopd-4x (SGLang). No new image: r39 already carries the
# fork's MiMo-V2 integration (mimo_v2.py; SWA+DFlash PR #46104 merged into
# the lab fork main 2026-07-01, present at the 9e5d1793 tag), so this lane
# boots the SAME engine lineage our GLM-5.3 r39 lanes run — only the model
# and the launch policy differ.
#
# Launch policy mirrors local-inference-lab's lil-catalog MiMo manifests
# (MiMo-V2.6-Flash-RL TP4 qualified on SM120; Pro-MOPD TP8 with the DFlash
# `dflash/` subfolder draft, BF16 draft weights, b12x noncausal sliding
# attention). Deviations: GMU 0.88 -> 0.84 (operator call, GB10 UMA guard),
# TP8 -> TP4 (our 4-node lane).
#
# What we are testing:
#   * B12X attention long-context path on 192/128 GQA (the sglang-triton
#     lane decodes at 30% of d0 at 256K; the lab's vLLM stack has the
#     split-KV verify fix that fixed exactly this on their boxes).
#   * BF16 KV @ GMU 0.84 (their cache policy — fp8 KV skipped on both stacks).
#   * DFlash via vLLM speculative-config (method dflash, draft from the
#     checkpoint's dflash/ subfolder, 7 draft tokens) vs sglang's DFlash.
#
# Status: PARKED — dead end on r39 (2026-09-28). Four boot attempts, each one
# layer deeper: (1) EAGLE3 hook raised on the Omni wrapper — fixed by the
# image's inner-language-model patch; (2) B12X rejects the draft's non-causal
# attention — draft moved to TRITON_ATTN; (3) qwen3_dflash hard-imports
# ModelOptMxFp8LinearMethod that r39's modelopt doesn't ship — patched to be
# None-tolerant; (4) FATAL: KV-layout validator refuses the MiMo hybrid stack
# (SWA-128 + GA layers, mixed page sizes 131072/163840) because b12x declares
# LBNHC only and the check is backend-declared, not env-fixable. r39 was
# qualified for GLM-5.3, never for MiMo; lil-catalog itself marks their MiMo
# DFlash "runtime qualification unverified". Reopening recipe + external
# intel (madeby561 amd64-only rc4, eugr spark-vllm-b12x nightlies, lil-catalog
# flags): specs/bugs/BUG-2026-09-28-vllm-mimo-dflash-parked.md.
#
# REOPENED 2026-09-28 same evening: the eugr/spark-vllm-b12x nightly (source
# local-inference-lab/vllm@dev/karmic-kraken) landed all four missing pieces
# on 2026-09-22 — MiMo aux-state loading, block-outermost KV layouts for
# mixed page sizes, b12x non-causal attention (so the DFlash draft runs B12X
# too), and the eagle3 language-model unwrap. It also ships cached
# serve-launchers (serve-mimo26-flash.sh) that define the canonical MiMo
# flag set; we mirror them. No local image build: docker_image is the
# nightly tag, distributed to nodes by save/load.

engine = "vllm"
name = "MiMo-V2.6-Flash-MOPD (vLLM B12X, 4x Spark, DFlash-7, b12x-nightly)"
docker_image = "eugr/spark-vllm-b12x:latest"
entrypoint = ["vllm", "serve"]
model = "XiaomiMiMo/MiMo-V2.6-Flash-MOPD"
parent_model = "XiaomiMiMo/MiMo-V2.6-Flash-MOPD"
port = 30000
required_nodes = 4
tensor_parallel_size = 4
pipeline_parallel_size = 1
distributed_backend = "mp"
shm_size = "32gb"

args = [
    "--served-model-name", "mimo-v2.6-flash",
    "--trust-remote-code",
    "--distributed-executor-backend", "mp",
    # Operator GMU (0.88 -> 0.84 for this first vLLM MiMo boot); their
    # manifest's 0.98 is RTX PRO 6000 territory, not GB10 UMA.
    "--gpu-memory-utilization", "0.84",
    "--block-size", "128",
    "--max-model-len", "524288",
    "--max-num-seqs", "4",
    "--max-num-batched-tokens", "4096",
    "--enable-chunked-prefill",
    "--async-scheduling",
    "--enable-prefix-caching",
    # B12X attention (lab-qualified on MiMo's 192/128 heads; non-causal now
    # supported by the nightly's b12x — the DFlash draft runs on B12X too).
    "--attention-backend", "B12X",
    # Mirror of the lab's serve-mimo26-flash.sh: b12x linear + MoE backends.
    "--linear-backend", "b12x",
    "--moe-backend", "b12x",
    "--load-format", "instanttensor",
    "--kernel-config", """
'{"enable_cutedsl_warmup":false,"enable_flashinfer_autotune":false}'""",
    # DFlash draft from the checkpoint's dflash/ subfolder (7 tokens). The
    # karmic-kraken b12x supports non-causal attention, so the draft runs
    # B12X as well (the TRITON_ATTN workaround was only needed on r39).
    "--speculative-config", """
'{"method":"dflash","model":"{{dflash}}","num_speculative_tokens":7,"attention_backend":"B12X"}'""",
    # Nightly resolves the Omni wrapper's eagle3 hook on the inner language
    # model natively (no image patch needed); --language-model-only keeps
    # the visual/audio towers out of the memory budget.
    "--language-model-only",
    "--reasoning-parser", "mimo",
    "--tool-call-parser", "mimo",
    "--enable-auto-tool-choice",
    "--generation-config", "vllm",
]

# DFlash draft weights: a subfolder of the main model repo, resolved per node
# (same mount as the sglang lane; {{dflash}} in the speculative config).
[[extra_mounts]]
repo = "XiaomiMiMo/MiMo-V2.6-Flash-MOPD"
subfolder = "dflash"
container = "dflash"

# JIT caches: same per-node dirs the GLM r39 lane warms (b12x/flashinfer/
# torchinductor/vllm), so this lane boots JIT-warm off day zero.
[[extra_mounts]]
host = "~/sm121-cache/glm53-jit-121f/b12x"
container = "/root/.cache/b12x"

[[extra_mounts]]
host = "~/sm121-cache/jit-121f/flashinfer"
container = "/root/.cache/flashinfer"

[[extra_mounts]]
host = "~/sm121-cache/jit-121f/torchinductor"
container = "/root/.cache/torchinductor"

[[extra_mounts]]
host = "~/sm121-cache/jit-121f/vllm"
container = "/root/.cache/vllm"

[env]
HF_HUB_OFFLINE = "1"
VLLM_ENABLE_ROCE_ALLREDUCE = "1"
MAX_JOBS = "2"
VLLM_ENGINE_READY_TIMEOUT_S = "3600"
PYTORCH_CUDA_ALLOC_CONF = "expandable_segments:True"
VLLM_USE_AOT_COMPILE = "0"
VLLM_USE_STANDALONE_COMPILE = "1"
VLLM_USE_FLASHINFER_SAMPLER = "1"
VLLM_USE_BREAKABLE_CUDAGRAPH = "0"
TORCH_USE_RTLD_GLOBAL = "1"
VLLM_NO_USAGE_STATS = "1"
TORCH_CUDA_ARCH_LIST = "12.1a"
FLASHINFER_CUDA_ARCH_LIST = "12.1f"
# b12x CuTe kernels target sm_121a on GB10 (the lab launcher defaults to
# sm_120a = RTX PRO; eugr's own recipes override it the same way).
CUTE_DSL_ARCH = "sm_121a"
CMAKE_CUDA_ARCHITECTURES = "121"
OMP_NUM_THREADS = "2"