proveKV/CITATION.cff at main · RecursiveIntell/proveKV · GitHub

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
cff-version: 1.2.0
message: "If you reference this measurement in academic work, please cite it as below. The headline numbers are PPL-validated system-level compression ratios at N=8 agents, SmolLM2-1.7B + WikiText-2, ΔPPL = +0.00%. Two baseline denominators: f32-raw KV (36.00× lossless / 68.04× lossy) and fp16-equivalent (18.00× lossless / 34.02× lossy). proveKV does not reduce framework cache bytes directly — it decompresses to f32 and patches the cache. See CLAIMS.json for the per-baseline ratio breakdown and the receipts that justify each number."
type: software
# F7 audit: the title previously said "lossless at 11.13x", which was the
# pool-only lossless ratio from the older `kv-lossless-11x` work. The
# current default is two-tier (pool + per-agent shells) at the b=4
# default: 36.00x lossless / 68.04x lossy vs f32-raw KV, both
# PPL-validated on SmolLM2-1.7B + WikiText-2 with delta_ppl_pct = +0.00%
# (msi 2026-06-03, post-audit binary acf6424). fp16-equivalent baseline
# gives 18.00x / 34.02x (half the f32 number, since compressed bytes are
# dtype-agnostic).
title: "proveKV: a two-tier, receipted, content-addressed KV-cache pool for multi-agent LLM systems — 36.00x lossless / 68.04x lossy PPL-validated at N=8 (vs f32-raw KV; 18.00x / 34.02x vs fp16-equivalent)"
version: 1.1.0
date-released: 2026-06-03
license: MIT
authors:
  - family-names: Stevenson
    given-names: Josh
    alias: sikmindz
    affiliation: RecursiveIntell
references:
  - type: article
    title: "FibQuant: Universal Vector Quantization for Random-Access KV-Cache Compression"
    authors:
      - family-names: Lee
        given-names: Namyoon
      - family-names: Kim
        given-names: Yongjune
    year: 2026
    month: 5
    identifier: "arXiv:2605.11478"
    url: "https://arxiv.org/abs/2605.11478"
  - type: software
    # F7 audit: the previous version pointed to RecursiveIntill/Libraries
    # (typo) and the fib-quant path inside it. The codec actually lives
    # in this same repo as a workspace member.
    title: "fib-quant: clean-room Rust port of the FibQuant codec (workspace member of proveKV)"
    version: "0.1.0-beta.1"
    url: "https://github.com/RecursiveIntell/proveKV/tree/main/fib-quant"