[GH-ISSUE #368] How to use Mooncake in vLLM V1? #127

Closed
opened 2026-10-29 21:09:47 +00:00 by bsakaguchi · 8 comments
Owner

Originally created by @zhenwei-intel on GitHub (May 15, 2025).
Original GitHub issue: https://github.com/kvcache-ai/Mooncake/issues/368

Originally created by @zhenwei-intel on GitHub (May 15, 2025). Original GitHub issue: https://github.com/kvcache-ai/Mooncake/issues/368
Author
Owner

@stmatengss commented on GitHub (May 15, 2025):

Currently, lmcache + mooncake supports deploying vllm v1.
Here are some references:
https://github.com/kvcache-ai/Mooncake/blob/main/doc/en/lmcache-integration.md
https://blog.lmcache.ai/2025-05-08-mooncake/

<!-- gh-comment-id:2882132534 --> @stmatengss commented on GitHub (May 15, 2025): Currently, ` lmcache + mooncake` supports deploying vllm v1. Here are some references: https://github.com/kvcache-ai/Mooncake/blob/main/doc/en/lmcache-integration.md https://blog.lmcache.ai/2025-05-08-mooncake/
Author
Owner

@tensorflowt commented on GitHub (May 16, 2025):

Currently, lmcache + mooncake supports deploying vllm v1. Here are some references: https://github.com/kvcache-ai/Mooncake/blob/main/doc/en/lmcache-integration.md https://blog.lmcache.ai/2025-05-08-mooncake/

How to use it? Currently I only see the performance indicators!

<!-- gh-comment-id:2885567131 --> @tensorflowt commented on GitHub (May 16, 2025): > Currently, ` lmcache + mooncake` supports deploying vllm v1. Here are some references: https://github.com/kvcache-ai/Mooncake/blob/main/doc/en/lmcache-integration.md https://blog.lmcache.ai/2025-05-08-mooncake/ How to use it? Currently I only see the performance indicators!
Author
Owner

@zhenwei-intel commented on GitHub (May 16, 2025):

I found a doc here: github.com/LMCache/LMCache@635eefb7ff/examples/experimental/storage_backends/mooncakestore/README.md

However, the doc uses V0, so I'm not sure if it will work on V1.
VLLM_USE_V1=0

<!-- gh-comment-id:2886639126 --> @zhenwei-intel commented on GitHub (May 16, 2025): I found a doc here: https://github.com/LMCache/LMCache/blob/635eefb7ff5360df579ef6258710307c133036e6/examples/experimental/storage_backends/mooncakestore/README.md However, the doc uses V0, so I'm not sure if it will work on V1. `VLLM_USE_V1=0`
Author
Owner

@stmatengss commented on GitHub (May 18, 2025):

Mooncake is one of the LMCache backends. You should follow the user guidance in LMCache (https://docs.lmcache.ai/getting_started/installation.html#install-from-source-v1) and set it as a backend. Here is an example YAML file for mooncake.

chunk_size: 256
local_device: "cpu"
remote_url: "mooncakestore://192.168.0.137:50051/"
remote_serde: "naive"
pipelined_backend: False
max_local_cpu_size: 100

We will release a deployment document ASAP. thx!

<!-- gh-comment-id:2889109062 --> @stmatengss commented on GitHub (May 18, 2025): Mooncake is one of the LMCache backends. You should follow the user guidance in LMCache (https://docs.lmcache.ai/getting_started/installation.html#install-from-source-v1) and set it as a backend. Here is an example YAML file for mooncake. ``` chunk_size: 256 local_device: "cpu" remote_url: "mooncakestore://192.168.0.137:50051/" remote_serde: "naive" pipelined_backend: False max_local_cpu_size: 100 ``` We will release a deployment document ASAP. thx!
Author
Owner

@zhenwei-intel commented on GitHub (May 21, 2025):

[Doc] Add document for integrating Mooncake Store to LMCache V1 https://github.com/kvcache-ai/Mooncake/pull/385

<!-- gh-comment-id:2896521061 --> @zhenwei-intel commented on GitHub (May 21, 2025): [Doc] Add document for integrating Mooncake Store to LMCache V1 https://github.com/kvcache-ai/Mooncake/pull/385
Author
Owner

@zhenwei-intel commented on GitHub (May 21, 2025):

Mooncake is one of the LMCache backends. You should follow the user guidance in LMCache (https://docs.lmcache.ai/getting_started/installation.html#install-from-source-v1) and set it as a backend. Here is an example YAML file for mooncake.

chunk_size: 256
local_device: "cpu"
remote_url: "mooncakestore://192.168.0.137:50051/"
remote_serde: "naive"
pipelined_backend: False
max_local_cpu_size: 100

We will release a deployment document ASAP. thx!

Here it's also using a KV pool instead of P2P for KV transmission, right?

this solution doesn't rely on CUDA, right?

<!-- gh-comment-id:2896525801 --> @zhenwei-intel commented on GitHub (May 21, 2025): > Mooncake is one of the LMCache backends. You should follow the user guidance in LMCache (https://docs.lmcache.ai/getting_started/installation.html#install-from-source-v1) and set it as a backend. Here is an example YAML file for mooncake. > > ``` > chunk_size: 256 > local_device: "cpu" > remote_url: "mooncakestore://192.168.0.137:50051/" > remote_serde: "naive" > pipelined_backend: False > max_local_cpu_size: 100 > ``` > > We will release a deployment document ASAP. thx! Here it's also using a KV pool instead of P2P for KV transmission, right? this solution doesn't rely on CUDA, right?
Author
Owner

@stmatengss commented on GitHub (May 21, 2025):

Mooncake is one of the LMCache backends. You should follow the user guidance in LMCache (https://docs.lmcache.ai/getting_started/installation.html#install-from-source-v1) and set it as a backend. Here is an example YAML file for mooncake.

chunk_size: 256
local_device: "cpu"
remote_url: "mooncakestore://192.168.0.137:50051/"
remote_serde: "naive"
pipelined_backend: False
max_local_cpu_size: 100

We will release a deployment document ASAP. thx!

Here it's also using a KV pool instead of P2P for KV transmission, right?

this solution doesn't rely on CUDA, right?

Yes, it is a CPU-offload KVCache pool. We will release a VRAM-based implementation

<!-- gh-comment-id:2896776659 --> @stmatengss commented on GitHub (May 21, 2025): > > Mooncake is one of the LMCache backends. You should follow the user guidance in LMCache (https://docs.lmcache.ai/getting_started/installation.html#install-from-source-v1) and set it as a backend. Here is an example YAML file for mooncake. > > ``` > > chunk_size: 256 > > local_device: "cpu" > > remote_url: "mooncakestore://192.168.0.137:50051/" > > remote_serde: "naive" > > pipelined_backend: False > > max_local_cpu_size: 100 > > ``` > > > > > > > > > > > > > > > > > > > > > > > > We will release a deployment document ASAP. thx! > > Here it's also using a KV pool instead of P2P for KV transmission, right? > > this solution doesn't rely on CUDA, right? Yes, it is a CPU-offload KVCache pool. We will release a VRAM-based implementation
Author
Owner

@mugglew commented on GitHub (May 28, 2025):

@stmatengss is that means we can not use mooncake + vllm v1 on cuda env such as H20?

<!-- gh-comment-id:2914751954 --> @mugglew commented on GitHub (May 28, 2025): @stmatengss is that means we can not use mooncake + vllm v1 on cuda env such as H20?
Sign in to join this conversation.
No milestone
No project
No assignees
1 participant
Notifications
Due date
The due date is invalid or out of range. Please use the format "yyyy-mm-dd".

No due date set.

Dependencies

No dependencies set.

Reference
kvcache-ai/Mooncake#127
No description provided.