Skip to content

[Roadmap-HiCache]: Unified Storage Framework for SGLang Across Diverse Scenarios #18239

Description

@hzh0425

Motivation

In our previous work, we introduced the HiCache framework, which provides Hierarchical storage capabilities for KVCache. https://lmsys.org/blog/2025-09-10-sglang-hicache/

SGLang currently has multiple storage implementations scattered across different modules. Several new features require similar storage capabilities:

Problem: Each module reimplements similar storage logic (async I/O, queues, eviction, host memory management, prefetch), leading to code duplication and inconsistent interfaces.

Goal: Provide a unified, extensible storage module with:

  • Generic data transfer pipelines (Device ↔ Host ↔ Storage)
  • Pluggable host memory pools for different data types
  • Reusable storage backends (File, Mooncake, 3FS)
  • Clean separation between generic infrastructure and business logic

Overview Design

Image

Roadmap

  • General CacheControllerV2: Abstract DeviceHostPipeline and StoragePipeline as reusable components @hzh0425

  • Storage Backend Support new key-value interface @stmatengss @pansicheng

    • Mooncake Backend + KVCM
    • 3FS Backend
  • EPD EmbeddingCache integration, Implement Embedding HostPool, EmbeddingCacheManager migrated to new architecture @liusy58

  • DecodeKVCacheOffloadManager、SparseKVCacheManager integration @huangtingwei9988

  • MultiModal Streaming vlm rope info @yuan-luo

  • RL Cache integration @yizhang2077

  • Elastic EP Weight Offloading: Dynamic weight management @ympcMark

  • DepSeek Engram https://github.com/deepseek-ai/Engram/

Metadata

Metadata

Labels

hicacheHierarchical Caching for SGLanginactive

Type

No type

Projects

No projects

Milestone

No milestone

Relationships

None yet

Development

No branches or pull requests

Issue actions