thetom/turboquant_plus

TurboQuant+ is a KV cache compression tool for large language models that reduces memory footprint during inference.

View on GitHub ↗Jump to charts ↓Open shareable report

Summary Information

Updated 2 minutes ago
Added to GitGenius on September 1st, 2026
Created on March 25th, 2026
Open Issues & Pull Requests: 47 (+0)
GitHub issues: Enabled
Number of forks: 927
Total Stargazers: 7,021 (+0)
Total Subscribers: 65 (+0)

Repository Insights (GitGenius)

Median issue/PR response: 0.7 hours
Mean response time: 42.1 hours
90th percentile: 5.6 days
Tracked items: 48

How this project is maintained

Around half of the issues opened in the past year never receive a reply. 72% of open issues come from outside the core team, so the backlog reflects real-world use rather than internal planning. Only 6% of issues opened in the past year have been closed. Three people close 100% of everything that gets resolved.

Charts & Analytics

Fetching additional details & charts...

Issue Activity (beta)

Open issues: 36
New in 7 days: 1
Closed in 7 days: 0
Avg open age: 143 days
Stale 30+ days: 35
Stale 90+ days: 33

Recent activity

Opened in 7 days: 1
Closed in 7 days: 0
Comments in 7 days: 0
Events in 7 days: 0

Top labels

  • P1 (13)
  • type:algorithm (12)
  • P0 (11)
  • type:benchmark (6)
  • type:bug (6)
  • P2 (3)
  • P3 (3)
  • type:port (3)

Detailed Description

TurboQuant+ is a KV cache compression tool for large language models that reduces memory footprint during inference.

The tool addresses the memory bottleneck in transformer inference by compressing the key-value cache using PolarQuant quantization combined with Walsh-Hadamard rotation. This approach achieves 3.8-6.4x compression while maintaining near-original prefill speed and approximately 0.9x decode throughput at long context lengths. The compression works across model scales from 1.5B to 104B parameters and has been validated at 128K context windows, even running on resource-constrained hardware like MacBooks.

Developers working on inference optimization for large language models should consider this tool if memory efficiency is a priority and they can tolerate modest decode throughput reduction. The project is particularly suited for long-context inference scenarios where KV cache memory dominates total memory usage. The tool has proven stable enough that its core techniques have been adopted upstream: vLLM has integrated TurboQuant KV cache compression with fused Triton kernels, and llama.cpp has merged the Hadamard rotation approach with optimized implementations for CPU, CUDA, and Vulkan. For production inference, users can run TurboQuant through these established engines rather than directly through this repository.

The project serves as the research home for the TurboQuant approach, housing the Python reference implementation, validation papers, and benchmark data. Development activity shows a focus on upstreaming stable, well-tested components as small, reviewable patches to major inference frameworks rather than maintaining a monolithic implementation. The README documents getting started guidance, configuration recommendations, and benchmark results, indicating sustained attention to practical usability. The project's approach of contributing validated findings incrementally to upstream projects suggests a collaborative development model oriented toward broad adoption of the compression techniques.