RFC: Integrating KVMem virtual working set for 256K context on 16GB VRAM (Working prototype ready in fork)

Đang mở
#192 27 bình luận 0 reaction 0 người được giao Xem trên GitHub

Chưa có ai nhận issue này.

Đánh giá

Độ khó
5/5
Thời gian dự kiến
Hơn một tuần
Mức phù hợp với người mới
8/100
Loại issue
Tính năng
Độ rõ ràng
Khá rõ ràng
Mức độ hoạt động
Sôi nổi
Công nghệ
cpp

Hướng nghiên cứu

This is an RFC, not a scoped task: it asks the maintainer to choose between upstreaming a ~36K LOC KVMem working-set engine and keeping it as a downstream fork, and the 27-comment thread is where that decision is being made. To follow it, read the fork branch beellama-kvmem and the referenced ggml-cuda/gated_delta_net.cu Blackwell fix, then the thread for the maintainer's answer. Done means an architectural decision plus, at most, a targeted PR such as the GDN CUDA fix; nothing here is a first contribution.

Do mô hình lập chỉ mục viết ra từ nội dung của issue.

Mô tả

RFC: Integrating KVMem virtual working set for 256K context on 16GB VRAM (Working prototype ready in fork)

Context & Motivation

Large context windows (128K–256K) on 27B+ models like Qwen3.8-27B (and hybrid architectures with Gated Delta Net) are traditionally difficult to run on consumer hardware (16GB VRAM cards like RTX 4080 / RTX 5060 Ti).

While BeeLlama's native KVarN (and SWA) provides substantial cache savings (~2.67x with kvarn6), pushing beyond 100K–128K on 16GB VRAM still pushes right up against physical memory limits.

We have successfully integrated the KVMem virtual working set engine (arXiv:2609.04852) into BeeLlama v0.4.6, maintaining full compatibility with BeeLlama's core optimizations while allowing true 256K context streaming.

A fully working implementation, benchmarks, and Windows binaries are available in the fork:
👉 Repository & Branch: Andgihat/beellama.cpp (branch: beellama-kvmem)
👉 Release & Binaries: v0.4.6-kvmem


How it works
  1. Host RAM Virtual Working Set: The complete 262,144 (256K) context lives in pinned Host RAM (DDR5, ~8–12 GB).
  2. Fixed GPU Slot Pool: Only an active working set (e.g. Budget $B = 36K$ + Reserve $R = 16K$) sits in VRAM (~14.6 GB total with weights, zero OOM).
  3. Graph Recall & Cache Quantization: Blocks (128 tokens) are staged in/out over PCIe on the fly using Hadamard-rotated quantized slots (q4_0 / q8_0).
  4. Blackwell sm_120 Fix: In the process, we resolved a GDN warp reduction bug in ggml-cuda/gated_delta_net.cu (lanes_per_col stride and pointer offset check keep_rs = K > 1), restoring 100% correct mathematics for hybrid Qwen3.8 on RTX 50-series GPUs.

Benchmark Results (Qwen3.8-27B-UD-Q3_K_XL on RTX 5060 Ti 16GB)

Tested on real text documents from 10K to 256K context:

  • Prompt Processing (Prefill @ 10K+ tokens): 915.84 tokens/s (10,196 tokens processed in 11.13s with -b 2048 -ub 1024).
  • Decode Speed: 35.6 - 40.3 tokens/s with built-in MTP (--spec-type draft-mtp).
  • MTP Acceptance Rate: 76.0% (consistent 2.46 tokens/round).
  • RAM Usage @ 10K: Only 187 MB with q4_0 cache.
  • VRAM Headroom: Fits comfortably within 15.3 GB on a 16GB GPU.

Question for Maintainer (@Anbeeld)

Because the KVMem integration is relatively substantial (~36K LOC including tests, standalone llama-kvmem-server, and runtime adapters), we wanted to check with you first:

  1. Upstream PR: Would you be interested in having KVMem integrated directly into upstream BeeLlama (e.g. as an optional feature / server target)?
  2. Specialized Fork: Or would you prefer we maintain this as a specialized downstream fork / companion project (beellama-kvmem), and only submit targeted PRs (such as the Blackwell GDN CUDA fixes in gated_delta_net.cu) to upstream?

Happy to adapt the changes or submit targeted PRs depending on your architectural preferences. Thank you for the awesome work on BeeLlama!

Ngôn ngữ chính
C++
Star
1.2k
Fork
80
Merge trung bình
4 ngày 20 giờ
Pull request đã merge (30 ngày)
2

Chuẩn bị môi trường

Dự án này không cung cấp dev container, Dockerfile hay hướng dẫn đóng góp, nên bạn cần tự thiết lập môi trường: hãy bắt đầu từ README và xem hướng dẫn đóng góp lần đầu của chúng tôi để biết các bước chung.

Bắt đầu từ đâu

  1. Đọc hết issue, rồi đọc hướng dẫn đóng góp của dự án.
  2. Bình luận trên issue rằng bạn sẽ nhận — tránh hai người làm cùng một việc.
  3. Fork repository và làm thay đổi trên một nhánh.
  4. Mở pull request có tham chiếu số hiệu của issue.

Issue khác của Anbeeld/beellama.cpp

Tất cả issue của Anbeeld/beellama.cpp

Issue tương tự

Thêm issue về C++

Nhận issue mới trong hộp thư của bạn

Bản tóm tắt ngắn những issue GitHub phù hợp với người mới.