Building py-kvcache: A Performance Characterization of External KV Caching for vLLM with NVMe SSDs

📅 2026-09-10
📈 Citations: 0
Influential: 0
📄 PDF
🤖 AI Summary
研究通过构建py-kvcache解决vLLM中长上下文请求的时间到第一个令牌问题,利用NVMe SSDs异步直接I/O等技术优化外部KV缓存性能。
📝 Abstract
Prefix caching can reduce the time to first token (TTFT) of long-context LLM requests by reusing previously computed key-value (KV) states, but for short prefixes or fast GPUs, recomputation can be faster than loading from an external cache. We characterize this tradeoff in vLLM across GPU, CPU, and NVMe tiers using synthetic workloads, long-context benchmarks, production traces, and find that cache performance depends on transfer granularity, intermediate memory use, and when transfers enter the request schedule, not only on device bandwidth. These findings motivate py-kvcache, a vLLM KV Offload connector with asynchronous direct I/O, bounded shared staging, and scheduler-aware preloading, which starts disk reads while requests are still waiting, overlapping with compute. At 80k tokens, py-kvcache loading from disk is 2.0x faster than LMCache, with preloading contributing 1.34x. With GPU, CPU, and disk caching enabled, it is 1.23x faster than LMCache and within approximately 4% of the native vLLM KV Offload implementation. LongBench and SCBench show that these benefits extend to irregular prefix chains and multi-turn workloads. Bailian trace replays improve TTFT on a weaker GPU, but on an H100 the average request falls below the break-even point and GPU memory alone retains enough prefixes. External KV caching should therefore be treated as a setup specific admission decision. The py-kvcacheimplementation is available at: https://github.com/atlarge-research/py-kvcache.
Problem

Research questions and friction points this paper is trying to address.

external KV caching
vLLM
NVMe SSDs
time to first token (TTFT)
performance characterization
Innovation

Methods, ideas, or system contributions that make the work stand out.

asynchronous direct I/O
bounded shared staging
scheduler-aware preloading
J
Joseph Kanichai
Vrije Universiteit Amsterdam
T
Tiziano De Matteis
Vrije Universiteit Amsterdam
A
Animesh Trivedi
IBM Research Zurich