Mooncake/mooncake-wheel/mooncake
Xun Sun 77ae1034a6
[PG] Enable asynchronous recovered-rank initialization with deferred join (#1744)
During Elastic EP rank recovery, the recovered rank must re-run expensive initialization (especially CUDA graph capture).
  Previously, this required the recovered and healthy ranks to enter the same communication phase, which paused healthy-rank inference and increased recovery disruption.

  This change enables **asynchronous recovered-rank initialization** in Mooncake PG: recovered ranks can initialize in isolation first, then join the live process group after local recovery work is finished.
2026-03-29 13:26:21 +08:00
..
README.md [Bugfix] sync vllm mooncake connector from main repo (#1466) 2026-01-30 23:35:43 +08:00
__init__.py [MooncakeAdaptor] reconstruct the adaptor arch (#232) 2025-04-11 17:54:02 +08:00
cli.py feat(mooncakestore): add mooncake_master CLI entry point and tests (#218) 2025-04-08 17:41:03 +08:00
cli_bench.py [Build] add TE bench into wheel package (#514) 2025-06-18 19:04:09 +08:00
cli_client.py [Store] feat: Add standalone deployment implementation for Client (#1084) 2025-11-25 23:57:30 +08:00
ep.py Split Mooncake PG out of Mooncake EP (#1387) 2026-01-16 13:39:37 +08:00
http_metadata_server.py [Store] feat(store): add duplicate rpc_meta key check and CI integration (#818) 2025-09-10 12:10:32 +08:00
mooncake_config.py [Doc] Document all supported communication protocols (#1435) 2026-01-27 01:01:54 +08:00
mooncake_connector_v1.py [Bugfix] sync vllm mooncake connector from main repo (#1466) 2026-01-30 23:35:43 +08:00
mooncake_ep_buffer.py [PG] Enable asynchronous recovered-rank initialization with deferred join (#1744) 2026-03-29 13:26:21 +08:00
mooncake_store_service.py [Store] feat: wait Master ready when starting Store server (#1438) 2026-01-26 17:37:46 +08:00
pg.py Split Mooncake PG out of Mooncake EP (#1387) 2026-01-16 13:39:37 +08:00
transfer_engine_topology_dump.py [TE/Topology] Support device filtering when dumping topology (#1087) 2025-11-24 23:09:21 +08:00
vllm_v1_proxy_server.py [Bugfix] sync vllm mooncake connector from main repo (#1466) 2026-01-30 23:35:43 +08:00

README.md

mooncake_connector_v1

This is a KV connector for vllm v1.

Supported vllm version: from 0.10.1 to 0.12.0

For 0.13.0 or later, please use the intree vllm mooncake_connector.

Usage

Add proper "--kv-transfer-config" parameters to your vLLM command. See comments in mooncake_connector_v1.py.

For example, a whole demo could be:

Prefill Node (192.168.0.2)

vllm serve Qwen/Qwen2.5-7B-Instruct --port 8010 --kv-transfer-config '{"kv_connector":"MooncakeConnector","kv_role":"kv_producer", "kv_connector_module_path":"mooncake.mooncake_connector_v1"}'

Decode Node (192.168.0.3)

vllm serve Qwen/Qwen2.5-7B-Instruct --port 8020 --kv-transfer-config '{"kv_connector":"MooncakeConnector","kv_role":"kv_consumer", "kv_connector_module_path":"mooncake.mooncake_connector_v1"}'

Proxy

python -m mooncake.vllm_v1_proxy_server --prefiller-host 192.168.0.2 --prefiller-port 8010 --decoder-host 192.168.0.3 --decoder-port 8020

Now you can send requests to the proxy server on default port 8000.