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 ↓

Summary Information

Updated 56 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)

Most active contributors

Sign in to see contributor activity.

Related repositories by overlapping contributors

No overlapping-contributor repos identified yet.

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.