
kvcached
让 GPU 显存像云硬盘一样弹性共享,多模型推理不再浪费缓存。
项目预览
项目数据
项目介绍
Star 增长趋势
本站每日记录该项目 GitHub 星标变化,观测越久曲线越完整
数据来源:GitHub API 逐日快照 · 收录于 2026-08-10 · 当前星标 ★ 2034
使用教程
ℹ 本教程由 AI 依据该项目 README 整理,个别步骤可能需要按你的环境微调。
环境要求
- Python 3.9 至 3.13(README 徽章标注的支持范围)
- 已安装 pip,可访问 PyPI
- 如需容器方式,需本机已安装 Docker 并能拉取 ghcr.io 镜像
- GPU 推理引擎(vLLM / SGLang)由官方镜像自带,无需自行准备
安装与启动步骤
-
1确认 Python 版本
kvcached 要求 Python 3.9~3.13,先检查本机版本是否落在该区间,不满足需先升级或切换环境。
python --version -
2从 PyPI 安装
官方推荐方式,README 明确要求带上 --no-build-isolation 参数,建议在虚拟环境中执行。
pip install kvcached --no-build-isolation -
3拉取 SGLang 镜像
若走容器方式,可拉取已集成 SGLang 的镜像,对应 kvcached-v0.1.5-sglang-v0.5.10。
docker pull ghcr.io/ovg-project/kvcached-sglang:latest -
4拉取 vLLM 镜像
拉取集成 vLLM 的镜像,对应 kvcached-v0.1.5-vllm-v0.19.0,适合已有 vLLM 部署流程的用户。
docker pull ghcr.io/ovg-project/kvcached-vllm:latest -
5拉取开发镜像
面向开发者的一站式镜像,包含完整开发环境,便于自行编译或二次开发调试。
docker pull ghcr.io/ovg-project/kvcached-dev:latest
如何确认成功
执行 pip show kvcached 能显示版本信息;用 docker images 能看到已拉取的 kvcached 镜像。
常见问题
Q:支持哪些 Python 版本?
A:README 徽章标注支持 Python 3.9 到 3.13,低于 3.9 或高于 3.13 的版本未声明兼容,建议切换版本后再安装。
Q:安装时为什么建议加 --no-build-isolation?
A:README 给出的安装命令即为 pip install kvcached --no-build-isolation,直接照抄该参数可避免构建隔离导致的依赖问题。
Q:该用哪个 Docker 镜像?
A:按推理引擎选:用 SGLang 选 kvcached-sglang,用 vLLM 选 kvcached-vllm;需要开发调试环境则选 kvcached-dev。
Q:有 GB200 的镜像吗?
A:README 说明 GB200 的 Docker 镜像仍在准备中(on the way),暂未提供,可关注仓库后续更新。
Q:从哪里获取更多资料?
A:README 提供了 DeepWiki 文档、kvcached.org 主页、Slack 交流群以及两篇 arXiv 论文链接,可据此深入了解。
注意事项
- README 中 Install from source 一节没有给出任何命令,源码安装需自行参考仓库内容。
- Docker 相关的更多说明位于仓库的 docker/README.md,README 正文仅给出镜像拉取命令。
- 项目采用 Apache 2.0 许可证。
- 镜像标签 latest 会随版本更新,生产环境建议固定到实际版本标签。
核心亮点
- 将 KV 缓存虚拟化,支持动态伸缩,显存利用率提升显著
- 提供细粒度调度策略,减少缓存碎片,提升多租户隔离性
- 与主流推理引擎(vLLM 等)集成简单,Python 接口友好
不足之处
- 项目较新,生产环境稳定性案例不足
- 文档和社区生态待观察
适用场景
- 云服务商多租户 LLM 推理平台
- 高并发多模型共享 GPU 集群
- 边缘设备上动态调整缓存容量
替代项目
vLLM、SGLang、TensorRT-LLM
同类项目推荐
openai
开源
在 .NET 项目里一键调用 ChatGPT、DALL-E、Whisper 等 AI 能力
.NET library for the OpenAI service API by Betalgo Ranul
gitmoney-public-framework
开源
套用现成框架,AI 办公基建不用从零搭建
Public GitMoney framework for plain-English GitHub, AI Office infrastructure, and fo···
cuvs
开源
GPU 上跑向量检索与聚类,十亿级数据也能秒级返回
cuVS - a library for vector search and clustering on the GPU
chitu
开源
让大模型推理更快更省,轻松部署高并发服务
High-performance inference framework for large language models, focusing on efficien···
LocalLLMClient
开源
在苹果设备上轻松跑本地大模型,离线也能用
Swift package to run local LLMs on iOS, macOS, Linux
rerun
开源
实时可视化多模态机器人数据,让调试和训练更高效
Visualize, query, and stream to train on multimodal robotics data.
ComfyUI-Distributed
开源
多张显卡一起跑 ComfyUI,出图更快
ComfyUI extension that enables multi-GPU processing locally, remotely and in the clo···
sagemaker-custom-project-templat···
开源
用现成模板,快速搭建 SageMaker 标准化 MLOps 流水线
This repository contains guidance related to SageMaker AI Projects. SageMaker Projec···
mlflow
开源
每次实验全程留痕,模型好坏一眼看清不靠猜
The open source AI engineering platform for agents, LLMs, and ML models. MLflow enab···