ConorWang commited on
Commit
33aaccf
·
verified ·
1 Parent(s): 6b0f211

Upload 3 files

Browse files
Files changed (3) hide show
  1. QUANTIZATION_QUALITY.md +220 -667
  2. README.md +164 -471
  3. RELEASE_MANIFEST.json +300 -8
QUANTIZATION_QUALITY.md CHANGED
@@ -6,758 +6,311 @@
6
  **Architecture:** `Qwen3_5ForConditionalGeneration`
7
  **Runtime:** llama.cpp
8
  **Reference precision:** BF16
9
- **Released measured quantization:** Q8_0, Q6_K, Q5_K_M
10
- **Measured release candidate:** Q4_K_M
11
- **Formal parent-model benchmark re-run per quant:** No
12
 
13
- > This document separates **model capability** from **quantization fidelity**. Parent-model benchmarks establish VeriLoop E2 capability; the measurements below quantify how closely each GGUF precision tier preserves the canonical BF16 reference under a frozen paired protocol.
14
 
15
- ---
16
 
17
- ## 1. Precision Matrix
18
 
19
- | Tier | Role | Main file | Main size | Effective density | Fixed-protocol PPL | Mean KLD vs BF16 | Same top-p | Quality state |
20
- |---|---|---|---:|---:|---:|---:|---:|---|
21
- | **BF16** | Reference fidelity | `VeriLoop-E2-BF16.gguf` | **53.808 GB / 50.113 GiB** | 16-bit-class reference | **4.840423 ± 0.119931** | 0 by definition | 100% reference | **Verified reference** |
22
- | **Q8_0** | High-fidelity local | `VeriLoop-E2-Q8_0.gguf` | **28.596 GB / 26.632 GiB** | **8.50 BPW** | **4.843536 ± 0.120062** | **0.002176 ± 0.000668** | **98.815 ± 0.120%** | **Full release quality PASS** |
23
- | **Q6_K** | **Overall quality / efficiency sweet spot** | `VeriLoop-E2-Q6_K.gguf` | **22.083 GB / 20.566 GiB** | **6.57 BPW** | **4.838514 ± 0.119694** | **0.004409 ± 0.000953** | **98.204 ± 0.147%** | **Full release quality PASS** |
24
- | **Q5_K_M** | **Memory-constrained quality sweet spot** | `VeriLoop-E2-Q5_K_M.gguf` | **20.364 GB / 18.965 GiB** | **6.05 BPW** | **4.861965 ± 0.120630** | **0.006919 ± 0.000945** | **97.251 ± 0.181%** | **Full release quality PASS** |
25
- | **Q4_K_M** | Validated mixed-precision 4-bit-core candidate | `VeriLoop-E2-Q4_K_M.gguf` | **19.651 GB / 18.301 GiB** | **5.84 BPW** | **4.863760 ± 0.120720** | **0.009700 ± 0.001110** | **96.786 ± 0.195%** | **Quantitative QC PASS; runtime/identity pending** |
26
 
27
- ### Positioning
28
 
29
- - **BF16:** canonical reference for reproducibility, attribution, and quantization baselines.
30
- - **Q8_0:** lowest measured distributional drift among released low-bit tiers.
31
- - **Q6_K — overall sweet spot:** **58.96% smaller than BF16** with no detectable PPL degradation under the frozen protocol.
32
- - **Q5_K_M — memory-constrained sweet spot:** **62.16% smaller than BF16** and **7.78% smaller than Q6_K**, with a controlled **+0.4450%** PPL increase.
33
- - **Q4_K_M — validated lower-footprint candidate:** **63.48% smaller than BF16** and only **3.50% smaller than Q5_K_M**; its **+0.4821%** PPL change still passes the frozen gate, but Mean KLD rises to **0.009700** and Same top-p falls to **96.786%**. The measured trade-off therefore does **not** displace Q6_K as the overall sweet spot or Q5_K_M as the memory-constrained sweet spot.
34
 
35
- ## 2. Artifact Identity and State
 
 
 
 
 
 
 
36
 
37
- ### BF16 reference
38
 
39
- | Property | Value |
40
- |---|---|
41
- | Filename | `VeriLoop-E2-BF16.gguf` |
42
- | Exact bytes | **53,808,284,000** |
43
- | Decimal size | **53.808284 GB** |
44
- | Binary size | **50.112870 GiB** |
45
- | SHA256 | `11bf5defde1a256b7582bc34fd2c4a85a61615ed88e7a422dcd24d814ea6d35d` |
46
- | Tensor count | **851** |
47
- | Role | Canonical GGUF reference |
48
- | Status | **Verified** |
49
-
50
- ### Q8_0 main
51
-
52
- | Property | Value |
53
- |---|---|
54
- | Filename | `VeriLoop-E2-Q8_0.gguf` |
55
- | Exact bytes | **28,595,765,600** |
56
- | Decimal size | **28.595766 GB** |
57
- | Binary size | **26.631882 GiB** |
58
- | SHA256 | `6204a47274cfbc0c69c39877fb06615ce842bbab264eea77e2e0a5e3ae2fb8e8` |
59
- | Tensor count | **851** |
60
- | Effective density | **8.50 BPW** |
61
- | Status | **Verified / Release Quality PASS** |
62
-
63
- ### Q8_0 MTP companion
64
-
65
- | Property | Value |
66
- |---|---|
67
- | Filename | `mtp-VeriLoop-E2-Q8_0.gguf` |
68
- | Exact bytes | **3,287,070,240** |
69
- | Binary size | **3.061323 GiB** |
70
- | SHA256 | `b9920ce49c43dc94267a51e986573b1178c2250a7a362093ecade4275792ef8f` |
71
- | Model tensor count | **18** |
72
- | llama.cpp load | **PASS** |
73
- | Speculative-draft smoke | **PASS** |
74
- | Status | **Verified** |
75
-
76
- ### Q6_K main
77
-
78
- | Property | Value |
79
- |---|---|
80
- | Filename | `VeriLoop-E2-Q6_K.gguf` |
81
- | Exact bytes | **22,082,532,096** |
82
- | Decimal size | **22.082532 GB** |
83
- | Binary size | **20.565961 GiB** |
84
- | SHA256 | `15d8f856471c4853f6bf0036b2a517426c6cb30a0313cef58a7f9577fd26fe9e` |
85
- | Tensor count | **851** |
86
- | Effective density | **6.57 BPW** |
87
- | Source | **Direct BF16 → Q6_K** |
88
- | Main structure gate | **PASS** |
89
- | Quantitative quality gate | **PASS** |
90
- | Final stock-runtime gate | **PASS** |
91
- | Remote exact-size verification | **PASS** |
92
- | Status | **Verified / Release Quality PASS** |
93
-
94
- ### Q6_K MTP companion
95
-
96
- | Property | Value |
97
- |---|---|
98
- | Filename | `mtp-VeriLoop-E2-Q6_K.gguf` |
99
- | Exact bytes | **2,008,056,096** |
100
- | Decimal size | **2.008056 GB** |
101
- | Binary size | **1.870148 GiB** |
102
- | SHA256 | `0e7f2dfe254f3a5d195d105832411acc1007fd7bb9ac980fe9aae4a1f290d671` |
103
- | Draft quantization | **Q4_0** |
104
- | Model tensor count | **18** |
105
- | Structure gate | **PASS** |
106
- | Final stock-runtime smoke | **PASS** |
107
- | Status | **Verified** |
108
-
109
- ### Q5_K_M main
110
-
111
- | Property | Value |
112
- |---|---|
113
- | Filename | `VeriLoop-E2-Q5_K_M.gguf` |
114
- | Exact bytes | **20,363,666,176** |
115
- | Decimal size | **20.363666 GB** |
116
- | Binary size | **18.965142 GiB** |
117
- | SHA256 | `f90ec14d7ec8f084a292413ae0e06483c87ab5e1422ddce51f2e3409d8853b61` |
118
- | Tensor count | **851** |
119
- | F32 tensors | **353** |
120
- | Q5_K tensors | **272** |
121
- | Protected Q6_K tensors | **226** |
122
- | Effective density | **6.05 BPW** |
123
- | Source | **Direct BF16 → Q5_K_M** |
124
- | Main structure gate | **PASS** |
125
- | Mixed-precision policy gate | **PASS** |
126
- | Quantitative quality gate | **PASS** |
127
- | Final stock-runtime gate | **PASS** |
128
- | Remote exact-size + LFS-SHA verification | **PASS** |
129
- | Status | **Verified / Release Quality PASS** |
130
-
131
- ### Q5_K_M MTP companion
132
-
133
- | Property | Value |
134
- |---|---|
135
- | Filename | `mtp-VeriLoop-E2-Q5_K_M.gguf` |
136
- | Exact bytes | **2,008,056,096** |
137
- | Decimal size | **2.008056 GB** |
138
- | Binary size | **1.870148 GiB** |
139
- | SHA256 | `0e7f2dfe254f3a5d195d105832411acc1007fd7bb9ac980fe9aae4a1f290d671` |
140
- | Draft quantization | **Q4_0** |
141
- | Model tensor count | **18** |
142
- | Structure gate | **PASS** |
143
- | Final stock-runtime smoke | **PASS** |
144
- | Speculative-draft acceptance | **21 / 30 accepted (0.70000)** |
145
- | Remote exact-size + LFS-SHA verification | **PASS** |
146
- | Status | **Verified** |
147
-
148
- ### Q4_K_M main — release candidate
149
-
150
- | Property | Value |
151
- |---|---|
152
- | Filename | `VeriLoop-E2-Q4_K_M.gguf` |
153
- | Exact bytes | **19,650,634,496** |
154
- | Decimal size | **19.650634 GB** |
155
- | Binary size | **18.301080 GiB** |
156
- | SHA256 | **Pending one-time final release identity** |
157
- | Tensor count | **851** |
158
- | F32 tensors | **353** |
159
- | Q4_K tensors | **64** |
160
- | Q5_K tensors | **208** |
161
- | Q6_K tensors | **226** |
162
- | Effective density | **5.84 BPW** |
163
- | Source | **Direct BF16 → mixed Q4_K_M/Q5_K/Q6_K** |
164
- | Main structure / precision-policy gate | **PASS** |
165
- | Quantitative quality gate | **PASS** |
166
- | Final stock-runtime gate | **Pending** |
167
- | Status | **Release candidate** |
168
-
169
- Q4_K_M is deliberately **not added to the frozen artifact identity set until final stock-runtime validation and one-time release SHA256 are complete**.
170
-
171
- ## 3. Fidelity Summary and Measured Drift
172
-
173
- | Tier | Main size | Size reduction vs BF16 | PPL ratio | Relative PPL change | Mean KLD | Same top-p | Quantitative QC |
174
- |---|---:|---:|---:|---:|---:|---:|---|
175
- | **Q8_0** | **26.631882 GiB** | **46.86%** | **1.000643 ± 0.000754** | **+0.0643%** | **0.002176 ± 0.000668** | **98.815 ± 0.120%** | **PASS** |
176
- | **Q6_K** | **20.565961 GiB** | **58.96%** | **0.999605 ± 0.001222** | **−0.0395% observed; parity within uncertainty** | **0.004409 ± 0.000953** | **98.204 ± 0.147%** | **PASS** |
177
- | **Q5_K_M** | **18.965142 GiB** | **62.16%** | **1.004450 ± 0.001361** | **+0.4450%** | **0.006919 ± 0.000945** | **97.251 ± 0.181%** | **PASS** |
178
- | **Q4_K_M** | **18.301080 GiB** | **63.48%** | **1.004821 ± 0.001722** | **+0.4821%** | **0.009700 ± 0.001110** | **96.786 ± 0.195%** | **PASS** |
179
 
180
- The PPL-change column is a **protocol-specific quantization-fidelity measurement**, not a universal percentage loss in code, mathematics, physics, agentic behavior, or leaderboard score.
181
 
182
- **Pareto interpretation:** Q6_K is the overall sweet spot. Q5_K_M is the memory-constrained sweet spot. Q4_K_M reaches the smallest validated main-file footprint in the current measured ladder, but its additional **3.50%** size reduction versus Q5_K_M comes with materially higher distributional drift, so it is not designated the default sweet spot.
 
 
 
 
 
 
 
183
 
184
- ## 4. BF16 → Q8_0 Fidelity Benchmark
185
 
186
- | Metric | BF16 reference | Q8_0 | Q8_0 drift |
187
- |---|---:|---:|---:|
188
- | Mean PPL | **4.840423 ± 0.119931** | **4.843536 ± 0.120062** | **+0.003113 ± 0.003651** |
189
- | PPL ratio | **1.000000** | **1.000643 ± 0.000754** | **+0.0643% relative** |
190
- | Mean KLD | 0 | **0.002176 ± 0.000668** | lower is better |
191
- | Same top-p | 100% reference | **98.815 ± 0.120%** | 1.185 pp disagreement |
192
- | RMS Δp | 0% reference | **1.251 ± 0.137%** | reported |
193
- | Mean Δp | 0% reference | **−0.007 ± 0.014%** | reported |
194
- | log-PPL correlation | 100% reference | **99.95%** | very high agreement |
195
 
196
- ### Q8_0 KLD distribution
 
 
 
 
 
 
197
 
198
- | Statistic | Q8_0 |
199
- |---|---:|
200
- | Mean | **0.002176 ± 0.000668** |
201
- | Median | **0.000276** |
202
- | 90th percentile | **0.001548** |
203
- | 95th percentile | **0.002856** |
204
- | 99th percentile | **0.009561** |
205
- | 99.9th percentile | **0.201704** |
206
- | Maximum | **4.066900** |
207
 
208
- **Interpretation:** Q8_0 removes **46.86%** of the BF16 main-file footprint while preserving very high distributional agreement. The measured **+0.0643%** PPL change is not a universal benchmark-score loss.
209
 
210
- ---
211
 
212
- ## 5. BF16 → Q6_K Fidelity Benchmark
213
 
214
- | Metric | BF16 reference | Q6_K | Observed result |
215
  |---|---:|---:|---:|
216
- | Mean PPL | **4.840423 ± 0.119931** | **4.838514 ± 0.119694** | **−0.001910 ± 0.005918** |
217
- | PPL ratio | **1.000000** | **0.999605 ± 0.001222** | **−0.0395% observed** |
218
- | Mean KLD | 0 | **0.004409 ± 0.000953** | lower is better |
219
- | Same top-p | 100% reference | **98.204 ± 0.147%** | **1.796 pp disagreement** |
220
- | RMS Δp | 0% reference | **1.929 ± 0.201%** | distributional-noise scale |
221
- | Mean Δp | 0% reference | **−0.032 ± 0.021%** | small directional bias |
222
- | log-PPL correlation | 100% reference | **99.88%** | very high agreement |
223
-
224
- ### Q6_K KLD distribution
225
-
226
- | Statistic | Q6_K |
227
- |---|---:|
228
- | Mean | **0.004409 ± 0.000953** |
229
- | Median | **0.000806** |
230
- | 90th percentile | **0.004379** |
231
- | 95th percentile | **0.007390** |
232
- | 99th percentile | **0.026904** |
233
- | 99.9th percentile | **0.396707** |
234
- | Maximum | **5.531829** |
235
-
236
- ### Q6_K interpretation
237
-
238
- Q6_K reduces the BF16 main-file footprint by **58.96%** and the Q8_0 footprint by **22.78%**.
239
-
240
- Its observed PPL ratio is **0.999605 ± 0.001222**. The point estimate corresponds to **−0.0395%**, but the reported uncertainty spans parity; therefore the evidence-supported conclusion is:
241
 
242
- > **No detectable PPL degradation relative to BF16 under the frozen paired protocol.**
243
 
244
- This is **not** interpreted as evidence that Q6_K improves the parent model.
245
 
246
- ---
 
 
 
 
 
 
 
 
247
 
248
- ## 6. BF16 → Q5_K_M Fidelity Benchmark
249
 
250
- ### Headline fidelity
251
 
252
- | Metric | BF16 reference | Q5_K_M | Observed result |
253
  |---|---:|---:|---:|
254
  | Mean PPL | **4.840423 ± 0.119931** | **4.861965 ± 0.120630** | **+0.021542 ± 0.006609** |
255
- | PPL ratio | **1.000000** | **1.004450 ± 0.001361** | **+0.4450%** |
256
  | Mean KLD | 0 | **0.006919 ± 0.000945** | lower is better |
257
- | Same top-p | 100% reference | **97.251 ± 0.181%** | **2.749 pp disagreement** |
258
- | RMS Δp | 0% reference | **2.490 ± 0.211%** | distributional-noise scale |
259
- | Mean Δp | 0% reference | **−0.127 ± 0.027%** | small negative directional bias |
260
- | log-PPL correlation | 100% reference | **99.85%** | very high agreement |
261
-
262
- ### Q5_K_M KLD distribution
263
 
264
- | Statistic | Q5_K_M |
265
- |---|---:|
266
- | Mean | **0.006919 ± 0.000945** |
267
- | Median | **0.001608** |
268
- | 90th percentile | **0.009937** |
269
- | 95th percentile | **0.016501** |
270
- | 99th percentile | **0.063757** |
271
- | 99.9th percentile | **0.355198** |
272
- | Maximum | **5.220856** |
273
-
274
- ### Q5_K_M token-probability statistics
275
-
276
- | Statistic | Q5_K_M |
277
- |---|---:|
278
- | Mean Δp | **−0.127 ± 0.027%** |
279
- | RMS Δp | **2.490 ± 0.211%** |
280
- | Same top-p | **97.251 ± 0.181%** |
281
- | log-PPL correlation | **99.85%** |
282
 
283
- ### Q5_K_M interpretation
284
 
285
- Q5_K_M reduces the BF16 main-file footprint by **62.16%**, the Q8_0 footprint by **28.79%**, and the Q6_K footprint by **7.78%**.
286
-
287
- The measured PPL ratio is **1.004450 ± 0.001361**, corresponding to an observed **+0.4450%** relative PPL increase. Unlike Q6_K, this tier shows a measurable fidelity cost; the release decision therefore depends on whether that controlled drift is justified by the lower footprint.
288
-
289
- The tier passes all of its **predeclared frozen gates** without relaxing thresholds:
290
-
291
- - PPL ratio: **1.004450 ≤ 1.0075 — PASS**
292
- - Mean KLD: **0.006919 ≤ 0.008 — PASS**
293
- - Same top-p: **97.251% ≥ 96.5% — PASS**
294
 
295
- This is the basis for the **Memory-Efficient Quality Sweet Spot** label. It is not a claim that downstream task scores lose exactly 0.4450%.
296
 
297
- ---
298
 
299
- ## 7. BF16 → Q4_K_M Fidelity Benchmark
300
 
301
  ### Headline fidelity
302
 
303
- | Metric | BF16 reference | Q4_K_M | Observed result |
304
  |---|---:|---:|---:|
305
- | Mean PPL | **4.840423 ± 0.119931** | **4.863760 ± 0.120720** | **+0.023337 ± 0.008350** |
306
- | PPL ratio | **1.000000** | **1.004821 ± 0.001722** | **+0.4821%** |
307
- | Mean KLD | 0 | **0.009700 ± 0.001110** | lower is better |
308
- | Same top-p | 100% reference | **96.786 ± 0.195%** | **3.214 pp disagreement** |
309
- | RMS Δp | 0% reference | **2.843 ± 0.155%** | distributional-noise scale |
310
- | Mean Δp | 0% reference | **−0.046 ± 0.031%** | small directional bias |
311
- | log-PPL correlation | 100% reference | **99.76%** | very high agreement |
312
 
313
- ### Q4_K_M KLD distribution
314
 
315
- | Statistic | Q4_K_M |
316
  |---|---:|
317
- | Mean | **0.009700 ± 0.001110** |
318
- | Median | **0.002501** |
319
- | 90th percentile | **0.014517** |
320
- | 95th percentile | **0.025521** |
321
- | 99th percentile | **0.091204** |
322
- | 99.9th percentile | **0.555251** |
323
- | Maximum | **5.794957** |
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
324
 
325
- ### Q4_K_M token-probability statistics
326
-
327
- | Statistic | Q4_K_M |
328
- |---|---:|
329
- | Mean Δp | **−0.046 ± 0.031%** |
330
- | RMS Δp | **2.843 ± 0.155%** |
331
- | Same top-p | **96.786 ± 0.195%** |
332
- | log-PPL correlation | **99.76%** |
333
-
334
- ### Root-cause-guided precision correction
335
-
336
- The first broad Q4 policy placed both `*.ffn_gate.weight` and `*.ffn_up.weight` at Q4_K. It produced **Mean KLD 0.012706**, exceeding the predeclared Q4 gate of **0.0100**, while the PPL-ratio and Same-top-p gates still passed. The candidate was therefore rejected without relaxing thresholds.
337
-
338
- The final V3 policy restores the **64 FFN-gate tensors to Q5_K** while retaining the **64 FFN-up tensors at Q4_K**. Under the unchanged protocol, Mean KLD falls to **0.009700**, PPL ratio is **1.004821**, and Same top-p is **96.786%**. All three predeclared gates pass:
 
 
 
 
 
 
339
 
340
- - PPL ratio: **1.004821 ≤ 1.0100 — PASS**
341
- - Mean KLD: **0.009700 ≤ 0.0100 — PASS**
342
- - Same top-p: **96.786% ≥ 96.0% — PASS**
343
 
344
- ### Q4_K_M interpretation
 
 
345
 
346
- Q4_K_M reduces the BF16 main-file footprint by **63.48%**, the Q8_0 footprint by **31.28%**, the Q6_K footprint by **11.01%**, and the Q5_K_M footprint by **3.50%**.
347
 
348
- The measured **+0.4821%** relative PPL change is a quantization-fidelity result under the frozen paired protocol, not a claim that downstream task scores fall by 0.4821%. The candidate passes quantitative QC, but its final release remains gated on stock-runtime validation and immutable artifact identity.
349
 
350
- The **overall deployment sweet spot remains Q6_K**. Q5_K_M remains the **memory-constrained quality sweet spot**. Q4_K_M is valuable when the final **0.664 GiB** reduction versus Q5_K_M changes deployment feasibility, but the measured KLD/Same-top trade-off does not justify making it the default recommendation.
 
 
 
 
 
 
351
 
352
- ---
353
 
354
- ## 8. Frozen Comparison Protocol
355
 
356
- The same BF16 logits and the same protocol are used across Q8_0, Q6_K, Q5_K_M, and Q4_K_M.
357
 
358
  | Item | Value |
359
  |---|---|
360
- | Reference model | Canonical VeriLoop E2 BF16 GGUF |
361
  | Corpus | WikiText-2 raw test |
362
  | Corpus SHA256 | `173c87a53759e0201f33e0ccf978e510c2042d7f2cb78229d9a50d79b9e7dd08` |
363
- | Context length | **2,048** |
364
  | Chunks | **8** |
365
  | Seed | **42** |
366
  | GPU layers | **40** |
367
  | Flash Attention | **Off** |
368
  | KV cache | **F16/F16** |
369
- | Batch size | **512** |
370
- | Micro-batch size | **512** |
371
- | Evaluation executable | `llama-perplexity` |
 
372
  | BF16 logits reused | **Yes** |
373
- | Reference-logit method | `--kl-divergence-base` |
374
- | Candidate comparison | `--kl-divergence` |
375
- | llama.cpp revision | `42916d83f4a225e56709f873aa8050ac11f5b6a4` |
376
-
377
- The protocol is a **paired quantization-fidelity test**. PPL/KLD numbers from unrelated repositories are not treated as directly comparable unless corpus, tokenizer path, chunking, context, and runtime procedure match.
378
-
379
- ---
380
-
381
- ## 9. Quantization Build Configuration
382
-
383
- ### Q8_0
384
-
385
- | Item | Value |
386
- |---|---|
387
- | Quantization source | Canonical BF16 GGUF |
388
- | Requantized from another low-bit model | **No** |
389
- | Quant type | `Q8_0` |
390
- | Quantized size reported by quantizer | **27,260.56 MiB** |
391
- | Effective density | **8.50 BPW** |
392
- | Main tensors | **851** |
393
- | Q8_0 tensors | **498** |
394
- | Retained F32 tensors | **353** |
395
- | Quantization threads | **25** |
396
- | Quantization time | **38.315 s** |
397
- | Main build gate | **PASS** |
398
- | llama.cpp revision | `42916d83f4a225e56709f873aa8050ac11f5b6a4` |
399
-
400
- ### Q6_K
401
-
402
- | Item | Value |
403
- |---|---|
404
- | Quantization source | Canonical BF16 GGUF |
405
- | Requantized from another low-bit model | **No — direct BF16 → Q6_K** |
406
- | Quant type | `Q6_K` |
407
- | Quantized size reported by quantizer | **21,049.06 MiB** |
408
- | Effective density | **6.57 BPW** |
409
- | Main tensor count | **851** |
410
- | Quantization threads | **25** |
411
- | Quantization time | **67.13647 s** |
412
- | Importance matrix | **496 entries, computed on 582 chunks** |
413
- | Importance-matrix bytes | **13,642,752** |
414
- | Importance-matrix SHA256 | `72d7c3fb0ee839cb591deaa10201fb8e826f1f6b58a6a889f897b02f6381748b` |
415
- | Calibration file | `Qwen3.8-27B-calibration-v6.txt` |
416
- | Main build gate | **PASS** |
417
- | Main structure gate | **PASS** |
418
  | llama.cpp revision | `42916d83f4a225e56709f873aa8050ac11f5b6a4` |
419
 
420
- ### Q5_K_M
421
 
422
- | Item | Value |
423
- |---|---|
424
- | Quantization source | Canonical BF16 GGUF |
425
- | Requantized from another low-bit model | **No — direct BF16 → Q5_K_M** |
426
- | Base quant type | `Q5_K_M` |
427
- | Quantized size reported by quantizer | **19,409.82 MiB** |
428
- | Effective density | **6.05 BPW** |
429
- | Exact bytes | **20,363,666,176** |
430
- | Main tensor count | **851** |
431
- | Retained F32 tensors | **353** |
432
- | Q5_K tensors | **272** |
433
- | Protected Q6_K tensors | **226** |
434
- | Quantization threads | **25** |
435
- | Quantization time | **120.23577 s** |
436
- | Importance matrix | **496 entries, computed on 582 chunks** |
437
- | Importance-matrix bytes | **13,642,752** |
438
- | Importance-matrix SHA256 | `72d7c3fb0ee839cb591deaa10201fb8e826f1f6b58a6a889f897b02f6381748b` |
439
- | Calibration file | `Qwen3.8-27B-calibration-v6.txt` |
440
- | Quality policy | `q5_k_m_quality_v3_q6_attention_logits` |
441
- | Main build gate | **PASS** |
442
- | Main structure gate | **PASS** |
443
- | llama.cpp revision | `42916d83f4a225e56709f873aa8050ac11f5b6a4` |
444
 
445
- Protected Q6_K tensor groups:
446
 
447
- | Tensor group | Count |
448
- |---|---:|
449
- | `output.weight` | **1** |
450
- | `token_embd.weight` | **1** |
451
- | `*.attn_v.weight` | **16** |
452
- | `*.attn_qkv.weight` | **48** |
453
- | `*.attn_output.weight` | **16** |
454
- | `*.ffn_down.weight` | **64** |
455
- | `*.ssm_out.weight` | **48** |
456
- | `*.attn_q.weight` | **16** |
457
- | `*.attn_k.weight` | **16** |
458
- | **Total Q6_K protected tensors** | **226** |
459
-
460
- ### Q4_K_M
461
-
462
- | Item | Value |
463
- |---|---|
464
- | Quantization source | Canonical BF16 GGUF |
465
- | Requantized from another low-bit model | **No — direct BF16 → Q4_K_M** |
466
- | Base quant type | `Q4_K_M` |
467
- | Quantized size reported by quantizer | **18,729.82 MiB** |
468
- | Effective density | **5.84 BPW** |
469
- | Exact bytes | **19,650,634,496** |
470
- | Main tensor count | **851** |
471
- | Retained F32 tensors | **353** |
472
- | Q4_K tensors | **64** |
473
- | Q5_K tensors | **208** |
474
- | Q6_K tensors | **226** |
475
- | Quantization threads | **25** |
476
- | Quantization time | **119.16670 s** |
477
- | Importance matrix | **496 entries, computed on 582 chunks** |
478
- | Importance-matrix bytes | **13,642,752** |
479
- | Importance-matrix SHA256 | `72d7c3fb0ee839cb591deaa10201fb8e826f1f6b58a6a889f897b02f6381748b` |
480
- | Calibration file | `Qwen3.8-27B-calibration-v6.txt` |
481
- | Main build gate | **PASS** |
482
- | Main structure / precision-policy gate | **PASS** |
483
- | llama.cpp revision | `42916d83f4a225e56709f873aa8050ac11f5b6a4` |
484
-
485
- Precision assignment:
486
-
487
- | Tensor group | Precision | Count |
488
- |---|---:|---:|
489
- | `output.weight` | Q6_K | 1 |
490
- | `token_embd.weight` | Q6_K | 1 |
491
- | `*.attn_v.weight` | Q6_K | 16 |
492
- | `*.attn_qkv.weight` | Q6_K | 48 |
493
- | `*.attn_output.weight` | Q6_K | 16 |
494
- | `*.ffn_down.weight` | Q6_K | 64 |
495
- | `*.ssm_out.weight` | Q6_K | 48 |
496
- | `*.attn_q.weight` | Q6_K | 16 |
497
- | `*.attn_k.weight` | Q6_K | 16 |
498
- | `*.attn_gate.weight` | Q5_K | 48 |
499
- | `*.ssm_alpha.weight` | Q5_K | 48 |
500
- | `*.ssm_beta.weight` | Q5_K | 48 |
501
- | `*.ffn_gate.weight` | Q5_K | 64 |
502
- | `*.ffn_up.weight` | Q4_K | 64 |
503
-
504
- ---
505
-
506
- ## 10. Release Gates
507
-
508
- ### Q8_0
509
-
510
- | Gate | Criterion | Measured | Result |
511
- |---|---:|---:|---|
512
- | PPL ratio | ≤ 1.005 | **1.000643** | **PASS** |
513
- | Mean KLD | ≤ 0.005 | **0.002176** | **PASS** |
514
- | Same top-p | ≥ 97.0% | **98.815%** | **PASS** |
515
- | Main tensor count | 851 | **851** | **PASS** |
516
- | Stock llama.cpp load + generation | required | **PASS** | **PASS** |
517
- | MTP load + speculative draft smoke | required | **PASS** | **PASS** |
518
- | Overall release quality | required | **PASS** | **PASS** |
519
-
520
- ### Q6_K
521
-
522
- | Gate | Criterion | Measured | Result |
523
- |---|---:|---:|---|
524
- | BF16 baseline identity | exact frozen reference | **Matched** | **PASS** |
525
- | PPL ratio | ≤ 1.005 | **0.999605** | **PASS** |
526
- | Mean KLD | ≤ 0.006 | **0.004409** | **PASS** |
527
- | Same top-p | ≥ 97.0% | **98.204%** | **PASS** |
528
- | Main tensor count | 851 | **851** | **PASS** |
529
- | Main structure | required | **PASS** | **PASS** |
530
- | MTP structure | required | **PASS** | **PASS** |
531
- | Quantitative quality | required | **PASS** | **PASS** |
532
- | Final stock llama.cpp main runtime | required | **PASS** | **PASS** |
533
- | Final stock llama.cpp MTP smoke | required | **PASS** | **PASS** |
534
- | Final SHA256 / immutable identity | required | **Frozen** | **PASS** |
535
- | Remote exact-size verification | required | **PASS** | **PASS** |
536
- | Overall release quality | required | **PASS** | **PASS** |
537
-
538
- ### Q5_K_M
539
-
540
- | Gate | Criterion | Measured | Result |
541
- |---|---:|---:|---|
542
- | BF16 baseline identity | exact frozen reference | **Matched** | **PASS** |
543
- | PPL ratio | ≤ 1.0075 | **1.004450** | **PASS** |
544
- | Mean KLD | ≤ 0.008 | **0.006919** | **PASS** |
545
- | Same top-p | ≥ 96.5% | **97.251%** | **PASS** |
546
- | Main tensor count | 851 | **851** | **PASS** |
547
- | Mixed-precision protected-path policy | exact declared counts | **Matched** | **PASS** |
548
- | Main structure | required | **PASS** | **PASS** |
549
- | Quantitative quality | required | **PASS** | **PASS** |
550
- | Final stock llama.cpp main runtime | required | **PASS** | **PASS** |
551
- | Final stock llama.cpp MTP smoke | required | **PASS** | **PASS** |
552
- | Final SHA256 / immutable identity | required | **Frozen** | **PASS** |
553
- | Remote exact-size + LFS-SHA verification | required | **PASS** | **PASS** |
554
- | Overall release quality | required | **PASS** | **PASS** |
555
-
556
- ### Q4_K_M
557
-
558
- | Gate | Criterion | Measured | Result |
559
- |---|---:|---:|---|
560
- | BF16 baseline identity | exact frozen reference | **Matched** | **PASS** |
561
- | PPL ratio | ≤ 1.0100 | **1.004821** | **PASS** |
562
- | Mean KLD | ≤ 0.0100 | **0.009700** | **PASS** |
563
- | Same top-p | ≥ 96.0% | **96.786%** | **PASS** |
564
- | Main tensor count | 851 | **851** | **PASS** |
565
- | Mixed-precision policy | exact declared counts | **Matched** | **PASS** |
566
- | Main structure | required | **PASS** | **PASS** |
567
- | Quantitative quality | required | **PASS** | **PASS** |
568
- | Final stock llama.cpp runtime | required before release | **Pending** | **PENDING** |
569
- | Final one-time SHA256 / immutable identity | required before release | **Pending** | **PENDING** |
570
- | Overall release quality | required | **Pending runtime + identity** | **PENDING** |
571
-
572
- These numerical thresholds are **VeriLoop release-QA gates**, not universal industry standards. They were not relaxed after observing Q5_K_M or Q4_K_M results.
573
-
574
- ---
575
-
576
- ## 11. Runtime Validation
577
-
578
- ### BF16
579
-
580
- | Item | Result |
581
- |---|---|
582
- | Main-model conversion | **PASS** |
583
- | Main tensor audit | **851 / PASS** |
584
- | Source-checkpoint immutability gate | **PASS** |
585
- | llama.cpp main-model load | **PASS** |
586
- | OpenAI-compatible endpoint validation | **PASS** |
587
- | Reference runtime context used in initial GGUF release gate | **32,768 tokens** |
588
-
589
- ### Q8_0
590
 
591
  | Item | Result |
592
  |---|---|
593
- | Main Q8_0 load | **PASS** |
594
- | OpenAI-compatible generation | **PASS** |
595
- | Q8 MTP load | **PASS** |
596
- | Speculative-draft path | **PASS** |
597
- | MTP compatibility smoke context | **8,192 tokens** |
598
- | Draft tokens proposed / accepted | **3 / 3** |
599
-
600
- ### Q6_K
601
-
602
- | Item | Result |
603
- |---|---|
604
- | Main build | **PASS** |
605
- | Main structure | **PASS** |
606
- | MTP build / structure | **PASS** |
607
- | BF16-paired quantitative fidelity | **PASS** |
608
- | Stock llama.cpp main-model generation | **PASS** |
609
- | Stock llama.cpp MTP draft smoke | **PASS** |
610
- | Runtime validation context | **8,192 tokens** |
611
- | Main GPU offload | **All model layers** |
612
- | Draft GPU layers | **0 in validated conservative smoke** |
613
- | Final release identity | **Frozen** |
614
-
615
- ### Q5_K_M
616
-
617
- | Item | Result |
618
- |---|---|
619
- | Main build | **PASS** |
620
- | Main structure | **PASS** |
621
- | Protected-path precision audit | **PASS** |
622
- | BF16-paired quantitative fidelity | **PASS** |
623
- | Final stock llama.cpp main-model generation | **PASS** |
624
- | Final stock llama.cpp MTP draft smoke | **PASS** |
625
- | Runtime validation context | **8,192 tokens** |
626
- | Main GPU offload | **All model layers** |
627
- | Draft GPU layers | **0 in validated conservative smoke** |
628
- | Draft tokens accepted / proposed | **21 / 30 (0.70000)** |
629
- | Final release identity | **Frozen** |
630
- | Remote exact-size + LFS-SHA verification | **PASS** |
631
-
632
- ### Q4_K_M
633
-
634
- | Item | Current state |
635
- |---|---|
636
- | Main build | **PASS** |
637
- | Main structure / precision-policy audit | **PASS** |
638
- | BF16-paired quantitative fidelity | **PASS** |
639
- | Final stock llama.cpp main-model generation | **Pending** |
640
- | Final release identity | **Pending** |
641
-
642
- No runtime PASS is claimed before the corresponding smoke is actually executed.
643
-
644
- ---
645
-
646
- ## 12. Size Efficiency
647
-
648
- | Artifact | Exact size | Relative to BF16 main |
649
- |---|---:|---:|
650
- | BF16 main | **50.112870 GiB** | 100% reference |
651
- | Q8_0 main | **26.631882 GiB** | **53.14% of BF16 / 46.86% smaller** |
652
- | Q6_K main | **20.565961 GiB** | **41.04% of BF16 / 58.96% smaller** |
653
- | Q5_K_M main | **18.965142 GiB** | **37.84% of BF16 / 62.16% smaller** |
654
- | Q4_K_M main | **18.301080 GiB** | **36.52% of BF16 / 63.48% smaller** |
655
- | Q6_K vs Q8_0 | — | **22.78% smaller than Q8_0** |
656
- | Q5_K_M vs Q8_0 | — | **28.79% smaller than Q8_0** |
657
- | Q5_K_M vs Q6_K | — | **7.78% smaller than Q6_K** |
658
- | Q4_K_M vs Q8_0 | — | **31.28% smaller than Q8_0** |
659
- | Q4_K_M vs Q6_K | — | **11.01% smaller than Q6_K** |
660
- | Q4_K_M vs Q5_K_M | — | **3.50% smaller than Q5_K_M / 0.664 GiB saved** |
661
-
662
- ## 13. Throughput Status
663
-
664
- A standalone Q8_0 `llama-bench` run produced:
665
 
666
- | Workload | Q8_0 |
667
- |---|---:|
668
- | Prompt processing (`pp512`) | **3102.722776 tok/s** |
669
- | Token generation (`tg128`) | **41.999677 tok/s** |
670
 
671
- No paired BF16→Q8 speedup is claimed because the paired BF16 speed run did not complete under the original full-offload configuration.
 
 
 
672
 
673
- **Q6_K, Q5_K_M, and Q4_K_M do not have a frozen paired speed benchmark in this record, so no speedup percentage is claimed.** This avoids mixing quantization fidelity with hardware-specific throughput.
674
 
675
- ---
676
 
677
- ## 14. Model Capability vs Quantization Fidelity
678
 
679
  ```text
680
  Parent-model benchmark evidence
681
- → establishes VeriLoop E2 capability
682
 
683
  Canonical BF16 GGUF
684
- → establishes the deployment/reference baseline
685
 
686
- BF16 → Q8_0 paired PPL/KLD/token analysis
687
- → establishes Q8_0 quantization fidelity
688
 
689
- BF16 → Q6_K paired PPL/KLD/token analysis
690
- → establishes Q6_K quantization fidelity
691
 
692
- BF16 → Q5_K_M paired PPL/KLD/token analysis
693
- → establishes Q5_K_M quantization fidelity
694
-
695
- BF16 → Q4_K_M paired PPL/KLD/token analysis
696
- → establishes Q4_K_M quantization fidelity
697
  ```
698
 
699
- The full task-benchmark campaign is not repeatedly relabeled as a quant-specific benchmark campaign.
700
-
701
- ---
702
-
703
- ## 15. Precision-Tier Decision Matrix
704
-
705
- | Tier | State | Quality role | BF16-paired fidelity | Recommended use |
706
- |---|---|---|---|---|
707
- | **BF16** | Released | Reference fidelity | Baseline | Reproducibility / reference |
708
- | **Q8_0** | Released | High-fidelity local | **PASS** | Maximum local fidelity |
709
- | **Q6_K** | Released | **Overall quality / efficiency sweet spot** | **PASS** | **Default recommendation when ~20.6 GiB fits** |
710
- | **Q5_K_M** | Released | **Memory-constrained quality sweet spot** | **PASS** | Tighter memory budgets with controlled drift |
711
- | **Q4_K_M** | Release candidate | Validated mixed-precision 4-bit-core tier | **PASS** | Use when the additional **0.664 GiB** saving vs Q5_K_M matters after runtime/identity PASS |
712
- | `IQ4_XS` | Planned | Compact 4-bit class | Pending | Maximum footprint reduction |
713
-
714
- ## 16. Current Decision
715
-
716
- ```text
717
- BF16_REFERENCE_GATE=PASS
718
-
719
- Q8_STRUCTURE_GATE=PASS
720
- Q8_QUANTITATIVE_QUALITY_GATE=PASS
721
- Q8_STOCK_LLAMA_CPP_COMPATIBILITY=PASS
722
- Q8_RELEASE_QUALITY_GATE=PASS
723
-
724
- Q6_BUILD_STAGE=PASS
725
- Q6_STRUCTURE_GATE=PASS
726
- Q6_MTP_STRUCTURE_GATE=PASS
727
- Q6_BF16_BASELINE_IDENTITY_GATE=PASS
728
- Q6_PPL_RATIO_GATE=PASS
729
- Q6_MEAN_KLD_GATE=PASS
730
- Q6_SAME_TOP_P_GATE=PASS
731
- Q6_QUANTITATIVE_QUALITY_GATE=PASS
732
- Q6_FINAL_RUNTIME_GATE=PASS
733
- Q6_FINAL_RELEASE_IDENTITY=PASS
734
- Q6_REMOTE_RELEASE_GATE=PASS
735
-
736
- Q5_BUILD_STAGE=PASS
737
- Q5_STRUCTURE_GATE=PASS
738
- Q5_PROTECTED_PRECISION_POLICY_GATE=PASS
739
- Q5_BF16_BASELINE_IDENTITY_GATE=PASS
740
- Q5_PPL_RATIO_GATE=PASS
741
- Q5_MEAN_KLD_GATE=PASS
742
- Q5_SAME_TOP_P_GATE=PASS
743
- Q5_QUANTITATIVE_QUALITY_GATE=PASS
744
- Q5_FINAL_RUNTIME_GATE=PASS
745
- Q5_FINAL_RELEASE_IDENTITY=PASS
746
- Q5_REMOTE_RELEASE_GATE=PASS
747
-
748
- Q4_V3_BUILD_STAGE=PASS
749
- Q4_V3_STRUCTURE_POLICY_GATE=PASS
750
- Q4_V3_BF16_BASELINE_IDENTITY_GATE=PASS
751
- Q4_V3_PPL_RATIO_GATE=PASS
752
- Q4_V3_MEAN_KLD_GATE=PASS
753
- Q4_V3_SAME_TOP_P_GATE=PASS
754
- Q4_V3_QUANTITATIVE_QUALITY_GATE=PASS
755
- Q4_V3_FINAL_RUNTIME_GATE=PENDING
756
- Q4_V3_FINAL_RELEASE_IDENTITY=PENDING
757
- ```
758
 
759
- **Current evidence-supported conclusion:** **Q6_K is the overall VeriLoop E2 deployment sweet spot.** It is **58.96% smaller than BF16** while showing **no detectable PPL degradation** under the frozen paired protocol, with Mean KLD **0.004409 ± 0.000953** and Same top-p **98.204 ± 0.147%**.
 
 
 
 
 
 
 
760
 
761
- **Q5_K_M is the memory-constrained sweet spot.** It is **62.16% smaller than BF16** and **7.78% smaller than Q6_K**, with measured PPL ratio **1.004450 ± 0.001361 (+0.4450%)**, Mean KLD **0.006919 ± 0.000945**, and Same top-p **97.251 ± 0.181%**; its full runtime, immutable identity, and remote release gates are now PASS.
762
 
763
- **Q4_K_M is quantitatively validated but not the default sweet spot.** It is **63.48% smaller than BF16** and **3.50% smaller than Q5_K_M**, with PPL ratio **1.004821 ± 0.001722 (+0.4821%)**, Mean KLD **0.009700 ± 0.001110**, Same top-p **96.786 ± 0.195%**, and **99.76%** log-PPL correlation. It remains a release candidate until stock-runtime validation and immutable SHA256 identity are complete.
 
6
  **Architecture:** `Qwen3_5ForConditionalGeneration`
7
  **Runtime:** llama.cpp
8
  **Reference precision:** BF16
9
+ **Measured ladder:** Q8_0, Q6_K, Q5_K_M, Q4_K_M, Q3_K_M
10
+ **Parent-model benchmark re-run per quant:** No
 
11
 
12
+ > This document separates **model capability** from **quantization fidelity**. Parent-model benchmarks establish VeriLoop E2 capability. The measurements below quantify how closely each GGUF tier preserves the canonical BF16 reference under one frozen paired protocol.
13
 
14
+ ## 1. Executive decision
15
 
16
+ **Overall sweet spot: Q6_K.** It removes **58.96%** of the BF16 main-file footprint while its PPL result is statistically consistent with BF16 parity; Mean KLD is **0.004409 ± 0.000953** and Same top-p is **98.204 ± 0.147%**.
17
 
18
+ **Memory-constrained quality sweet spot: Q5_K_M.** It is **7.78% smaller than Q6_K** and **62.16% smaller than BF16**, with **+0.4450%** measured PPL drift, Mean KLD **0.006919 ± 0.000945**, and Same top-p **97.251 ± 0.181%**.
 
 
 
 
 
 
19
 
20
+ **Minimum-footprint validated tier: Q3_K_M.** It is **66.42% smaller than BF16**, **11.28% smaller than Q5_K_M**, and **8.06% smaller than Q4_K_M**. It passes both the final Q3 hard gate and the stricter engineering reserve gate, but Mean KLD rises to **0.014349 ± 0.001985** and Same top-p falls to **95.919 ± 0.219%**. It is therefore a footprint-first option, not the default sweet spot.
21
 
22
+ ## 2. Precision matrix
 
 
 
 
23
 
24
+ | Tier | Role | Main size | Effective density | Mean PPL | Mean KLD | Same top-p | State |
25
+ |---|---|---:|---:|---:|---:|---:|---|
26
+ | **BF16** | Reference | **50.112870 GiB** | 16-bit-class | **4.840423 ± 0.119931** | 0 | 100% | Verified reference |
27
+ | **Q8_0** | High fidelity | **26.631882 GiB** | **8.50 BPW** | **4.843536 ± 0.120062** | **0.002176 ± 0.000668** | **98.815 ± 0.120%** | Full release quality PASS |
28
+ | **Q6_K** | **Overall sweet spot** | **20.565961 GiB** | **6.57 BPW** | **4.838514 ± 0.119694** | **0.004409 ± 0.000953** | **98.204 ± 0.147%** | Full release quality PASS |
29
+ | **Q5_K_M** | **Memory-quality sweet spot** | **18.965142 GiB** | **6.05 BPW** | **4.861965 ± 0.120630** | **0.006919 ± 0.000945** | **97.251 ± 0.181%** | Full release quality PASS |
30
+ | **Q4_K_M** | Intermediate mixed-precision candidate | **18.301080 GiB** | **5.84 BPW** | **4.863760 ± 0.120720** | **0.009700 ± 0.001110** | **96.786 ± 0.195%** | Quantitative QC PASS; own runtime/identity pending |
31
+ | **Q3_K_M** | **Minimum-footprint validated tier** | **16.825745 GiB** | **5.37 BPW** | **4.860222 ± 0.120606** | **0.014349 ± 0.001985** | **95.919 ± 0.219%** | **Structure + fidelity + runtime + MTP PASS** |
32
 
33
+ ### Filename semantics for Q3
34
 
35
+ `VeriLoop-E2-Q3_K_M.gguf` is **not a uniform 3-bit artifact**. Its final tensor distribution is **353 F32 + 3 Q3_K + 64 Q4_K + 429 Q5_K + 2 Q6_K = 851 tensors**. Its measured effective density is **5.37 BPW**. The release name denotes the Q3 low-footprint tier / minimum active tensor precision; the manifest records the exact policy so that the artifact is not misrepresented as a stock Q3_K_M preset.
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
36
 
37
+ ## 3. Artifact identity and state
38
 
39
+ | Artifact | Exact bytes | GiB | SHA256 / identity | Current state |
40
+ |---|---:|---:|---|---|
41
+ | `VeriLoop-E2-BF16.gguf` | **53,808,284,000** | **50.112870** | `11bf5defde1a256b7582bc34fd2c4a85a61615ed88e7a422dcd24d814ea6d35d` | Verified reference |
42
+ | `VeriLoop-E2-Q8_0.gguf` | **28,595,765,600** | **26.631882** | `6204a47274cfbc0c69c39877fb06615ce842bbab264eea77e2e0a5e3ae2fb8e8` | Verified |
43
+ | `VeriLoop-E2-Q6_K.gguf` | **22,082,532,096** | **20.565961** | `15d8f856471c4853f6bf0036b2a517426c6cb30a0313cef58a7f9577fd26fe9e` | Verified |
44
+ | `VeriLoop-E2-Q5_K_M.gguf` | **20,363,666,176** | **18.965142** | `f90ec14d7ec8f084a292413ae0e06483c87ab5e1422ddce51f2e3409d8853b61` | Verified |
45
+ | `VeriLoop-E2-Q4_K_M.gguf` | **19,650,634,496** | **18.301080** | Not frozen in the supplied Q4 record | Quantitative candidate |
46
+ | `VeriLoop-E2-Q3_K_M.gguf` | **18,066,506,496** | **16.825745** | `c2e9539cfb85d87a99605b6914ed602c0fa750164c153ce5574710123aba06fe` | **Verified release; stock runtime + MTP + remote identity PASS** |
47
 
48
+ The Q3 Hugging Face release is treated as **fully verified** in this release record: the published main artifact is bound to the frozen local identity (**18,066,506,496 bytes**, SHA256 `c2e9539cfb85d87a99605b6914ed602c0fa750164c153ce5574710123aba06fe`) and the remote release state is **PASS** for exact-size, full-SHA256, and readability verification.
49
 
50
+ ## 4. Fidelity summary and measured drift
 
 
 
 
 
 
 
 
51
 
52
+ | Tier | Size reduction vs BF16 | PPL ratio | Relative PPL change | Mean KLD | Same top-p | Top-token disagreement | Quantitative state |
53
+ |---|---:|---:|---:|---:|---:|---:|---|
54
+ | **Q8_0** | **46.86%** | **1.000643 ± 0.000754** | **+0.0643%** | **0.002176 ± 0.000668** | **98.815 ± 0.120%** | **1.185 pp** | PASS |
55
+ | **Q6_K** | **58.96%** | **0.999605 ± 0.001222** | **−0.0395% observed; parity within uncertainty** | **0.004409 ± 0.000953** | **98.204 ± 0.147%** | **1.796 pp** | PASS |
56
+ | **Q5_K_M** | **62.16%** | **1.004450 ± 0.001361** | **+0.4450%** | **0.006919 ± 0.000945** | **97.251 ± 0.181%** | **2.749 pp** | PASS |
57
+ | **Q4_K_M** | **63.48%** | **1.004821 ± 0.001722** | **+0.4821%** | **0.009700 ± 0.001110** | **96.786 ± 0.195%** | **3.214 pp** | PASS |
58
+ | **Q3_K_M** | **66.42%** | **1.004090 ± 0.002181** | **+0.4090%** | **0.014349 ± 0.001985** | **95.919 ± 0.219%** | **4.081 pp** | **PASS** |
59
 
60
+ **Performance-loss boundary.** The PPL-change column is a **protocol-specific quantization-retention measurement**. It is not a universal percentage loss in code, software engineering, mathematics, physics, agentic behavior, or leaderboard score. The parent nine-benchmark campaign was **not rerun independently for each quant tier**, so quant-specific SWE-bench/AIME/GPQA/etc. deltas are not claimed.
 
 
 
 
 
 
 
 
61
 
62
+ ### Why PPL alone is insufficient for Q3
63
 
64
+ Q3's PPL ratio (**1.004090**) is numerically close to Q5/Q4 and its point estimate is even lower than Q4's, but that does **not** imply superior overall retention. Under the same paired logits, Q3 Mean KLD is **0.014349** versus **0.006919** for Q5 and **0.009700** for Q4, while Same top-p falls to **95.919%**. The release decision therefore uses the full multi-metric gate rather than optimizing a single PPL number.
65
 
66
+ ## 5. Q8_0 retention record
67
 
68
+ | Metric | BF16 | Q8_0 | Observed drift |
69
  |---|---:|---:|---:|
70
+ | Mean PPL | **4.840423 ± 0.119931** | **4.843536 ± 0.120062** | **+0.003113 ± 0.003651** |
71
+ | PPL ratio | 1.000000 | **1.000643 ± 0.000754** | **+0.0643%** |
72
+ | Mean KLD | 0 | **0.002176 ± 0.000668** | lower is better |
73
+ | Same top-p | 100% | **98.815 ± 0.120%** | 1.185 pp disagreement |
74
+ | RMS Δp | 0 | **1.251 ± 0.137%** | distributional-noise scale |
75
+ | Mean Δp | 0 | **−0.007 ± 0.014%** | near-zero directional bias |
76
+ | log-PPL correlation | 100% | **99.95%** | very high agreement |
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
77
 
78
+ KLD distribution: median **0.000276**, p90 **0.001548**, p95 **0.002856**, p99 **0.009561**, p99.9 **0.201704**, max **4.066900**.
79
 
80
+ ## 6. Q6_K retention record
81
 
82
+ | Metric | BF16 | Q6_K | Observed result |
83
+ |---|---:|---:|---:|
84
+ | Mean PPL | **4.840423 ± 0.119931** | **4.838514 ± 0.119694** | **−0.001910 ± 0.005918** |
85
+ | PPL ratio | 1.000000 | **0.999605 ± 0.001222** | **−0.0395% observed; parity within uncertainty** |
86
+ | Mean KLD | 0 | **0.004409 ± 0.000953** | lower is better |
87
+ | Same top-p | 100% | **98.204 ± 0.147%** | 1.796 pp disagreement |
88
+ | RMS Δp | 0 | **1.929 ± 0.201%** | distributional-noise scale |
89
+ | Mean Δp | 0 | **−0.032 ± 0.021%** | small directional bias |
90
+ | log-PPL correlation | 100% | **99.88%** | very high agreement |
91
 
92
+ KLD distribution: median **0.000806**, p90 **0.004379**, p95 **0.007390**, p99 **0.026904**, p99.9 **0.396707**, max **5.531829**.
93
 
94
+ ## 7. Q5_K_M retention record
95
 
96
+ | Metric | BF16 | Q5_K_M | Observed result |
97
  |---|---:|---:|---:|
98
  | Mean PPL | **4.840423 ± 0.119931** | **4.861965 ± 0.120630** | **+0.021542 ± 0.006609** |
99
+ | PPL ratio | 1.000000 | **1.004450 ± 0.001361** | **+0.4450%** |
100
  | Mean KLD | 0 | **0.006919 ± 0.000945** | lower is better |
101
+ | Same top-p | 100% | **97.251 ± 0.181%** | 2.749 pp disagreement |
102
+ | RMS Δp | 0 | **2.490 ± 0.211%** | distributional-noise scale |
103
+ | Mean Δp | 0 | **−0.127 ± 0.027%** | small negative directional bias |
104
+ | log-PPL correlation | 100% | **99.85%** | very high agreement |
 
 
105
 
106
+ KLD distribution: median **0.001608**, p90 **0.009937**, p95 **0.016501**, p99 **0.063757**, p99.9 **0.355198**, max **5.220856**.
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
107
 
108
+ ## 8. Q4_K_M retention record
109
 
110
+ | Metric | BF16 | Q4_K_M | Observed result |
111
+ |---|---:|---:|---:|
112
+ | Mean PPL | **4.840423 ± 0.119931** | **4.863760 ± 0.120720** | **+0.023337 ± 0.008350** |
113
+ | PPL ratio | 1.000000 | **1.004821 ± 0.001722** | **+0.4821%** |
114
+ | Mean KLD | 0 | **0.009700 ± 0.001110** | lower is better |
115
+ | Same top-p | 100% | **96.786 ± 0.195%** | 3.214 pp disagreement |
116
+ | RMS Δp | 0 | **2.843 ± 0.155%** | distributional-noise scale |
117
+ | Mean Δp | 0 | **−0.046 ± 0.031%** | small directional bias |
118
+ | log-PPL correlation | 100% | **99.76%** | very high agreement |
119
 
120
+ KLD distribution: median **0.002501**, p90 **0.014517**, p95 **0.025521**, p99 **0.091204**, p99.9 **0.555251**, max **5.794957**.
121
 
122
+ The first broader Q4 policy produced Mean KLD **0.012706**, above the Q4 gate of **0.0100**. Restoring the 64 FFN-gate tensors to Q5_K reduced final Mean KLD to **0.009700**; the gate was not relaxed.
123
 
124
+ ## 9. Q3_K_M retention record
125
 
126
  ### Headline fidelity
127
 
128
+ | Metric | BF16 | Q3_K_M | Observed result |
129
  |---|---:|---:|---:|
130
+ | Mean PPL | **4.840423 ± 0.119931** | **4.860222 ± 0.120606** | **+0.019799 ± 0.010554** |
131
+ | PPL ratio | 1.000000 | **1.004090 ± 0.002181** | **+0.4090%** |
132
+ | Mean KLD | 0 | **0.014349 ± 0.001985** | lower is better |
133
+ | Same top-p | 100% | **95.919 ± 0.219%** | **4.081 pp disagreement** |
134
+ | RMS Δp | 0 | **3.515 ± 0.228%** | distributional-noise scale |
135
+ | Mean Δp | 0 | **−0.065 ± 0.039%** | small directional bias |
136
+ | log-PPL correlation | 100% | **99.62%** | high agreement |
137
 
138
+ ### Q3 KLD distribution
139
 
140
+ | Statistic | Q3_K_M |
141
  |---|---:|
142
+ | Mean | **0.014349 ± 0.001985** |
143
+ | Median | **0.003572** |
144
+ | 90th percentile | **0.022146** |
145
+ | 95th percentile | **0.038350** |
146
+ | 99th percentile | **0.123439** |
147
+ | 99.9th percentile | **0.664245** |
148
+ | Maximum | **13.526417** |
149
+
150
+ ### Root-cause development record
151
+
152
+ | Stage | Policy change | PPL ratio | Mean KLD | Same top-p | Decision |
153
+ |---|---|---:|---:|---:|---|
154
+ | Broad Q3 V1 | Internal Q6→Q5 + all 64 FFN-up Q4→Q3 | **1.017999** | **0.029363** | **93.438%** | FAIL |
155
+ | Root-cause arm A | FFN-up Q4→Q3 only | **1.015596** | **0.026060** | **93.976%** | FAIL; dominant single-variable cause |
156
+ | Root-cause arm B | Internal protected Q6→Q5; no Q3 tensors | **1.007813** | **0.013292** | **96.065%** | PASS under Q3 hard gate; safe baseline |
157
+ | FFN-down family screen | All 64 FFN-down Q5→Q3 | **1.012324** | **0.032745** | **93.341%** | FAIL |
158
+ | QKV family screen | All 48 recurrent QKV Q5→Q3 | **1.018700** | **0.026723** | **94.086%** | FAIL |
159
+ | 33-tensor low-sensitivity shortlist | 13 FFN-down + 13 FFN-up + 7 QKV at Q3 | **1.002662** | **0.018066** | **95.528%** | FAIL on KLD |
160
+ | **Final KL-guard policy** | **Only 3 lowest-sensitivity FFN-down tensors at Q3** | **1.004090** | **0.014349** | **95.919%** | **PASS hard + reserve gates** |
161
+
162
+ This sequence establishes why the final Q3 artifact is intentionally conservative. The failed candidates were rejected without relaxing the fidelity threshold; the final policy was selected after KLD became the binding constraint.
163
+
164
+ ### Q3 exact build configuration
165
 
166
+ | Item | Value |
167
+ |---|---|
168
+ | Quantization source | Canonical BF16 GGUF |
169
+ | Requantized from another low-bit model | **No** |
170
+ | Base quant invocation | `Q4_K_M` with exact per-tensor overrides |
171
+ | Effective density | **5.37 BPW** |
172
+ | Quantized size reported by quantizer | **17,219.08 MiB** |
173
+ | Exact bytes | **18,066,506,496** |
174
+ | Quantization time | **166.77453 s** |
175
+ | Quantization threads | **25** |
176
+ | Importance matrix | **496 entries / 582 chunks** |
177
+ | Importance-matrix SHA256 | `72d7c3fb0ee839cb591deaa10201fb8e826f1f6b58a6a889f897b02f6381748b` |
178
+ | llama.cpp revision | `42916d83f4a225e56709f873aa8050ac11f5b6a4` |
179
+ | F32 | **353** |
180
+ | Q3_K | **3** |
181
+ | Q4_K | **64** |
182
+ | Q5_K | **429** |
183
+ | Q6_K | **2** |
184
+ | Structure mismatch count | **0** |
185
+ | Main SHA256 | `c2e9539cfb85d87a99605b6914ed602c0fa750164c153ce5574710123aba06fe` |
186
 
187
+ Exact Q3 tensors:
 
 
188
 
189
+ - `blk.1.ffn_down.weight`
190
+ - `blk.0.ffn_down.weight`
191
+ - `blk.3.ffn_down.weight`
192
 
193
+ All 64 `*.ffn_up.weight` tensors remain Q4_K; the remaining 429 quantized internal tensors are Q5_K; output and token embedding are Q6_K.
194
 
195
+ ### Q3 final gates
196
 
197
+ | Gate | Hard threshold | Engineering reserve | Measured | Result |
198
+ |---|---:|---:|---:|---|
199
+ | PPL ratio | ≤ 1.0150 | ≤ 1.0135 | **1.004090** | **PASS / PASS** |
200
+ | Mean KLD | ≤ 0.0150 | ≤ 0.0145 | **0.014349** | **PASS / PASS** |
201
+ | Same top-p | ≥ 95.0% | ≥ 95.5% | **95.919%** | **PASS / PASS** |
202
+ | Tensor count | 851 | 851 | **851** | **PASS** |
203
+ | Tensor policy | exact | exact | **353/3/64/429/2** | **PASS** |
204
 
205
+ Reserve headroom after measurement: PPL ratio **0.009410**, Mean KLD **0.000151**, Same top-p **0.419 pp**. The small KLD reserve is why no further Q3 expansion is claimed safe.
206
 
207
+ ## 10. Frozen comparison protocol
208
 
209
+ The same BF16 logits and protocol are used across Q8_0, Q6_K, Q5_K_M, Q4_K_M, and Q3_K_M.
210
 
211
  | Item | Value |
212
  |---|---|
 
213
  | Corpus | WikiText-2 raw test |
214
  | Corpus SHA256 | `173c87a53759e0201f33e0ccf978e510c2042d7f2cb78229d9a50d79b9e7dd08` |
215
+ | Context | **2,048** |
216
  | Chunks | **8** |
217
  | Seed | **42** |
218
  | GPU layers | **40** |
219
  | Flash Attention | **Off** |
220
  | KV cache | **F16/F16** |
221
+ | Batch / micro-batch | **512 / 512** |
222
+ | Evaluator | `llama-perplexity` |
223
+ | Reference method | `--kl-divergence-base` |
224
+ | Candidate method | `--kl-divergence` |
225
  | BF16 logits reused | **Yes** |
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
226
  | llama.cpp revision | `42916d83f4a225e56709f873aa8050ac11f5b6a4` |
227
 
228
+ ## 11. Release gates
229
 
230
+ | Tier | PPL gate | KLD gate | Same-top gate | Structure | Stock runtime | Quantitative result |
231
+ |---|---|---|---|---|---|---|
232
+ | Q8_0 | ≤1.005 → **1.000643 PASS** | ≤0.005 → **0.002176 PASS** | ≥97.0 → **98.815 PASS** | PASS | PASS | PASS |
233
+ | Q6_K | ≤1.005 → **0.999605 PASS** | ≤0.006 → **0.004409 PASS** | ≥97.0 → **98.204 PASS** | PASS | PASS | PASS |
234
+ | Q5_K_M | ≤1.0075 → **1.004450 PASS** | ≤0.008 → **0.006919 PASS** | ≥96.5 → **97.251 PASS** | PASS | PASS | PASS |
235
+ | Q4_K_M | ≤1.010 → **1.004821 PASS** | ≤0.010 → **0.009700 PASS** | ≥96.0 → **96.786 PASS** | PASS | Pending in supplied record | PASS quantitative |
236
+ | **Q3_K_M** | ≤1.015 → **1.004090 PASS** | ≤0.015 → **0.014349 PASS** | ≥95.0 → **95.919 PASS** | **PASS** | **PASS** | **PASS** |
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
237
 
238
+ These thresholds are **VeriLoop release-QA criteria**, not universal industry standards. For Q3, the final run also passed the stricter reserve thresholds shown above.
239
 
240
+ ## 12. Q3 stock-runtime and MTP validation
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
241
 
242
  | Item | Result |
243
  |---|---|
244
+ | Stock llama.cpp main-only load | **PASS** |
245
+ | Main-only generation | **PASS** |
246
+ | MTP interface detection (`--model-draft`) | **PASS** |
247
+ | MTP GPU-offload interface (`--gpu-layers-draft`) | **PASS** |
248
+ | Current speculative limit flag (`--spec-draft-n-max 8`) | **PASS** |
249
+ | Main + MTP load | **PASS** |
250
+ | Main + MTP generation | **PASS** |
251
+ | MTP engagement log evidence | **PASS** |
252
+ | Greedy target-output identity | **PASS** |
253
+ | Main-only text SHA256 | `43944ea63376bab89382150a3e4fbcb3739901c82e791abfa7847c13df0391a9` |
254
+ | Main+MTP text SHA256 | `43944ea63376bab89382150a3e4fbcb3739901c82e791abfa7847c13df0391a9` |
255
+ | Runtime validation context | **2,048** |
256
+ | Validated MTP bytes | **2,008,056,096** |
257
+ | Validated MTP SHA256 | `0e7f2dfe254f3a5d195d105832411acc1007fd7bb9ac980fe9aae4a1f290d671` |
258
+ | Overall Q3 runtime/MTP gate | **PASS** |
259
+
260
+ The validated MTP object is byte-identical to the existing Q5/Q6 18-tensor Q4_0 companion. This avoids publishing a duplicate binary solely to change its filename.
261
+
262
+ ## 13. Size efficiency
263
+
264
+ | Artifact | GiB | Smaller than BF16 | Marginal size reduction |
265
+ |---|---:|---:|---|
266
+ | BF16 | **50.112870** | — | — |
267
+ | Q8_0 | **26.631882** | **46.86%** | — |
268
+ | Q6_K | **20.565961** | **58.96%** | **22.78% vs Q8** |
269
+ | Q5_K_M | **18.965142** | **62.16%** | **7.78% vs Q6** |
270
+ | Q4_K_M | **18.301080** | **63.48%** | **3.50% vs Q5 / 0.664 GiB** |
271
+ | **Q3_K_M** | **16.825745** | **66.42%** | **8.06% vs Q4 / 11.28% vs Q5 / 18.19% vs Q6** |
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
272
 
273
+ ### Pareto interpretation
 
 
 
274
 
275
+ - **Q6_K** is the strongest overall balance because its large BF16 footprint reduction is achieved without detectable PPL degradation and with low distributional drift.
276
+ - **Q5_K_M** is the best measured step down when memory matters: the extra **7.78%** saving versus Q6 costs a controlled amount of divergence.
277
+ - **Q4_K_M** saves only **3.50%** beyond Q5 while KLD increases to **0.009700**; it is an intermediate candidate rather than a new sweet spot.
278
+ - **Q3_K_M** materially reduces footprint again, but KLD reaches **0.014349** and the reserve margin becomes narrow. It is best understood as the **validated lower-footprint floor of the current ladder**, not the balance optimum.
279
 
280
+ ## 14. Throughput status
281
 
282
+ A standalone Q8_0 `llama-bench` run recorded **3102.722776 tok/s** prompt processing (`pp512`) and **41.999677 tok/s** token generation (`tg128`). There is no frozen paired BF16 throughput result. Q6/Q5/Q4/Q3 do not have a frozen paired speed benchmark in this record, so **no universal speedup percentage is claimed**.
283
 
284
+ ## 15. Model capability vs quantization fidelity
285
 
286
  ```text
287
  Parent-model benchmark evidence
288
+ -> establishes VeriLoop E2 capability
289
 
290
  Canonical BF16 GGUF
291
+ -> establishes the deployment/reference baseline
292
 
293
+ BF16-paired PPL / KLD / token analysis
294
+ -> establishes quantization fidelity for each GGUF tier
295
 
296
+ Stock llama.cpp runtime + MTP validation
297
+ -> establishes runtime compatibility for the tested artifact
298
 
299
+ No per-quant downstream task rerun
300
+ -> no quant-specific SWE/AIME/GPQA score-loss percentage is claimed
 
 
 
301
  ```
302
 
303
+ ## 16. Precision-tier decision matrix
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
304
 
305
+ | Tier | Quality role | Main file | Recommendation |
306
+ |---|---|---:|---|
307
+ | BF16 | Reference | 50.113 GiB | Research / reproducibility |
308
+ | Q8_0 | High fidelity | 26.632 GiB | Use when fidelity dominates footprint |
309
+ | **Q6_K** | **Overall sweet spot** | **20.566 GiB** | **Default** |
310
+ | **Q5_K_M** | **Memory-quality sweet spot** | **18.965 GiB** | **Use when Q6 footprint is too high** |
311
+ | Q4_K_M | Intermediate candidate | 18.301 GiB | Lower drift than Q3, but its own final runtime/identity is pending in this supplied record |
312
+ | **Q3_K_M** | **Minimum-footprint validated** | **16.826 GiB** | **Use when footprint is the dominant constraint and higher distributional drift is acceptable** |
313
 
314
+ ## 17. Current evidence-supported conclusion
315
 
316
+ **Q6_K remains the overall VeriLoop E2 GGUF sweet spot. Q5_K_M remains the memory-constrained quality sweet spot. Q3_K_M is the current minimum-footprint validated tier and the lower bound of the present release ladder, but it is not promoted to the default sweet spot because its KLD and top-token disagreement consume substantially more of the fidelity budget.**
README.md CHANGED
@@ -14,6 +14,8 @@ tags:
14
  - q6_k
15
  - q5_k_m
16
  - q4_k_m
 
 
17
  - imatrix
18
  - mtp
19
  - speculative-decoding
@@ -35,7 +37,7 @@ tags:
35
 
36
  <p align="center">
37
  <strong>Official llama.cpp distribution of VeriLoop E2</strong><br>
38
- <em>BF16 reference · Q8_0 high fidelity · Q6_K overall sweet spot · Q5_K_M memory-efficient quality · Q4_K_M validated 4-bit-core candidate</em><br><br>
39
  <strong>27B post-trained model for code, mathematics, and physics · 262K native context · Apache License 2.0</strong><br>
40
  <strong>Developed by Tsinghua SIGS Robot Lab · Libo Wang</strong>
41
  </p>
@@ -43,12 +45,10 @@ tags:
43
  <p align="center">
44
  <a href="https://www.apache.org/licenses/LICENSE-2.0"><img src="https://img.shields.io/badge/License-Apache--2.0-2F80ED?style=flat-square" alt="License: Apache 2.0"></a>
45
  <img src="https://img.shields.io/badge/Format-GGUF-111827?style=flat-square" alt="Format: GGUF">
46
- <img src="https://img.shields.io/badge/Reference-BF16-5B5BD6?style=flat-square" alt="Reference: BF16">
47
  <img src="https://img.shields.io/badge/Q8__0-High--Fidelity-7C3AED?style=flat-square" alt="Q8_0: High Fidelity">
48
- <img src="https://img.shields.io/badge/Q6__K-Quality%2FEfficiency-0A7F6F?style=flat-square" alt="Q6_K: Quality/Efficiency">
49
- <img src="https://img.shields.io/badge/Q5__K__M-Memory--Efficient%20Quality-0F766E?style=flat-square" alt="Q5_K_M: Memory-Efficient Quality">
50
- <img src="https://img.shields.io/badge/Q4__K__M-4--bit--core%20Candidate-64748B?style=flat-square" alt="Q4_K_M: validated 4-bit-core release candidate">
51
- <img src="https://img.shields.io/badge/Quant%20QC-Q8%2FQ6%2FQ5%2FQ4%20PASS-16A34A?style=flat-square" alt="Quantization QC: Q8 Q6 Q5 Q4 PASS">
52
  <img src="https://img.shields.io/badge/Runtime-llama.cpp-0A7F6F?style=flat-square" alt="Runtime: llama.cpp">
53
  </p>
54
 
@@ -61,384 +61,152 @@ tags:
61
 
62
  ---
63
 
64
- ## Overview
65
 
66
- **VeriLoop E2 GGUF** is the official llama.cpp-oriented distribution of **VeriLoop E2**, a 27B post-trained model built on **Qwen3.8-27B** for code, software engineering, mathematics, and physics.
 
 
 
 
 
 
67
 
68
- The release follows a **reference-first, measurement-driven precision ladder**. Every measured low-bit tier is built directly from the canonical BF16 GGUF rather than requantized from another low-bit artifact, then evaluated against the same frozen BF16 logit reference.
69
 
70
- ### Precision ladder and deployment sweet spots
71
 
72
- | Tier | Role | Main size | BF16 footprint reduction | Measured BF16-paired fidelity | Release state |
73
- |---|---|---:|---:|---|---|
74
- | **BF16** | Reference fidelity | **53.808 GB / 50.113 GiB** | — | Canonical reference | **Released / verified** |
75
- | **Q8_0** | High-fidelity local | **28.596 GB / 26.632 GiB** | **46.86%** | PPL **+0.0643%**, Mean KLD **0.002176**, Same top-p **98.815%** | **Released / verified** |
76
- | **Q6_K** | **Overall quality / efficiency sweet spot** | **22.083 GB / 20.566 GiB** | **58.96%** | **No detectable PPL degradation**, Mean KLD **0.004409**, Same top-p **98.204%** | **Released / verified** |
77
- | **Q5_K_M** | **Memory-constrained quality sweet spot** | **20.364 GB / 18.965 GiB** | **62.16%** | PPL **+0.4450%**, Mean KLD **0.006919**, Same top-p **97.251%** | **Released / verified** |
78
- | **Q4_K_M** | Validated mixed-precision 4-bit-core candidate | **19.651 GB / 18.301 GiB** | **63.48%** | PPL **+0.4821%**, Mean KLD **0.009700**, Same top-p **96.786%** | **Quantitative QC PASS; runtime/identity pending** |
79
 
80
- **Deployment recommendation.** On the measured Pareto frontier, **Q6_K is the overall sweet spot**: it removes **58.96%** of the BF16 main-file footprint while showing no detectable PPL degradation under the frozen paired protocol. **Q5_K_M is the memory-constrained sweet spot** when saving an additional **7.78%** versus Q6_K materially changes fit. Q4_K_M passes its frozen quantitative gates, but it saves only **3.50%** versus Q5_K_M while Mean KLD rises from **0.006919** to **0.009700** and Same top-p decreases from **97.251%** to **96.786%**; it is therefore positioned as a validated 4-bit-core candidate rather than the default recommendation.
 
 
 
 
 
 
 
81
 
82
- These measurements quantify **quantization fidelity under one fixed paired protocol**. They are not universal percentages of downstream code, mathematics, physics, or agent-benchmark capability loss.
83
 
84
- ## Headline Quantization-Retention Benchmark
85
 
86
- | Tier | Mean PPL | PPL ratio vs BF16 | Observed PPL change | Mean KLD | Same top-p | log-PPL correlation |
87
  |---|---:|---:|---:|---:|---:|---:|
88
- | **BF16** | **4.840423 ± 0.119931** | 1.000000 reference | — | 0 reference | 100% reference | 100% reference |
89
  | **Q8_0** | **4.843536 ± 0.120062** | **1.000643 ± 0.000754** | **+0.0643%** | **0.002176 ± 0.000668** | **98.815 ± 0.120%** | **99.95%** |
90
  | **Q6_K** | **4.838514 ± 0.119694** | **0.999605 ± 0.001222** | **−0.0395% observed; parity within uncertainty** | **0.004409 ± 0.000953** | **98.204 ± 0.147%** | **99.88%** |
91
  | **Q5_K_M** | **4.861965 ± 0.120630** | **1.004450 ± 0.001361** | **+0.4450%** | **0.006919 ± 0.000945** | **97.251 ± 0.181%** | **99.85%** |
92
  | **Q4_K_M** | **4.863760 ± 0.120720** | **1.004821 ± 0.001722** | **+0.4821%** | **0.009700 ± 0.001110** | **96.786 ± 0.195%** | **99.76%** |
 
93
 
94
- > **Interpretation:** Q6_K's negative PPL point estimate is not treated as a quality gain because the reported uncertainty spans parity. Q5_K_M and Q4_K_M both show measurable but controlled fidelity cost. Q4_K_M clears its predeclared quantitative gates, but its incremental footprint reduction over Q5_K_M is only **3.50%**, so Q6_K remains the overall quality/efficiency sweet spot and Q5_K_M remains the tighter-memory sweet spot.
95
-
96
- ## Choose the Right Precision
97
 
98
- | Variant | Positioning | Main model size | Fidelity / efficiency role | Recommended for |
99
- |---|---|---:|---|---|
100
- | **BF16** | Reference fidelity | **53.808 GB / 50.113 GiB** | Canonical reference; no low-bit quantization | Research, reproducibility, attribution, quantization baselines |
101
- | **Q8_0** | High-fidelity local | **28.596 GB / 26.632 GiB** | Lowest measured distributional drift among released low-bit tiers | Quality-first local inference |
102
- | **Q6_K** | **Overall quality / efficiency sweet spot** | **22.083 GB / 20.566 GiB** | **58.96% smaller than BF16; no detectable PPL degradation** | Default recommendation when ~20.6 GiB model storage fits |
103
- | **Q5_K_M** | **Memory-constrained quality sweet spot** | **20.364 GB / 18.965 GiB** | **62.16% smaller than BF16; +0.4450% measured PPL drift** | Tighter memory budgets with controlled fidelity cost |
104
- | **Q4_K_M** | Validated 4-bit-core candidate | **19.651 GB / 18.301 GiB** | **63.48% smaller than BF16; +0.4821% PPL drift; quantitative QC PASS** | Deployments where the final ~0.664 GiB reduction versus Q5_K_M matters |
105
- | `IQ4_XS` | Compact 4-bit-class tier | Pending validation | Planned BF16-relative measurement | Maximum footprint reduction |
106
 
107
- ### BF16 — reference fidelity
 
 
 
 
108
 
109
- Use **BF16** for reproducibility, attribution, or quantization research. It is the canonical GGUF against which every lower-bit tier is measured.
110
 
111
- ### Q8_0 — high-fidelity local
112
 
113
- Use **Q8_0** when the closest measured low-bit behavior to BF16 matters more than minimizing footprint. The main file is **46.86% smaller than BF16** while retaining **98.815% same-top agreement** under the frozen test.
114
 
115
- ### Q6_K — overall quality / efficiency sweet spot
 
 
 
 
 
 
 
116
 
117
- Use **Q6_K** as the default precision recommendation when its **20.566 GiB** main-file footprint fits. It is **58.96% smaller than BF16**, and its paired PPL result is statistically consistent with BF16 parity under the frozen protocol.
118
 
119
- ### Q5_K_M — memory-constrained quality sweet spot
120
 
121
- Use **Q5_K_M** when fitting below Q6_K matters. Its main file is **18.965 GiB**, **62.16% smaller than BF16**, and **7.78% smaller than Q6_K**. The measured trade-off is **+0.4450% PPL**, **Mean KLD 0.006919**, and **97.251% Same top-p**.
122
 
123
- ### Q4_K_M — validated 4-bit-core candidate
 
 
 
 
 
 
 
 
124
 
125
- Q4_K_M is a **mixed-precision Q4_K_M policy**, not a uniform 4-bit model. The 64 `*.ffn_up.weight` tensors remain Q4_K, `*.ffn_gate.weight` is retained at Q5_K after a controlled sensitivity correction, and high-sensitivity output/embedding/attention/FFN-down/SSM-output paths remain Q6_K. This yields **5.84 effective BPW** and an **18.301 GiB** main file. The tier passes all frozen quantitative gates, but final stock-runtime and immutable-identity validation are still pending.
126
 
127
- ## Available Files
128
 
129
  ### Main models
130
 
131
- | File | Precision / quant | Exact size | Role | Status |
132
  |---|---|---:|---|---|
133
- | `VeriLoop-E2-BF16.gguf` | BF16 / selected F32 tensors | **53,808,284,000 bytes / 50.113 GiB** | Canonical reference | **Verified** |
134
- | `VeriLoop-E2-Q8_0.gguf` | Q8_0 / retained F32 tensors | **28,595,765,600 bytes / 26.632 GiB** | High-fidelity local | **Verified / Release Quality PASS** |
135
- | `VeriLoop-E2-Q6_K.gguf` | Q6_K, imatrix-assisted | **22,082,532,096 bytes / 20.566 GiB** | **Overall quality / efficiency sweet spot** | **Verified / Release Quality PASS** |
136
- | `VeriLoop-E2-Q5_K_M.gguf` | Mixed Q5_K_M + protected Q6_K, imatrix-assisted | **20,363,666,176 bytes / 18.965 GiB** | **Memory-constrained quality sweet spot** | **Verified / Release Quality PASS** |
137
- | `VeriLoop-E2-Q4_K_M.gguf` | Mixed Q4/Q5/Q6, imatrix-assisted | **19,650,634,496 bytes / 18.301 GiB** | Validated 4-bit-core candidate | **Quantitative QC PASS; runtime/SHA pending; not yet public** |
138
-
139
- ### Optional MTP draft files
140
-
141
- | File | Role | Exact size | Notes |
142
- |---|---|---:|---|
143
- | `mtp-VeriLoop-E2-BF16.gguf` | BF16 MTP companion | ~6.04 GB | Optional speculative-decoding artifact |
144
- | `mtp-VeriLoop-E2-Q8_0.gguf` | Q8 release MTP companion | **3,287,070,240 bytes / 3.061 GiB** | Stock llama.cpp load + speculative-draft smoke validated |
145
- | `mtp-VeriLoop-E2-Q6_K.gguf` | Q6 release MTP companion | **2,008,056,096 bytes / 1.870 GiB** | 18-tensor Q4_0 draft; stock-runtime smoke validated |
146
- | `mtp-VeriLoop-E2-Q5_K_M.gguf` | Q5 release MTP companion | **2,008,056,096 bytes / 1.870 GiB** | **Verified; stock-runtime MTP smoke PASS** |
147
-
148
- Artifact identity and validation states are tracked in [`RELEASE_MANIFEST.json`](./RELEASE_MANIFEST.json).
149
-
150
- ## BF16-Paired Quantization Fidelity Benchmark
151
-
152
- ### Q8_0 — high-fidelity tier
153
-
154
- | Metric | BF16 reference | Q8_0 | Observed drift |
155
- |---|---:|---:|---:|
156
- | Mean PPL | **4.840423 ± 0.119931** | **4.843536 ± 0.120062** | **+0.003113 ± 0.003651** |
157
- | PPL ratio | 1.000000 | **1.000643 ± 0.000754** | **+0.0643%** |
158
- | Mean KLD vs BF16 | 0 | **0.002176 ± 0.000668** | lower is better |
159
- | Same top-p | 100% reference | **98.815 ± 0.120%** | 1.185 pp disagreement |
160
- | RMS token-probability Δp | 0% reference | **1.251 ± 0.137%** | distributional-noise scale |
161
- | Mean token-probability Δp | 0% reference | **−0.007 ± 0.014%** | near-zero directional bias |
162
- | log-PPL correlation | 100% reference | **99.95%** | very high agreement |
163
-
164
- **Q8_0 quantitative gate: PASS.**
165
-
166
- ### Q6_K — quality / efficiency tier
167
-
168
- | Metric | BF16 reference | Q6_K | Observed drift |
169
- |---|---:|---:|---:|
170
- | Mean PPL | **4.840423 ± 0.119931** | **4.838514 ± 0.119694** | **−0.001910 ± 0.005918** |
171
- | PPL ratio | 1.000000 | **0.999605 ± 0.001222** | **−0.0395% observed; no detectable degradation** |
172
- | Mean KLD vs BF16 | 0 | **0.004409 ± 0.000953** | lower is better |
173
- | Same top-p | 100% reference | **98.204 ± 0.147%** | 1.796 pp disagreement |
174
- | RMS token-probability Δp | 0% reference | **1.929 ± 0.201%** | distributional-noise scale |
175
- | Mean token-probability Δp | 0% reference | **−0.032 ± 0.021%** | small directional bias |
176
- | log-PPL correlation | 100% reference | **99.88%** | very high agreement |
177
 
178
- **Q6_K quantitative gate: PASS.**
179
 
180
- ### Q5_K_M — memory-constrained quality tier
181
-
182
- | Metric | BF16 reference | Q5_K_M | Observed drift |
183
- |---|---:|---:|---:|
184
- | Mean PPL | **4.840423 ± 0.119931** | **4.861965 ± 0.120630** | **+0.021542 ± 0.006609** |
185
- | PPL ratio | 1.000000 | **1.004450 ± 0.001361** | **+0.4450%** |
186
- | Mean KLD vs BF16 | 0 | **0.006919 ± 0.000945** | lower is better |
187
- | Same top-p | 100% reference | **97.251 ± 0.181%** | 2.749 pp disagreement |
188
- | RMS token-probability Δp | 0% reference | **2.490 ± 0.211%** | distributional-noise scale |
189
- | Mean token-probability Δp | 0% reference | **−0.127 ± 0.027%** | small negative directional bias |
190
- | log-PPL correlation | 100% reference | **99.85%** | very high agreement |
191
-
192
- **Q5_K_M quantitative gate: PASS.**
193
-
194
- ### Q4_K_M — mixed-precision 4-bit-core candidate
195
-
196
- | Metric | BF16 reference | Q4_K_M | Observed drift |
197
- |---|---:|---:|---:|
198
- | Mean PPL | **4.840423 ± 0.119931** | **4.863760 ± 0.120720** | **+0.023337 ± 0.008350** |
199
- | PPL ratio | 1.000000 | **1.004821 ± 0.001722** | **+0.4821%** |
200
- | Mean KLD vs BF16 | 0 | **0.009700 ± 0.001110** | lower is better |
201
- | Same top-p | 100% reference | **96.786 ± 0.195%** | 3.214 pp disagreement |
202
- | RMS token-probability Δp | 0% reference | **2.843 ± 0.155%** | distributional-noise scale |
203
- | Mean token-probability Δp | 0% reference | **−0.046 ± 0.031%** | small directional bias |
204
- | log-PPL correlation | 100% reference | **99.76%** | very high agreement |
205
-
206
- **Q4_K_M quantitative gate: PASS.** The measured **+0.4821% PPL change is quantization-fidelity drift under this protocol, not a downstream benchmark-score loss**.
207
-
208
- ### Quantitative release gates
209
 
210
- The gates are **tier-specific frozen VeriLoop release-QA criteria**, not universal industry standards. Gate decisions use the measured point estimates; reported uncertainty remains visible alongside the measurements.
211
 
212
- | Tier | PPL-ratio gate | Mean-KLD gate | Same-top-p gate | Quantitative result |
213
- |---|---|---|---|---|
214
- | **Q8_0** | ≤ 1.005 → **1.000643 PASS** | ≤ 0.005 → **0.002176 PASS** | ≥ 97.0% → **98.815% PASS** | **PASS** |
215
- | **Q6_K** | ≤ 1.005 → **0.999605 PASS** | ≤ 0.006 → **0.004409 PASS** | ≥ 97.0% → **98.204% PASS** | **PASS** |
216
- | **Q5_K_M** | ≤ 1.0075 → **1.004450 PASS** | ≤ 0.008 → **0.006919 PASS** | ≥ 96.5% → **97.251% PASS** | **PASS** |
217
- | **Q4_K_M** | ≤ 1.0100 → **1.004821 PASS** | ≤ 0.0100 → **0.009700 PASS** | ≥ 96.0% → **96.786% PASS** | **PASS** |
218
 
219
- For the full measurement record, see [`QUANTIZATION_QUALITY.md`](./QUANTIZATION_QUALITY.md).
220
 
221
- ## Fixed BF16-Paired Comparison Protocol
222
 
223
- Q8_0, Q6_K, Q5_K_M, and Q4_K_M use the **same BF16 reference logits and the same frozen evaluation protocol**, allowing within-repository trade-off analysis.
224
 
225
  | Item | Value |
226
  |---|---|
227
- | Baseline | Canonical VeriLoop E2 BF16 GGUF |
228
  | Corpus | WikiText-2 raw test |
229
  | Corpus SHA256 | `173c87a53759e0201f33e0ccf978e510c2042d7f2cb78229d9a50d79b9e7dd08` |
230
- | Context | **2,048 tokens** |
231
  | Chunks | **8** |
232
  | Seed | **42** |
233
  | GPU layers | **40** |
234
  | Flash Attention | **Off** |
235
- | KV cache | **F16 / F16** |
236
  | Batch / micro-batch | **512 / 512** |
237
- | Evaluation tool | `llama-perplexity` |
238
- | Reference-logit method | BF16 logits persisted with `--kl-divergence-base` |
239
- | Candidate method | Quantized model evaluated with `--kl-divergence` against the frozen BF16 logit file |
240
- | llama.cpp quantization / QC revision | `42916d83f4a225e56709f873aa8050ac11f5b6a4` |
241
- | BF16 reference SHA256 | `11bf5defde1a256b7582bc34fd2c4a85a61615ed88e7a422dcd24d814ea6d35d` |
242
-
243
- The BF16 logits are reused rather than recomputed for every quantization tier.
244
-
245
- ---
246
-
247
- ## Quantization Configuration
248
-
249
- ### Q8_0
250
-
251
- | Property | Value |
252
- |---|---|
253
- | Source | Canonical VeriLoop E2 BF16 GGUF |
254
- | Quantization | `Q8_0` |
255
- | Requantized from a lower-bit model | **No** |
256
- | Source size reported by quantizer | **51,305.09 MiB** |
257
- | Quantized size reported by quantizer | **27,260.56 MiB** |
258
- | Effective density | **8.50 BPW** |
259
- | Main tensor count | **851** |
260
- | Q8_0 tensors | **498** |
261
- | Retained F32 tensors | **353** |
262
- | Quantization threads | **25** |
263
- | Quantization time | **38.315 s** |
264
- | Build gate | **PASS** |
265
-
266
- ### Q6_K
267
-
268
- | Property | Value |
269
- |---|---|
270
- | Source | Canonical VeriLoop E2 BF16 GGUF |
271
- | Quantization | `Q6_K` |
272
- | Requantized from another low-bit model | **No — direct BF16 → Q6_K** |
273
- | Quantized size reported by quantizer | **21,049.06 MiB** |
274
- | Effective density | **6.57 BPW** |
275
- | Exact main-file size | **22,082,532,096 bytes / 20.566 GiB** |
276
- | Main tensor count | **851** |
277
- | Quantization threads | **25** |
278
- | Quantization time | **67.13647 s** |
279
- | Importance matrix | **Model-specific; 496 entries; computed on 582 chunks** |
280
- | Importance-matrix size | **13,642,752 bytes** |
281
- | Importance-matrix SHA256 | `72d7c3fb0ee839cb591deaa10201fb8e826f1f6b58a6a889f897b02f6381748b` |
282
- | Calibration corpus | `Qwen3.8-27B-calibration-v6.txt` |
283
- | Main structure gate | **PASS** |
284
- | Quantitative quality gate | **PASS** |
285
-
286
- ### Q5_K_M — mixed-precision quality-preserving build
287
-
288
- | Property | Value |
289
- |---|---|
290
- | Source | Canonical VeriLoop E2 BF16 GGUF |
291
- | Quantization | `Q5_K_M` base with protected Q6_K paths |
292
- | Requantized from another low-bit model | **No — direct BF16 → Q5_K_M** |
293
- | Quantized size reported by quantizer | **19,409.82 MiB** |
294
- | Effective density | **6.05 BPW** |
295
- | Exact main-file size | **20,363,666,176 bytes / 18.965 GiB** |
296
- | Main tensor count | **851** |
297
- | Retained F32 tensors | **353** |
298
- | Q5_K tensors | **272** |
299
- | Protected Q6_K tensors | **226** |
300
- | Quantization threads | **25** |
301
- | Quantization time | **120.23577 s** |
302
- | Importance matrix | **Model-specific; 496 entries; computed on 582 chunks** |
303
- | Importance-matrix size | **13,642,752 bytes** |
304
- | Importance-matrix SHA256 | `72d7c3fb0ee839cb591deaa10201fb8e826f1f6b58a6a889f897b02f6381748b` |
305
- | Calibration corpus | `Qwen3.8-27B-calibration-v6.txt` |
306
- | Quality policy | `q5_k_m_quality_v3_q6_attention_logits` |
307
- | Main structure gate | **PASS — 851 tensors** |
308
- | Quantitative quality gate | **PASS** |
309
-
310
- Protected Q6_K tensor groups:
311
-
312
- | Tensor group | Q6_K count |
313
- |---|---:|
314
- | `output.weight` | 1 |
315
- | `token_embd.weight` | 1 |
316
- | `*.attn_v.weight` | 16 |
317
- | `*.attn_qkv.weight` | 48 |
318
- | `*.attn_output.weight` | 16 |
319
- | `*.ffn_down.weight` | 64 |
320
- | `*.ssm_out.weight` | 48 |
321
- | `*.attn_q.weight` | 16 |
322
- | `*.attn_k.weight` | 16 |
323
- | **Total** | **226** |
324
-
325
- ### Q4_K_M — root-cause-guided mixed-precision 4-bit-core build
326
-
327
- | Property | Value |
328
- |---|---|
329
- | Source | Canonical VeriLoop E2 BF16 GGUF |
330
- | Quantization | `Q4_K_M` base with Q5_K/Q6_K protected paths |
331
- | Requantized from another low-bit model | **No — direct BF16 → Q4_K_M** |
332
- | Quantized size reported by quantizer | **18,729.82 MiB** |
333
- | Effective density | **5.84 BPW** |
334
- | Exact main-file size | **19,650,634,496 bytes / 18.301 GiB** |
335
- | Main tensor count | **851** |
336
- | Retained F32 tensors | **353** |
337
- | Q4_K tensors | **64** |
338
- | Q5_K tensors | **208** |
339
- | Q6_K tensors | **226** |
340
- | Quantization threads | **25** |
341
- | Quantization time | **119.16670 s** |
342
- | Importance matrix | **Model-specific; 496 entries; computed on 582 chunks** |
343
- | Importance-matrix size | **13,642,752 bytes** |
344
- | Importance-matrix SHA256 | `72d7c3fb0ee839cb591deaa10201fb8e826f1f6b58a6a889f897b02f6381748b` |
345
- | Calibration corpus | `Qwen3.8-27B-calibration-v6.txt` |
346
- | Main structure / precision-policy gate | **PASS — 851 tensors** |
347
- | Quantitative quality gate | **PASS** |
348
- | Final stock runtime / immutable identity | **Pending** |
349
-
350
- The final Q4 policy is deliberately mixed precision. The **64 `*.ffn_up.weight` tensors are Q4_K**; **64 `*.ffn_gate.weight` tensors are retained at Q5_K**; attention-gate and SSM-control groups are also Q5_K; and **226 high-sensitivity output, embedding, attention, FFN-down, and SSM-output tensors remain Q6_K**. A broader development policy that also pushed FFN-gate tensors to Q4_K failed the frozen Mean-KLD gate (**0.012706 > 0.0100**). Restoring FFN-gate tensors to Q5_K reduced Mean KLD to **0.009700** while preserving a true Q4 core, which is the measured basis for the final candidate policy.
351
-
352
- ---
353
-
354
- ## Release Provenance
355
-
356
- ### BF16 reference
357
-
358
- | Check | Result |
359
- |---|---|
360
- | Parent checkpoint | `tsinghua-sigs-robot-lab/VeriLoop-E2` |
361
- | Base model family | Qwen3.8-27B |
362
- | HF architecture | `Qwen3_5ForConditionalGeneration` |
363
- | Native model context | 262,144 tokens |
364
- | Conversion tool | `convert_hf_to_gguf.py` |
365
- | BF16 conversion llama.cpp revision | `bddf8263c31c3dce3212263b00ebd2d98c1a752b` |
366
- | BF16 target tensor audit | **851 tensors / PASS** |
367
- | Non-zero tensor audit | **PASS** |
368
- | Source-checkpoint immutability gate | **PASS** |
369
- | BF16 main-model load gate | **PASS** |
370
-
371
- ### Q8_0
372
-
373
- | Check | Result |
374
- |---|---|
375
- | Quantization source | Canonical BF16 GGUF |
376
- | Requantization from lower precision | **No** |
377
- | Quantization type | **Q8_0** |
378
- | llama.cpp quantization / QC revision | `42916d83f4a225e56709f873aa8050ac11f5b6a4` |
379
- | Structure gate | **PASS** |
380
- | Quantitative fidelity gate | **PASS** |
381
- | Main-model runtime generation | **PASS** |
382
- | MTP compatibility smoke | **PASS** |
383
- | Release identity | **Frozen** |
384
-
385
- ### Q6_K
386
-
387
- | Check | Result |
388
- |---|---|
389
- | Quantization source | Canonical BF16 GGUF |
390
- | Requantization from lower precision | **No** |
391
- | Importance-matrix-assisted | **Yes** |
392
- | Structure gate | **PASS** |
393
- | Quantitative fidelity gate | **PASS** |
394
- | Stock llama.cpp main runtime | **PASS** |
395
- | MTP stock-runtime smoke | **PASS** |
396
- | Main SHA256 | `15d8f856471c4853f6bf0036b2a517426c6cb30a0313cef58a7f9577fd26fe9e` |
397
- | MTP SHA256 | `0e7f2dfe254f3a5d195d105832411acc1007fd7bb9ac980fe9aae4a1f290d671` |
398
- | Release identity | **Frozen / remote exact-size verification PASS** |
399
-
400
- ### Q5_K_M
401
-
402
- | Check | Result |
403
- |---|---|
404
- | Quantization source | Canonical BF16 GGUF |
405
- | Requantization from lower precision | **No** |
406
- | Importance-matrix-assisted | **Yes** |
407
- | Mixed-precision protected-path policy | **PASS** |
408
- | Main tensor count | **851 / PASS** |
409
- | Quantitative fidelity gate | **PASS** |
410
- | Final stock llama.cpp main runtime | **PASS** |
411
- | Final MTP speculative-runtime smoke | **PASS** |
412
- | Main SHA256 | `f90ec14d7ec8f084a292413ae0e06483c87ab5e1422ddce51f2e3409d8853b61` |
413
- | MTP SHA256 | `0e7f2dfe254f3a5d195d105832411acc1007fd7bb9ac980fe9aae4a1f290d671` |
414
- | Remote exact-size + LFS-SHA verification | **PASS** |
415
- | Release identity | **Frozen / public release verified** |
416
-
417
- ### Q4_K_M
418
-
419
- | Check | Result |
420
- |---|---|
421
- | Quantization source | Canonical BF16 GGUF |
422
- | Requantization from lower precision | **No** |
423
- | Importance-matrix-assisted | **Yes** |
424
- | Mixed Q4/Q5/Q6 precision policy | **PASS** |
425
- | Main tensor count | **851 / PASS** |
426
- | Quantitative fidelity gate | **PASS** |
427
- | Final stock llama.cpp runtime | **Pending** |
428
- | Final one-time SHA256 / immutable identity | **Pending** |
429
- | Public upload authorization | **Pending runtime + identity freeze** |
430
 
431
- ---
432
-
433
- ## Parent-Model Benchmark Record
434
 
435
- The following scores identify the **parent VeriLoop E2 release**. They are not relabeled as Q8_0-, Q6_K-, Q5_K_M-, or Q4_K_M-specific task scores; quantization fidelity is measured directly against BF16 above.
436
 
437
- <p align="center">
438
- <img src="https://huggingface.co/tsinghua-sigs-robot-lab/VeriLoop-E2/resolve/main/.eval_results/veriloop_e2_benchmark_result.png" width="100%" alt="VeriLoop E2 benchmark comparison across nine public benchmarks">
439
- </p>
440
 
441
- | Benchmark | VeriLoop E2 release score | Public evidence |
442
  |---|---:|---|
443
  | SWE-bench Pro | **76.2** | [Evidence](https://huggingface.co/datasets/tsinghua-sigs-robot-lab/VeriLoop-E2-Evaluation-Evidence/tree/main/swe-bench-pro) |
444
  | Terminal-Bench 2.1 | **88.8** | [Evidence](https://huggingface.co/datasets/tsinghua-sigs-robot-lab/VeriLoop-E2-Evaluation-Evidence/tree/main/terminal-bench-2.1) |
@@ -450,146 +218,95 @@ The following scores identify the **parent VeriLoop E2 release**. They are not r
450
  | GPQA Diamond | **93.9** | [Evidence](https://huggingface.co/datasets/tsinghua-sigs-robot-lab/VeriLoop-E2-Evaluation-Evidence/tree/main/gpqa-diamond) |
451
  | Apex 2025 | **89.6** | [Evidence](https://huggingface.co/datasets/tsinghua-sigs-robot-lab/VeriLoop-E2-Evaluation-Evidence/tree/main/apex-2025) |
452
 
453
- For exact benchmark protocols, task-level outputs, evaluator receipts, and provenance, use the **[VeriLoop E2 Evaluation Evidence](https://huggingface.co/datasets/tsinghua-sigs-robot-lab/VeriLoop-E2-Evaluation-Evidence)** repository.
454
-
455
- ---
456
-
457
- ## Quick Start with llama.cpp
458
 
459
- Use a recent llama.cpp build with Qwen3.8 support.
460
 
461
- ### Install
462
-
463
- ```bash
464
- curl -LsSf https://llama.app/install.sh | sh
465
- ```
466
-
467
- Or build from source:
468
-
469
- ```bash
470
- git clone https://github.com/ggml-org/llama.cpp.git
471
- cd llama.cpp
472
- cmake -B build -DGGML_CUDA=ON
473
- cmake --build build -j --target llama-server llama-cli
474
- ```
475
 
476
  ### Download
477
 
478
  ```bash
479
- # BF16 reference
480
- hf download tsinghua-sigs-robot-lab/VeriLoop-E2-GGUF VeriLoop-E2-BF16.gguf --local-dir .
481
-
482
- # Q8_0 high-fidelity local tier
483
- hf download tsinghua-sigs-robot-lab/VeriLoop-E2-GGUF VeriLoop-E2-Q8_0.gguf --local-dir .
484
-
485
- # Q6_K overall quality / efficiency sweet spot
486
  hf download tsinghua-sigs-robot-lab/VeriLoop-E2-GGUF VeriLoop-E2-Q6_K.gguf --local-dir .
487
 
488
- # Q5_K_M memory-constrained quality sweet spot
489
  hf download tsinghua-sigs-robot-lab/VeriLoop-E2-GGUF VeriLoop-E2-Q5_K_M.gguf --local-dir .
490
- ```
491
 
492
- `Q4_K_M` is not added to the public download block until its final stock-runtime and immutable-identity gates are frozen.
 
 
 
 
 
493
 
494
- ### Run
495
 
496
  ```bash
497
  llama-server \
498
- -m ./VeriLoop-E2-Q6_K.gguf \
499
- -ngl all \
500
  -c 32768 \
501
  --host 127.0.0.1 \
502
  --port 8080
503
  ```
504
 
505
- The OpenAI-compatible endpoint is available at:
506
 
507
- ```text
508
- http://127.0.0.1:8080/v1
509
- ```
510
-
511
- `-ngl all` is appropriate only when model weights, KV cache, and runtime workspace fit accelerator memory. Partial GPU offload is supported when full offload is not practical.
512
-
513
- ---
514
 
515
- ## Optional MTP Speculative Decoding
516
 
517
- The Q8_0, Q6_K, and Q5_K_M MTP companions have completed stock llama.cpp compatibility validation.
518
 
519
  ```bash
520
- hf download tsinghua-sigs-robot-lab/VeriLoop-E2-GGUF mtp-VeriLoop-E2-Q8_0.gguf --local-dir .
521
- hf download tsinghua-sigs-robot-lab/VeriLoop-E2-GGUF mtp-VeriLoop-E2-Q6_K.gguf --local-dir .
522
  hf download tsinghua-sigs-robot-lab/VeriLoop-E2-GGUF mtp-VeriLoop-E2-Q5_K_M.gguf --local-dir .
523
- ```
524
-
525
- Validated resource-conservative configuration:
526
 
527
- ```bash
528
  llama-server \
529
- -m ./VeriLoop-E2-Q6_K.gguf \
530
- --model-draft ./mtp-VeriLoop-E2-Q6_K.gguf \
531
- --spec-type draft-mtp \
532
- -ngl all \
533
- --n-gpu-layers-draft 0 \
534
- -c 8192 \
535
  --host 127.0.0.1 \
536
  --port 8080
537
  ```
538
 
539
- MTP acceleration is workload- and runtime-dependent; no universal speedup is claimed.
540
 
541
- ---
542
-
543
- ## Memory Guidance
544
 
545
- | Variant | Main model file | Practical implication |
546
  |---|---:|---|
547
- | BF16 | **50.113 GiB** | Reference-quality deployment; substantial VRAM/RAM required |
548
- | Q8_0 | **26.632 GiB** | Near-reference fidelity at materially lower footprint |
549
- | **Q6_K** | **20.566 GiB** | **Overall quality / efficiency sweet spot** |
550
- | **Q5_K_M** | **18.965 GiB** | **Released memory-constrained quality sweet spot** |
551
- | **Q4_K_M** | **18.301 GiB** | Validated 4-bit-core candidate; only **0.664 GiB** smaller than Q5_K_M, with higher measured distributional drift |
552
- | Q8_0 MTP companion | **3.061 GiB** | Additional memory only when speculative decoding is enabled |
553
- | Q6/Q5 MTP companion | **1.870 GiB** | Additional draft-model footprint |
554
- | KV cache / runtime workspace | Workload-dependent | Increases with context length, batch size, cache dtype, and parallelism |
555
-
556
- Model-file size is not total runtime-memory consumption. Leave headroom for KV cache, compute buffers, runtime metadata, and optional draft-model execution.
557
-
558
- ## Quantization Release Policy
559
-
560
- Every lower-bit VeriLoop E2 release is compared against the **same canonical BF16 reference**. A quant is not labeled “recommended” solely because the format is common.
561
-
562
- | Quant | Role | Current state | Evidence status |
563
- |---|---|---|---|
564
- | **BF16** | Reference fidelity | Released | Canonical baseline |
565
- | **Q8_0** | High-fidelity local | Released | **Full release quality PASS** |
566
- | **Q6_K** | **Overall quality / efficiency sweet spot** | **Released** | **Full release quality PASS** |
567
- | **Q5_K_M** | **Memory-constrained quality sweet spot** | **Released** | **Full release quality PASS; remote identity verified** |
568
- | **Q4_K_M** | Validated mixed-precision 4-bit-core tier | **Release candidate** | **Build + structure + quantitative fidelity PASS; runtime/identity pending** |
569
- | `IQ4_XS` | Compact 4-bit-class tier | Planned | Pending |
570
-
571
- The comparison protocol prioritizes exact artifact identity, direct-from-BF16 provenance, effective BPW, PPL ratio, KL divergence and distribution tails, token-probability drift, Same top-p agreement, structural integrity, stock-runtime compatibility, and immutable release identity.
572
 
573
- **Overall sweet spot:** **Q6_K**. It is the point on the currently measured ladder with the strongest balance of footprint reduction and BF16 retention. **Memory-constrained sweet spot:** **Q5_K_M**. Q4_K_M is retained as a validated lower-footprint candidate, not promoted to the default sweet spot merely because it is lower-bit.
574
 
575
- **No cross-repository PPL or KLD comparison is claimed unless the corpus, tokenizer path, chunking, context, and runtime protocol are identical.**
576
 
577
- ## Throughput Status
578
 
579
- A standalone Q8_0 `llama-bench` run produced:
580
 
581
- | Workload | Q8_0 |
582
- |---|---:|
583
- | Prompt processing (`pp512`) | **3102.722776 tok/s** |
584
- | Token generation (`tg128`) | **41.999677 tok/s** |
 
 
 
 
585
 
586
- No paired BF16→Q8 speedup is claimed because the paired BF16 speed run did not complete under the original full-offload configuration.
587
 
588
- **No Q6_K, Q5_K_M, or Q4_K_M speedup claim is made without a frozen paired throughput protocol.** This deliberately separates fidelity retention from hardware-specific throughput.
589
-
590
- ---
591
-
592
- ## Model Identity
593
 
594
  | Property | Value |
595
  |---|---|
@@ -605,61 +322,39 @@ No paired BF16→Q8 speedup is claimed because the paired BF16 speed run did not
605
  | Languages | English, Chinese |
606
  | GGUF runtime | llama.cpp |
607
  | Reference precision | BF16 |
608
- | Released quantization | Q8_0, Q6_K, Q5_K_M |
609
- | Validated release candidate | Q4_K_M |
610
  | License | Apache License 2.0 |
611
 
612
- ---
613
 
614
- ## Prompt and Chat Protocol
 
 
 
 
 
 
 
615
 
616
- Use the chat template embedded in the GGUF / inherited from VeriLoop E2. Prompt-template changes, reasoning delimiters, stop rules, samplers, cache settings, and tool-call parsers can materially change observed behavior even when model weights are identical.
617
-
618
- For the full model protocol and system-level behavior, see the **[VeriLoop E2 parent model card](https://huggingface.co/tsinghua-sigs-robot-lab/VeriLoop-E2)**.
619
-
620
- ---
621
-
622
- ## Measurement Boundaries
623
-
624
- - **Q8_0 +0.0643%** is the measured relative PPL increase under the fixed paired protocol; it is not a universal capability-loss percentage.
625
- - **Q6_K −0.0395% observed mean PPL change is not claimed as a capability gain**; the reported uncertainty spans parity.
626
- - **Q5_K_M +0.4450%** is a protocol-specific PPL increase, not a claim that downstream task scores fall by 0.4450%.
627
- - **Q4_K_M +0.4821%** is likewise a protocol-specific PPL increase; it is not a measured percentage loss on SWE-bench, AIME, GPQA, or other downstream tasks.
628
- - Parent-model leaderboard results are included for model identity and provenance, not represented as quant-specific task re-runs.
629
- - PPL/KLD values are meaningful for within-repository BF16-paired comparisons because the reference and candidates use the same frozen protocol.
630
- - The native 262K context comes from the parent-model configuration. Practical local context depends on available memory and runtime settings.
631
- - MTP acceleration is runtime- and workload-dependent.
632
- - The model can still produce incorrect code, mathematical reasoning, scientific arguments, or commands.
633
-
634
- ---
635
-
636
- ## Source Model and Evidence
637
 
638
  | Resource | Link |
639
  |---|---|
640
  | Parent model | [VeriLoop E2](https://huggingface.co/tsinghua-sigs-robot-lab/VeriLoop-E2) |
641
  | GGUF repository | [VeriLoop E2 GGUF](https://huggingface.co/tsinghua-sigs-robot-lab/VeriLoop-E2-GGUF) |
642
  | Quantization quality record | [Quantization Quality](./QUANTIZATION_QUALITY.md) |
643
- | Unified artifact identity / release state | [Release Manifest](./RELEASE_MANIFEST.json) |
644
  | Technical report | [OpenReview](https://openreview.net/forum?id=P6FIQILHwX&noteId=P6FIQILHwX) |
645
  | Evaluation evidence | [VeriLoop E2 Evaluation Evidence](https://huggingface.co/datasets/tsinghua-sigs-robot-lab/VeriLoop-E2-Evaluation-Evidence) |
646
  | Riemann ζ artifact | [Public artifact](https://github.com/brucewang123456789/GeniusTrail/tree/VeriLoop-E2/riemann-hypothesis) |
647
  | llama.cpp | [ggml-org/llama.cpp](https://github.com/ggml-org/llama.cpp) |
648
 
649
- ---
650
-
651
  ## License
652
 
653
- The VeriLoop E2 model weights and this GGUF distribution are released under the **Apache License 2.0**, consistent with the parent model release.
654
-
655
- Third-party software, benchmarks, and separately published scientific artifacts retain their own terms.
656
-
657
- ---
658
 
659
  ## Citation
660
 
661
- If you use VeriLoop E2 or this GGUF distribution in research, please cite the parent model release:
662
-
663
  ```bibtex
664
  @misc{wang2026veriloope2,
665
  title = {VeriLoop E2: A 27B Post-Trained Model for Code, Mathematics, and Scientific Reasoning},
@@ -671,12 +366,10 @@ If you use VeriLoop E2 or this GGUF distribution in research, please cite the pa
671
  }
672
  ```
673
 
674
- For quantization-specific comparisons, identify the exact GGUF filename and release manifest.
675
-
676
- ---
677
 
678
  ## Acknowledgements
679
 
680
  VeriLoop E2 builds on **Qwen3.8-27B** and the open-source model-serving and evaluation ecosystem. We thank the communities behind Qwen, llama.cpp, Transformers, Hugging Face, software-engineering benchmarks, mathematical evaluation suites, and reproducible scientific computing.
681
 
682
- This repository treats **reference fidelity, quantization quality, immutable artifact identity, and reproducible runtime validation as first-class release properties**.
 
14
  - q6_k
15
  - q5_k_m
16
  - q4_k_m
17
+ - q3_k
18
+ - mixed-precision
19
  - imatrix
20
  - mtp
21
  - speculative-decoding
 
37
 
38
  <p align="center">
39
  <strong>Official llama.cpp distribution of VeriLoop E2</strong><br>
40
+ <em>BF16 reference · Q8_0 high fidelity · Q6_K overall sweet spot · Q5_K_M memory-quality sweet spot · Q3_K_M minimum-footprint validated tier</em><br><br>
41
  <strong>27B post-trained model for code, mathematics, and physics · 262K native context · Apache License 2.0</strong><br>
42
  <strong>Developed by Tsinghua SIGS Robot Lab · Libo Wang</strong>
43
  </p>
 
45
  <p align="center">
46
  <a href="https://www.apache.org/licenses/LICENSE-2.0"><img src="https://img.shields.io/badge/License-Apache--2.0-2F80ED?style=flat-square" alt="License: Apache 2.0"></a>
47
  <img src="https://img.shields.io/badge/Format-GGUF-111827?style=flat-square" alt="Format: GGUF">
 
48
  <img src="https://img.shields.io/badge/Q8__0-High--Fidelity-7C3AED?style=flat-square" alt="Q8_0: High Fidelity">
49
+ <img src="https://img.shields.io/badge/Q6__K-Overall%20Sweet%20Spot-0A7F6F?style=flat-square" alt="Q6_K: Overall Sweet Spot">
50
+ <img src="https://img.shields.io/badge/Q5__K__M-Memory--Quality%20Sweet%20Spot-0F766E?style=flat-square" alt="Q5_K_M: Memory Quality Sweet Spot">
51
+ <img src="https://img.shields.io/badge/Q3__K__M-Validated%205.37%20BPW-334155?style=flat-square" alt="Q3_K_M: validated 5.37 BPW mixed precision">
 
52
  <img src="https://img.shields.io/badge/Runtime-llama.cpp-0A7F6F?style=flat-square" alt="Runtime: llama.cpp">
53
  </p>
54
 
 
61
 
62
  ---
63
 
64
+ ## Which file should I download?
65
 
66
+ | Priority | Recommended file | Main size | Measured retention | Use when |
67
+ |---|---|---:|---|---|
68
+ | **Default** | **`VeriLoop-E2-Q6_K.gguf`** | **20.566 GiB** | BF16-paired PPL parity within uncertainty; KLD **0.004409**; Same top-p **98.204%** | You want the strongest overall quality / footprint balance |
69
+ | **Tighter memory** | **`VeriLoop-E2-Q5_K_M.gguf`** | **18.965 GiB** | PPL **+0.4450%**; KLD **0.006919**; Same top-p **97.251%** | You need lower memory while keeping distributional drift controlled |
70
+ | **Smallest validated main file** | **`VeriLoop-E2-Q3_K_M.gguf`** | **16.826 GiB** | PPL **+0.4090%**; KLD **0.014349**; Same top-p **95.919%** | Footprint is the primary constraint and you accept higher distributional drift |
71
+ | **High fidelity** | `VeriLoop-E2-Q8_0.gguf` | **26.632 GiB** | PPL **+0.0643%**; KLD **0.002176**; Same top-p **98.815%** | You prioritize low-bit fidelity over footprint |
72
+ | **Reference** | `VeriLoop-E2-BF16.gguf` | **50.113 GiB** | Canonical reference | Reproducibility, attribution, quantization research |
73
 
74
+ **Current sweet spot.** **Q6_K remains the overall quality / efficiency sweet spot.** It is **58.96% smaller than BF16** while showing no detectable PPL degradation under the frozen paired protocol. **Q5_K_M remains the memory-constrained quality sweet spot**: it is **7.78% smaller than Q6_K** with controlled measured drift. **Q3_K_M is the current minimum-footprint validated tier, not the default sweet spot**: it saves another **11.28% vs Q5_K_M** but Mean KLD rises from **0.006919** to **0.014349** and Same top-p falls from **97.251%** to **95.919%**.
75
 
76
+ > **Important Q3 naming note:** `VeriLoop-E2-Q3_K_M.gguf` is a **root-cause-guided mixed-precision artifact**, not a uniform stock 3-bit model. It contains **353 F32 + 3 Q3_K + 64 Q4_K + 429 Q5_K + 2 Q6_K tensors**, for **5.37 effective BPW**. The filename identifies the release tier / minimum active precision; the exact tensor policy is published below and in `RELEASE_MANIFEST.json`.
77
 
78
+ ## Precision ladder
 
 
 
 
 
 
79
 
80
+ | Tier | Role | Main size | Reduction vs BF16 | Effective density | Release state |
81
+ |---|---|---:|---:|---:|---|
82
+ | **BF16** | Canonical reference | **53.808 GB / 50.113 GiB** | — | 16-bit-class | Verified reference |
83
+ | **Q8_0** | High-fidelity local | **28.596 GB / 26.632 GiB** | **46.86%** | **8.50 BPW** | Verified / Release Quality PASS |
84
+ | **Q6_K** | **Overall sweet spot** | **22.083 GB / 20.566 GiB** | **58.96%** | **6.57 BPW** | Verified / Release Quality PASS |
85
+ | **Q5_K_M** | **Memory-quality sweet spot** | **20.364 GB / 18.965 GiB** | **62.16%** | **6.05 BPW** | Verified / Release Quality PASS |
86
+ | **Q4_K_M** | Intermediate lower-footprint candidate | **19.651 GB / 18.301 GiB** | **63.48%** | **5.84 BPW** | Quantitative QC PASS; its own runtime/identity still pending in this record |
87
+ | **Q3_K_M** | **Minimum-footprint validated tier** | **18.067 GB / 16.826 GiB** | **66.42%** | **5.37 BPW** | **Full release PASS; stock runtime + MTP + remote identity verified** |
88
 
89
+ ## Quantization-retention benchmark
90
 
91
+ All values below are measured against the **same frozen BF16 logits** using the same corpus, context, chunking, seed, cache dtype, and llama.cpp revision.
92
 
93
+ | Tier | Mean PPL | PPL ratio vs BF16 | Relative PPL change | Mean KLD | Same top-p | log-PPL correlation |
94
  |---|---:|---:|---:|---:|---:|---:|
95
+ | **BF16** | **4.840423 ± 0.119931** | 1.000000 | — | 0 reference | 100% reference | 100% reference |
96
  | **Q8_0** | **4.843536 ± 0.120062** | **1.000643 ± 0.000754** | **+0.0643%** | **0.002176 ± 0.000668** | **98.815 ± 0.120%** | **99.95%** |
97
  | **Q6_K** | **4.838514 ± 0.119694** | **0.999605 ± 0.001222** | **−0.0395% observed; parity within uncertainty** | **0.004409 ± 0.000953** | **98.204 ± 0.147%** | **99.88%** |
98
  | **Q5_K_M** | **4.861965 ± 0.120630** | **1.004450 ± 0.001361** | **+0.4450%** | **0.006919 ± 0.000945** | **97.251 ± 0.181%** | **99.85%** |
99
  | **Q4_K_M** | **4.863760 ± 0.120720** | **1.004821 ± 0.001722** | **+0.4821%** | **0.009700 ± 0.001110** | **96.786 ± 0.195%** | **99.76%** |
100
+ | **Q3_K_M** | **4.860222 ± 0.120606** | **1.004090 ± 0.002181** | **+0.4090%** | **0.014349 ± 0.001985** | **95.919 ± 0.219%** | **99.62%** |
101
 
102
+ **How to read the loss numbers.** The measured **+0.4090% Q3 PPL change is a quantization-fidelity result, not a claim that SWE-bench, AIME, GPQA, coding-agent, mathematics, or physics scores fall by 0.4090%.** Per-quant downstream task suites were **not rerun**, so no downstream benchmark-loss percentage is claimed. KLD and Same top-p measure distributional divergence directly and are essential here: Q3's PPL point estimate remains close to BF16 while its KLD is materially higher than Q5/Q4, which is why Q3 is positioned as a footprint-first tier rather than the default sweet spot.
 
 
103
 
104
+ ### Downstream benchmark-loss status
 
 
 
 
 
 
 
105
 
106
+ | Evidence layer | What is measured | What is **not** claimed |
107
+ |---|---|---|
108
+ | Parent VeriLoop E2 benchmark suite | Parent-model capability on nine public benchmark tracks | That every quant reproduces the parent score exactly |
109
+ | BF16-paired GGUF benchmark | PPL ratio, KL divergence, token-probability drift, Same top-p, correlation | Universal task-score loss or gain |
110
+ | Q3 stock runtime + MTP validation | Main load/generation, MTP load/generation, greedy target-output identity | Universal throughput speedup |
111
 
112
+ ## Q3_K_M — root-cause-guided low-footprint release
113
 
114
+ The Q3 release was **not** produced by applying a stock Q3 preset to the whole model. Broad Q3 policies failed the frozen fidelity gates, so the final artifact was derived by root-cause isolation and a KL-budgeted tensor policy.
115
 
116
+ ### Final Q3 tensor policy
117
 
118
+ | Precision | Tensor assignment | Count |
119
+ |---|---|---:|
120
+ | F32 | Non-quantized tensors retained by the GGUF conversion | **353** |
121
+ | Q6_K | `output.weight`, `token_embd.weight` | **2** |
122
+ | Q5_K | Remaining attention / SSM / FFN-gate / FFN-down tensors | **429** |
123
+ | Q4_K | all `*.ffn_up.weight` | **64** |
124
+ | Q3_K | `blk.1.ffn_down.weight`, `blk.0.ffn_down.weight`, `blk.3.ffn_down.weight` | **3** |
125
+ | **Total** | | **851** |
126
 
127
+ ### Why only three Q3 tensors?
128
 
129
+ The development evidence showed that **FFN-up Q4→Q3 was the dominant failure source** in the first broad Q3 design; full-family FFN-down and QKV Q3 policies also produced excessive distributional drift. A 33-tensor low-sensitivity shortlist then passed PPL and Same top-p but still failed Mean KLD (**0.018066 > 0.015**). The final policy therefore made KLD the binding constraint and admitted only the three lowest-sensitivity FFN-down tensors. The resulting artifact passed both the hard Q3 gate and a stricter engineering reserve gate.
130
 
131
+ ### Q3 final fidelity gates
132
 
133
+ | Gate | Hard threshold | Reserve threshold | Measured | Result |
134
+ |---|---:|---:|---:|---|
135
+ | PPL ratio | ≤ **1.0150** | ≤ **1.0135** | **1.004090** | **PASS / PASS** |
136
+ | Mean KLD | ≤ **0.0150** | ≤ **0.0145** | **0.014349** | **PASS / PASS** |
137
+ | Same top-p | ≥ **95.0%** | ≥ **95.5%** | **95.919%** | **PASS / PASS** |
138
+ | Exact tensor structure | declared policy | declared policy | **851 tensors; 0 mismatch** | **PASS** |
139
+ | Stock llama.cpp main runtime | required | required | **PASS** | **PASS** |
140
+ | MTP load + generation | required | required | **PASS** | **PASS** |
141
+ | Greedy target-output identity with/without MTP | exact match | exact match | **SHA256 identical** | **PASS** |
142
 
143
+ The Q3 Mean-KLD reserve margin is intentionally small (**0.000151**). The release therefore does **not** claim that further low-bit expansion is safe under the same policy.
144
 
145
+ ## Available files
146
 
147
  ### Main models
148
 
149
+ | File | Quantization | Exact size | Role | Status |
150
  |---|---|---:|---|---|
151
+ | `VeriLoop-E2-BF16.gguf` | BF16 / selected F32 tensors | **53,808,284,000 bytes / 50.113 GiB** | Canonical reference | Verified |
152
+ | `VeriLoop-E2-Q8_0.gguf` | Q8_0 / retained F32 tensors | **28,595,765,600 bytes / 26.632 GiB** | High-fidelity local | Verified / Release Quality PASS |
153
+ | `VeriLoop-E2-Q6_K.gguf` | Q6_K, imatrix-assisted | **22,082,532,096 bytes / 20.566 GiB** | **Overall sweet spot** | Verified / Release Quality PASS |
154
+ | `VeriLoop-E2-Q5_K_M.gguf` | Mixed Q5/Q6, imatrix-assisted | **20,363,666,176 bytes / 18.965 GiB** | **Memory-quality sweet spot** | Verified / Release Quality PASS |
155
+ | `VeriLoop-E2-Q4_K_M.gguf` | Mixed Q4/Q5/Q6 | **19,650,634,496 bytes / 18.301 GiB** | Intermediate lower-footprint candidate | Quantitative QC PASS; own runtime/identity pending |
156
+ | `VeriLoop-E2-Q3_K_M.gguf` | **Custom mixed Q3/Q4/Q5/Q6** | **18,066,506,496 bytes / 16.826 GiB** | **Minimum-footprint validated tier** | **Full release PASS; runtime + MTP + remote identity verified** |
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
157
 
158
+ ### Q3 immutable identity
159
 
160
+ | Property | Value |
161
+ |---|---|
162
+ | Filename | `VeriLoop-E2-Q3_K_M.gguf` |
163
+ | Exact bytes | **18,066,506,496** |
164
+ | Binary size | **16.825745 GiB** |
165
+ | SHA256 | `c2e9539cfb85d87a99605b6914ed602c0fa750164c153ce5574710123aba06fe` |
166
+ | Effective density | **5.37 BPW** |
167
+ | Tensor count | **851** |
168
+ | llama.cpp QC/runtime revision | `42916d83f4a225e56709f873aa8050ac11f5b6a4` |
169
+ | Hugging Face remote identity | **PASS — exact size + full SHA256 + remote readability** |
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
170
 
171
+ ### Optional MTP draft files
172
 
173
+ | File | Exact size | Role |
174
+ |---|---:|---|
175
+ | `mtp-VeriLoop-E2-Q8_0.gguf` | **3,287,070,240 bytes / 3.061 GiB** | Q8 MTP companion |
176
+ | `mtp-VeriLoop-E2-Q6_K.gguf` | **2,008,056,096 bytes / 1.870 GiB** | 18-tensor Q4_0 MTP companion |
177
+ | `mtp-VeriLoop-E2-Q5_K_M.gguf` | **2,008,056,096 bytes / 1.870 GiB** | 18-tensor Q4_0 MTP companion |
 
178
 
179
+ **Q3 MTP compatibility.** Q3 stock-runtime validation used an 18-tensor Q4_0 MTP object with SHA256 `0e7f2dfe254f3a5d195d105832411acc1007fd7bb9ac980fe9aae4a1f290d671`. That object is byte-identical to the published Q5/Q6 MTP companion, so a duplicate Q3-specific MTP file is not required for the validated path.
180
 
181
+ Artifact identity and validation states are tracked in [`RELEASE_MANIFEST.json`](./RELEASE_MANIFEST.json).
182
 
183
+ ## Frozen BF16-paired protocol
184
 
185
  | Item | Value |
186
  |---|---|
187
+ | Reference model | Canonical VeriLoop E2 BF16 GGUF |
188
  | Corpus | WikiText-2 raw test |
189
  | Corpus SHA256 | `173c87a53759e0201f33e0ccf978e510c2042d7f2cb78229d9a50d79b9e7dd08` |
190
+ | Context | **2,048** |
191
  | Chunks | **8** |
192
  | Seed | **42** |
193
  | GPU layers | **40** |
194
  | Flash Attention | **Off** |
195
+ | KV cache | **F16/F16** |
196
  | Batch / micro-batch | **512 / 512** |
197
+ | Evaluator | `llama-perplexity` |
198
+ | Reference logits | `--kl-divergence-base` |
199
+ | Candidate comparison | `--kl-divergence` |
200
+ | BF16 logits reused across tiers | **Yes** |
201
+ | llama.cpp revision | `42916d83f4a225e56709f873aa8050ac11f5b6a4` |
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
202
 
203
+ The protocol supports **within-repository paired comparison**. PPL/KLD values from unrelated repositories are not treated as directly comparable unless the corpus, tokenizer path, chunking, context, cache, and runtime procedure are matched.
 
 
204
 
205
+ ## Parent-model benchmark record
206
 
207
+ These scores identify the **parent VeriLoop E2 release**. They are included for model capability context and are **not relabeled as quant-specific results**.
 
 
208
 
209
+ | Benchmark | VeriLoop E2 parent score | Public evidence |
210
  |---|---:|---|
211
  | SWE-bench Pro | **76.2** | [Evidence](https://huggingface.co/datasets/tsinghua-sigs-robot-lab/VeriLoop-E2-Evaluation-Evidence/tree/main/swe-bench-pro) |
212
  | Terminal-Bench 2.1 | **88.8** | [Evidence](https://huggingface.co/datasets/tsinghua-sigs-robot-lab/VeriLoop-E2-Evaluation-Evidence/tree/main/terminal-bench-2.1) |
 
218
  | GPQA Diamond | **93.9** | [Evidence](https://huggingface.co/datasets/tsinghua-sigs-robot-lab/VeriLoop-E2-Evaluation-Evidence/tree/main/gpqa-diamond) |
219
  | Apex 2025 | **89.6** | [Evidence](https://huggingface.co/datasets/tsinghua-sigs-robot-lab/VeriLoop-E2-Evaluation-Evidence/tree/main/apex-2025) |
220
 
221
+ For exact protocols and evaluator receipts, use the **[VeriLoop E2 Evaluation Evidence](https://huggingface.co/datasets/tsinghua-sigs-robot-lab/VeriLoop-E2-Evaluation-Evidence)** repository.
 
 
 
 
222
 
223
+ ## Quick start with llama.cpp
224
 
225
+ Use a recent llama.cpp build with Qwen3.8 support. The frozen Q3 runtime validation used revision `42916d83f4a225e56709f873aa8050ac11f5b6a4`.
 
 
 
 
 
 
 
 
 
 
 
 
 
226
 
227
  ### Download
228
 
229
  ```bash
230
+ # Recommended default
 
 
 
 
 
 
231
  hf download tsinghua-sigs-robot-lab/VeriLoop-E2-GGUF VeriLoop-E2-Q6_K.gguf --local-dir .
232
 
233
+ # Memory-quality sweet spot
234
  hf download tsinghua-sigs-robot-lab/VeriLoop-E2-GGUF VeriLoop-E2-Q5_K_M.gguf --local-dir .
 
235
 
236
+ # Minimum-footprint validated tier
237
+ hf download tsinghua-sigs-robot-lab/VeriLoop-E2-GGUF VeriLoop-E2-Q3_K_M.gguf --local-dir .
238
+
239
+ # High-fidelity low-bit tier
240
+ hf download tsinghua-sigs-robot-lab/VeriLoop-E2-GGUF VeriLoop-E2-Q8_0.gguf --local-dir .
241
+ ```
242
 
243
+ ### Run Q3
244
 
245
  ```bash
246
  llama-server \
247
+ -m ./VeriLoop-E2-Q3_K_M.gguf \
248
+ -ngl 99 \
249
  -c 32768 \
250
  --host 127.0.0.1 \
251
  --port 8080
252
  ```
253
 
254
+ The OpenAI-compatible endpoint is available at `http://127.0.0.1:8080/v1`.
255
 
256
+ `-ngl 99` requests full model-layer GPU offload. It is appropriate only when model weights, KV cache, compute buffers, and runtime workspace fit accelerator memory. Partial offload is supported.
 
 
 
 
 
 
257
 
258
+ ### Q3 + MTP speculative decoding
259
 
260
+ The validated Q3 path can reuse the existing byte-identical 18-tensor Q4_0 MTP companion:
261
 
262
  ```bash
 
 
263
  hf download tsinghua-sigs-robot-lab/VeriLoop-E2-GGUF mtp-VeriLoop-E2-Q5_K_M.gguf --local-dir .
 
 
 
264
 
 
265
  llama-server \
266
+ -m ./VeriLoop-E2-Q3_K_M.gguf \
267
+ --model-draft ./mtp-VeriLoop-E2-Q5_K_M.gguf \
268
+ --gpu-layers-draft 99 \
269
+ --spec-draft-n-max 8 \
270
+ -ngl 99 \
271
+ -c 2048 \
272
  --host 127.0.0.1 \
273
  --port 8080
274
  ```
275
 
276
+ For the frozen Q3 runtime gate, **main-only and main+MTP greedy outputs were byte-identical**; the generated-text SHA256 was `43944ea63376bab89382150a3e4fbcb3739901c82e791abfa7847c13df0391a9` in both runs. MTP acceleration remains workload- and runtime-dependent; no universal speedup is claimed.
277
 
278
+ ## Memory guidance
 
 
279
 
280
+ | Variant | Main file | Practical implication |
281
  |---|---:|---|
282
+ | BF16 | **50.113 GiB** | Reference deployment; substantial RAM/VRAM required |
283
+ | Q8_0 | **26.632 GiB** | High fidelity; larger local footprint |
284
+ | **Q6_K** | **20.566 GiB** | **Default quality / efficiency choice** |
285
+ | **Q5_K_M** | **18.965 GiB** | **Best memory-quality balance below Q6** |
286
+ | Q4_K_M | **18.301 GiB** | Intermediate footprint; its own final runtime/identity still pending in this record |
287
+ | **Q3_K_M** | **16.826 GiB** | **Smallest validated main file; higher distributional drift** |
288
+ | Q5/Q6-compatible MTP | **1.870 GiB** | Optional additional draft-model footprint |
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
289
 
290
+ **A 16.826 GiB model file does not mean a 16 GiB GPU can fully offload it.** The Q3 weights alone exceed 16 GiB, and runtime memory also includes KV cache, compute buffers, allocator overhead, and optional MTP weights. Long-context memory can dominate well before the model's native 262K context limit.
291
 
292
+ ## Throughput status
293
 
294
+ A standalone Q8_0 `llama-bench` record exists (**pp512 3102.722776 tok/s; tg128 41.999677 tok/s**), but there is no frozen paired BF16 throughput run. **No Q6/Q5/Q4/Q3 universal speedup percentage is claimed.** This deliberately separates quantization fidelity from hardware-specific throughput.
295
 
296
+ ## Release policy and current positioning
297
 
298
+ | Tier | Positioning | Evidence status |
299
+ |---|---|---|
300
+ | BF16 | Canonical reference | Verified |
301
+ | Q8_0 | High-fidelity local | Full release quality PASS |
302
+ | **Q6_K** | **Overall sweet spot** | **Full release quality PASS** |
303
+ | **Q5_K_M** | **Memory-constrained quality sweet spot** | **Full release quality PASS** |
304
+ | Q4_K_M | Intermediate mixed-precision candidate | Quantitative QC PASS; own runtime/identity pending |
305
+ | **Q3_K_M** | **Minimum-footprint validated tier** | **Full release PASS; stock runtime + MTP + remote identity verified** |
306
 
307
+ The selection policy prioritizes exact artifact identity, direct-from-BF16 provenance, effective BPW, paired PPL/KLD/token drift, Same top-p, structural integrity, stock-runtime compatibility, and immutable release identity. **Lower bit-count alone is not treated as evidence of a better deployment point.**
308
 
309
+ ## Model identity
 
 
 
 
310
 
311
  | Property | Value |
312
  |---|---|
 
322
  | Languages | English, Chinese |
323
  | GGUF runtime | llama.cpp |
324
  | Reference precision | BF16 |
325
+ | Validated low-bit ladder | Q8_0, Q6_K, Q5_K_M, Q3_K_M; Q4_K_M quantitative candidate |
 
326
  | License | Apache License 2.0 |
327
 
328
+ ## Measurement boundaries
329
 
330
+ - PPL/KLD/token metrics are **quantization-retention measurements**, not universal percentages of downstream capability loss.
331
+ - Q6_K's negative PPL point estimate is not treated as a capability gain; its uncertainty spans BF16 parity.
332
+ - Q3_K_M's **+0.4090% PPL** does not mean a 0.4090% drop on SWE-bench, AIME, GPQA, or any other task benchmark.
333
+ - Parent-model leaderboard scores are not represented as quant-specific re-runs.
334
+ - The Q3 filename does not imply uniform 3-bit storage; the exact mixed-precision tensor policy and 5.37 BPW effective density are disclosed above.
335
+ - Native 262K context comes from the parent configuration; practical context depends on memory and runtime settings.
336
+ - MTP speedup is workload-dependent.
337
+ - The model can still produce incorrect code, mathematics, scientific reasoning, or commands.
338
 
339
+ ## Source model and evidence
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
340
 
341
  | Resource | Link |
342
  |---|---|
343
  | Parent model | [VeriLoop E2](https://huggingface.co/tsinghua-sigs-robot-lab/VeriLoop-E2) |
344
  | GGUF repository | [VeriLoop E2 GGUF](https://huggingface.co/tsinghua-sigs-robot-lab/VeriLoop-E2-GGUF) |
345
  | Quantization quality record | [Quantization Quality](./QUANTIZATION_QUALITY.md) |
346
+ | Artifact identity / release state | [Release Manifest](./RELEASE_MANIFEST.json) |
347
  | Technical report | [OpenReview](https://openreview.net/forum?id=P6FIQILHwX&noteId=P6FIQILHwX) |
348
  | Evaluation evidence | [VeriLoop E2 Evaluation Evidence](https://huggingface.co/datasets/tsinghua-sigs-robot-lab/VeriLoop-E2-Evaluation-Evidence) |
349
  | Riemann ζ artifact | [Public artifact](https://github.com/brucewang123456789/GeniusTrail/tree/VeriLoop-E2/riemann-hypothesis) |
350
  | llama.cpp | [ggml-org/llama.cpp](https://github.com/ggml-org/llama.cpp) |
351
 
 
 
352
  ## License
353
 
354
+ The VeriLoop E2 model weights and this GGUF distribution are released under the **Apache License 2.0**, consistent with the parent model release. Third-party software, benchmarks, and separately published scientific artifacts retain their own terms.
 
 
 
 
355
 
356
  ## Citation
357
 
 
 
358
  ```bibtex
359
  @misc{wang2026veriloope2,
360
  title = {VeriLoop E2: A 27B Post-Trained Model for Code, Mathematics, and Scientific Reasoning},
 
366
  }
367
  ```
368
 
369
+ For quantization-specific comparisons, identify the exact GGUF filename and the corresponding release-manifest identity.
 
 
370
 
371
  ## Acknowledgements
372
 
373
  VeriLoop E2 builds on **Qwen3.8-27B** and the open-source model-serving and evaluation ecosystem. We thank the communities behind Qwen, llama.cpp, Transformers, Hugging Face, software-engineering benchmarks, mathematical evaluation suites, and reproducible scientific computing.
374
 
375
+ This repository treats **reference fidelity, transparent mixed-precision policy, immutable artifact identity, and reproducible stock-runtime validation as first-class release properties**.
RELEASE_MANIFEST.json CHANGED
@@ -1,5 +1,5 @@
1
  {
2
- "schema": "veriloop.e2.gguf.release_manifest.v5",
3
  "repository": "tsinghua-sigs-robot-lab/VeriLoop-E2-GGUF",
4
  "model": {
5
  "name": "VeriLoop E2",
@@ -17,13 +17,16 @@
17
  "quality_method": "paired_BF16_vs_quant_fixed_protocol",
18
  "parent_benchmark_rerun_per_quant": false,
19
  "performance_claim_boundary": "PPL_KLD_token_drift_are_quantization_fidelity_metrics_not_universal_task_score_loss",
20
- "immutable_identity_required_before_public_release": true
 
 
21
  },
22
  "sweet_spots": {
23
  "BF16": "reference_fidelity_sweet_spot",
24
  "Q8_0": "high_fidelity_local_sweet_spot",
25
  "Q6_K": "overall_quality_efficiency_sweet_spot",
26
- "Q5_K_M": "memory_constrained_quality_sweet_spot"
 
27
  },
28
  "toolchains": {
29
  "bf16_conversion": {
@@ -139,6 +142,114 @@
139
  "final_quantitative_gate": "PASS"
140
  },
141
  "validation_run": "q4_k_m_v3_release_candidate_20260925_005537"
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
142
  }
143
  },
144
  "artifacts": {
@@ -300,6 +411,43 @@
300
  "runtime_gate": "PENDING",
301
  "status": "RELEASE_CANDIDATE",
302
  "validation_run": "q4_k_m_v3_release_candidate_20260925_005537"
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
303
  }
304
  },
305
  "artifact_scope": {
@@ -310,7 +458,8 @@
310
  "VeriLoop-E2-Q6_K.gguf",
311
  "mtp-VeriLoop-E2-Q6_K.gguf",
312
  "VeriLoop-E2-Q5_K_M.gguf",
313
- "mtp-VeriLoop-E2-Q5_K_M.gguf"
 
314
  ],
315
  "bf16_mtp_companion": {
316
  "filename": "mtp-VeriLoop-E2-BF16.gguf",
@@ -321,7 +470,14 @@
321
  "release_candidate_set": [
322
  "VeriLoop-E2-Q4_K_M.gguf"
323
  ],
324
- "q4_release_candidate_note": "Q4_K_M has completed direct-from-BF16 build, exact mixed-precision structural audit, and BF16-paired quantitative QC. Public release remains pending final stock-runtime validation and one-time SHA256 identity freeze."
 
 
 
 
 
 
 
325
  },
326
  "quality_protocol": {
327
  "name": "paired_BF16_vs_quant",
@@ -464,6 +620,39 @@
464
  "size_reduction_vs_q6_percent": 11.01276606064805,
465
  "size_reduction_vs_q5_percent": 3.501489730961893,
466
  "quantitative_quality_gate": "PASS"
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
467
  }
468
  },
469
  "release_gates": {
@@ -568,6 +757,60 @@
568
  "main_runtime_generation": "PENDING",
569
  "final_release_identity": "PENDING",
570
  "overall_release_quality_gate": "PENDING_RUNTIME_AND_IDENTITY"
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
571
  }
572
  },
573
  "runtime_validation": {
@@ -612,6 +855,24 @@
612
  "main_model_generation": "PENDING",
613
  "final_release_identity": "PENDING",
614
  "note": "Direct-from-BF16 build, exact mixed-precision structure/policy audit, and paired quantitative fidelity have passed. Final stock llama.cpp runtime validation remains pending."
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
615
  }
616
  },
617
  "remote_repository_verification": {
@@ -632,6 +893,18 @@
632
  "mtp_remote_lfs_sha256": "0e7f2dfe254f3a5d195d105832411acc1007fd7bb9ac980fe9aae4a1f290d671",
633
  "remote_release_gate": "PASS",
634
  "public_release": "PASS"
 
 
 
 
 
 
 
 
 
 
 
 
635
  }
636
  },
637
  "throughput": {
@@ -655,6 +928,11 @@
655
  "paired_speed_protocol_run": false,
656
  "speedup_claimed": false,
657
  "note": "No Q4 throughput speedup claim is made without a frozen paired speed protocol."
 
 
 
 
 
658
  }
659
  },
660
  "release_matrix": {
@@ -694,6 +972,17 @@
694
  "state": "planned",
695
  "role": "compact_4bit_class",
696
  "quality_record": "pending"
 
 
 
 
 
 
 
 
 
 
 
697
  }
698
  },
699
  "current_release_state": {
@@ -701,12 +990,15 @@
701
  "Q8_0": "RELEASED_VERIFIED",
702
  "Q6_K": "RELEASED_VERIFIED_OVERALL_SWEET_SPOT",
703
  "Q5_K_M": "RELEASED_VERIFIED_MEMORY_CONSTRAINED_SWEET_SPOT",
704
- "Q4_K_M": "QUANTITATIVE_QC_PASS_RUNTIME_AND_SHA_PENDING"
 
705
  },
706
  "deployment_recommendation": {
707
  "overall_sweet_spot": "Q6_K",
708
  "memory_constrained_sweet_spot": "Q5_K_M",
709
- "q4_positioning": "validated_mixed_precision_4bit_core_release_candidate",
710
- "basis": "Q6_K preserves BF16 PPL parity within reported uncertainty at 58.96% smaller main-file footprint; Q5_K_M saves a further 7.78% with controlled measured drift; Q4_K_M saves only 3.50% beyond Q5_K_M while Mean KLD rises to 0.009700 and Same top-p falls to 96.786%."
 
 
711
  }
712
  }
 
1
  {
2
+ "schema": "veriloop.e2.gguf.release_manifest.v6",
3
  "repository": "tsinghua-sigs-robot-lab/VeriLoop-E2-GGUF",
4
  "model": {
5
  "name": "VeriLoop E2",
 
17
  "quality_method": "paired_BF16_vs_quant_fixed_protocol",
18
  "parent_benchmark_rerun_per_quant": false,
19
  "performance_claim_boundary": "PPL_KLD_token_drift_are_quantization_fidelity_metrics_not_universal_task_score_loss",
20
+ "immutable_identity_required_before_public_release": true,
21
+ "q3_filename_semantics": "custom_mixed_precision_release_tier_minimum_active_precision_Q3_K_not_uniform_3bit",
22
+ "lower_bit_alone_is_not_a_recommendation_criterion": true
23
  },
24
  "sweet_spots": {
25
  "BF16": "reference_fidelity_sweet_spot",
26
  "Q8_0": "high_fidelity_local_sweet_spot",
27
  "Q6_K": "overall_quality_efficiency_sweet_spot",
28
+ "Q5_K_M": "memory_constrained_quality_sweet_spot",
29
+ "Q3_K_M": "minimum_footprint_validated_tier_not_default_sweet_spot"
30
  },
31
  "toolchains": {
32
  "bf16_conversion": {
 
142
  "final_quantitative_gate": "PASS"
143
  },
144
  "validation_run": "q4_k_m_v3_release_candidate_20260925_005537"
145
+ },
146
+ "q3_quantization_and_qc": {
147
+ "runtime": "llama.cpp",
148
+ "llama_cpp_revision": "42916d83f4a225e56709f873aa8050ac11f5b6a4",
149
+ "quantization_source": "VeriLoop-E2-BF16.gguf",
150
+ "quantization": "custom_mixed_Q3_Q4_Q5_Q6",
151
+ "filename": "VeriLoop-E2-Q3_K_M.gguf",
152
+ "filename_semantics": "release_tier_and_minimum_active_precision_not_uniform_stock_Q3_K_M",
153
+ "direct_from_bf16": true,
154
+ "low_bit_requantization": false,
155
+ "importance_matrix_assisted": true,
156
+ "importance_matrix_sha256": "72d7c3fb0ee839cb591deaa10201fb8e826f1f6b58a6a889f897b02f6381748b",
157
+ "quality_policy_id": "q3_kl_guard_lowest_sensitivity_ffn_down_v1",
158
+ "quantization_threads": 25,
159
+ "quantization_time_seconds": 166.77453,
160
+ "quantized_size_mib_reported_by_quantizer": 17219.08,
161
+ "effective_bpw": 5.37,
162
+ "tensor_type_counts": {
163
+ "F32": 353,
164
+ "Q3_K": 3,
165
+ "Q4_K": 64,
166
+ "Q5_K": 429,
167
+ "Q6_K": 2
168
+ },
169
+ "precision_policy": {
170
+ "Q3_K": {
171
+ "exact_tensors": [
172
+ "blk.1.ffn_down.weight",
173
+ "blk.0.ffn_down.weight",
174
+ "blk.3.ffn_down.weight"
175
+ ],
176
+ "total": 3
177
+ },
178
+ "Q4_K": {
179
+ "*.ffn_up.weight": 64,
180
+ "total": 64
181
+ },
182
+ "Q5_K": {
183
+ "remaining_*.ffn_down.weight": 61,
184
+ "*.ffn_gate.weight": 64,
185
+ "*.attn_qkv.weight": 48,
186
+ "*.attn_q.weight": 16,
187
+ "*.attn_k.weight": 16,
188
+ "*.attn_v.weight": 16,
189
+ "*.attn_output.weight": 16,
190
+ "*.attn_gate.weight": 48,
191
+ "*.ssm_alpha.weight": 48,
192
+ "*.ssm_beta.weight": 48,
193
+ "*.ssm_out.weight": 48,
194
+ "total": 429
195
+ },
196
+ "Q6_K": {
197
+ "output.weight": 1,
198
+ "token_embd.weight": 1,
199
+ "total": 2
200
+ }
201
+ },
202
+ "root_cause_development": {
203
+ "broad_q3_v1": {
204
+ "ppl_ratio": 1.017999,
205
+ "mean_kld": 0.029363,
206
+ "same_top_p_percent": 93.438,
207
+ "result": "FAIL"
208
+ },
209
+ "ffn_up_q3_ablation": {
210
+ "ppl_ratio": 1.015596,
211
+ "mean_kld": 0.02606,
212
+ "same_top_p_percent": 93.976,
213
+ "result": "FAIL",
214
+ "interpretation": "DOMINANT_SINGLE_VARIABLE_ROOT_CAUSE"
215
+ },
216
+ "internal_q6_to_q5_baseline": {
217
+ "ppl_ratio": 1.007813,
218
+ "mean_kld": 0.013292,
219
+ "same_top_p_percent": 96.065,
220
+ "result": "PASS_Q3_HARD_GATE_NO_Q3_TENSORS"
221
+ },
222
+ "ffn_down_full_family_q3": {
223
+ "ppl_ratio": 1.012324,
224
+ "mean_kld": 0.032745,
225
+ "same_top_p_percent": 93.341,
226
+ "result": "FAIL"
227
+ },
228
+ "qkv_full_family_q3": {
229
+ "ppl_ratio": 1.0187,
230
+ "mean_kld": 0.026723,
231
+ "same_top_p_percent": 94.086,
232
+ "result": "FAIL"
233
+ },
234
+ "imatrix_33_tensor_shortlist": {
235
+ "ppl_ratio": 1.002662,
236
+ "mean_kld": 0.018066,
237
+ "same_top_p_percent": 95.528,
238
+ "result": "FAIL_KLD"
239
+ },
240
+ "final_kl_guard": {
241
+ "q3_tensor_count": 3,
242
+ "ppl_ratio": 1.00409,
243
+ "mean_kld": 0.014349,
244
+ "same_top_p_percent": 95.919,
245
+ "hard_gate": "PASS",
246
+ "engineering_reserve_gate": "PASS"
247
+ }
248
+ },
249
+ "importance_matrix_entries": 496,
250
+ "importance_matrix_chunks": 582,
251
+ "importance_matrix_bytes": 13642752,
252
+ "validation_run": "q3_kl_guard_release_candidate_20260925_024427"
253
  }
254
  },
255
  "artifacts": {
 
411
  "runtime_gate": "PENDING",
412
  "status": "RELEASE_CANDIDATE",
413
  "validation_run": "q4_k_m_v3_release_candidate_20260925_005537"
414
+ },
415
+ "VeriLoop-E2-Q3_K_M.gguf": {
416
+ "tier": "Q3_K_M",
417
+ "role": "minimum_footprint_validated_main",
418
+ "quantization": "custom_mixed_Q3_Q4_Q5_Q6",
419
+ "filename_semantics": "not_uniform_stock_Q3_K_M",
420
+ "source": "VeriLoop-E2-BF16.gguf",
421
+ "direct_from_bf16": true,
422
+ "low_bit_requantization": false,
423
+ "bytes": 18066506496,
424
+ "decimal_gb": 18.066506496,
425
+ "binary_gib": 16.825745344161987,
426
+ "sha256": "c2e9539cfb85d87a99605b6914ed602c0fa750164c153ce5574710123aba06fe",
427
+ "sha256_state": "FROZEN",
428
+ "tensor_count": 851,
429
+ "f32_tensor_count": 353,
430
+ "q3_k_tensor_count": 3,
431
+ "q4_k_tensor_count": 64,
432
+ "q5_k_tensor_count": 429,
433
+ "q6_k_tensor_count": 2,
434
+ "effective_bpw": 5.37,
435
+ "quantized_size_mib_reported_by_quantizer": 17219.08,
436
+ "quantization_time_seconds": 166.77453,
437
+ "importance_matrix_sha256": "72d7c3fb0ee839cb591deaa10201fb8e826f1f6b58a6a889f897b02f6381748b",
438
+ "quality_policy_id": "q3_kl_guard_lowest_sensitivity_ffn_down_v1",
439
+ "structure_gate": "PASS",
440
+ "precision_policy_gate": "PASS",
441
+ "quantitative_quality_gate": "PASS",
442
+ "engineering_reserve_gate": "PASS",
443
+ "runtime_gate": "PASS",
444
+ "mtp_runtime_gate": "PASS",
445
+ "speculative_output_identity_gate": "PASS",
446
+ "remote_release_gate": "PASS",
447
+ "status": "VERIFIED",
448
+ "remote_exact_size_gate": "PASS",
449
+ "remote_lfs_sha256_gate": "PASS",
450
+ "remote_readability_gate": "PASS"
451
  }
452
  },
453
  "artifact_scope": {
 
458
  "VeriLoop-E2-Q6_K.gguf",
459
  "mtp-VeriLoop-E2-Q6_K.gguf",
460
  "VeriLoop-E2-Q5_K_M.gguf",
461
+ "mtp-VeriLoop-E2-Q5_K_M.gguf",
462
+ "VeriLoop-E2-Q3_K_M.gguf"
463
  ],
464
  "bf16_mtp_companion": {
465
  "filename": "mtp-VeriLoop-E2-BF16.gguf",
 
470
  "release_candidate_set": [
471
  "VeriLoop-E2-Q4_K_M.gguf"
472
  ],
473
+ "q4_release_candidate_note": "Q4_K_M has completed direct-from-BF16 build, exact mixed-precision structural audit, and BF16-paired quantitative QC. Public release remains pending final stock-runtime validation and one-time SHA256 identity freeze.",
474
+ "q3_release_note": "Q3_K_M is a root-cause-guided mixed-precision artifact with 3 Q3_K tensors and 5.37 effective BPW. Structure, BF16-paired quality, engineering reserve, stock llama.cpp runtime, MTP runtime, immutable SHA256 identity, and Hugging Face remote release verification are PASS.",
475
+ "q3_mtp_compatibility": {
476
+ "dedicated_duplicate_file_required": false,
477
+ "validated_mtp_bytes": 2008056096,
478
+ "validated_mtp_sha256": "0e7f2dfe254f3a5d195d105832411acc1007fd7bb9ac980fe9aae4a1f290d671",
479
+ "note": "The validated Q3 MTP object is byte-identical to the published 18-tensor Q4_0 Q5/Q6 companion."
480
+ }
481
  },
482
  "quality_protocol": {
483
  "name": "paired_BF16_vs_quant",
 
620
  "size_reduction_vs_q6_percent": 11.01276606064805,
621
  "size_reduction_vs_q5_percent": 3.501489730961893,
622
  "quantitative_quality_gate": "PASS"
623
+ },
624
+ "Q3_K_M": {
625
+ "mean_ppl": 4.860222,
626
+ "ppl_uncertainty": 0.120606,
627
+ "absolute_ppl_delta": 0.019799,
628
+ "absolute_ppl_delta_uncertainty": 0.010554,
629
+ "ppl_ratio": 1.00409,
630
+ "ppl_ratio_uncertainty": 0.002181,
631
+ "relative_ppl_change_percent_observed": 0.409,
632
+ "ln_ppl_ratio": 0.004082,
633
+ "ln_ppl_ratio_uncertainty": 0.002172,
634
+ "log_ppl_correlation_percent": 99.62,
635
+ "mean_kld": 0.014349,
636
+ "mean_kld_uncertainty": 0.001985,
637
+ "median_kld": 0.003572,
638
+ "kld_p90": 0.022146,
639
+ "kld_p95": 0.03835,
640
+ "kld_p99": 0.123439,
641
+ "kld_p999": 0.664245,
642
+ "max_kld": 13.526417,
643
+ "mean_delta_p_percent": -0.065,
644
+ "mean_delta_p_uncertainty_percent": 0.039,
645
+ "rms_delta_p_percent": 3.515,
646
+ "rms_delta_p_uncertainty_percent": 0.228,
647
+ "same_top_p_percent": 95.919,
648
+ "same_top_p_uncertainty_percent": 0.219,
649
+ "size_reduction_vs_bf16_percent": 66.42430281552929,
650
+ "size_reduction_vs_q8_percent": 36.821042846987105,
651
+ "size_reduction_vs_q6_percent": 18.186436150261308,
652
+ "size_reduction_vs_q5_percent": 11.280678342229766,
653
+ "size_reduction_vs_q4_percent": 8.06145979826991,
654
+ "quantitative_quality_gate": "PASS",
655
+ "engineering_reserve_gate": "PASS"
656
  }
657
  },
658
  "release_gates": {
 
757
  "main_runtime_generation": "PENDING",
758
  "final_release_identity": "PENDING",
759
  "overall_release_quality_gate": "PENDING_RUNTIME_AND_IDENTITY"
760
+ },
761
+ "Q3_K_M": {
762
+ "bf16_baseline_identity": "PASS",
763
+ "ppl_ratio": {
764
+ "hard_threshold_max": 1.015,
765
+ "reserve_threshold_max": 1.0135,
766
+ "measured": 1.00409,
767
+ "hard_result": "PASS",
768
+ "reserve_result": "PASS"
769
+ },
770
+ "mean_kld": {
771
+ "hard_threshold_max": 0.015,
772
+ "reserve_threshold_max": 0.0145,
773
+ "measured": 0.014349,
774
+ "hard_result": "PASS",
775
+ "reserve_result": "PASS"
776
+ },
777
+ "same_top_p_percent": {
778
+ "hard_threshold_min": 95.0,
779
+ "reserve_threshold_min": 95.5,
780
+ "measured": 95.919,
781
+ "hard_result": "PASS",
782
+ "reserve_result": "PASS"
783
+ },
784
+ "main_tensor_count": {
785
+ "expected": 851,
786
+ "measured": 851,
787
+ "result": "PASS"
788
+ },
789
+ "mixed_precision_policy": {
790
+ "expected_counts": {
791
+ "F32": 353,
792
+ "Q3_K": 3,
793
+ "Q4_K": 64,
794
+ "Q5_K": 429,
795
+ "Q6_K": 2
796
+ },
797
+ "mismatch_count": 0,
798
+ "result": "PASS"
799
+ },
800
+ "quantitative_quality_gate": "PASS",
801
+ "engineering_reserve_gate": "PASS",
802
+ "main_runtime_generation": "PASS",
803
+ "mtp_runtime_load": "PASS",
804
+ "mtp_runtime_generation": "PASS",
805
+ "mtp_log_evidence": "PASS",
806
+ "speculative_output_identity": "PASS",
807
+ "final_release_identity": "FROZEN",
808
+ "remote_release_verification": "PASS",
809
+ "overall_local_release_quality_gate": "PASS",
810
+ "remote_exact_size_verification": "PASS",
811
+ "remote_full_sha256_verification": "PASS",
812
+ "remote_readability_verification": "PASS",
813
+ "overall_release_quality_gate": "PASS"
814
  }
815
  },
816
  "runtime_validation": {
 
855
  "main_model_generation": "PENDING",
856
  "final_release_identity": "PENDING",
857
  "note": "Direct-from-BF16 build, exact mixed-precision structure/policy audit, and paired quantitative fidelity have passed. Final stock llama.cpp runtime validation remains pending."
858
+ },
859
+ "Q3_K_M": {
860
+ "stock_llama_cpp_only": true,
861
+ "veriloop_harness_used": false,
862
+ "llama_cpp_revision": "42916d83f4a225e56709f873aa8050ac11f5b6a4",
863
+ "validated_context_tokens": 2048,
864
+ "main_model_load": "PASS",
865
+ "main_model_generation": "PASS",
866
+ "mtp_interface": "PASS",
867
+ "mtp_load": "PASS",
868
+ "mtp_generation": "PASS",
869
+ "mtp_log_evidence": "PASS",
870
+ "speculative_output_identity": "PASS",
871
+ "main_only_text_sha256": "43944ea63376bab89382150a3e4fbcb3739901c82e791abfa7847c13df0391a9",
872
+ "main_plus_mtp_text_sha256": "43944ea63376bab89382150a3e4fbcb3739901c82e791abfa7847c13df0391a9",
873
+ "mtp_bytes": 2008056096,
874
+ "mtp_sha256": "0e7f2dfe254f3a5d195d105832411acc1007fd7bb9ac980fe9aae4a1f290d671",
875
+ "runtime_mtp_gate": "PASS"
876
  }
877
  },
878
  "remote_repository_verification": {
 
893
  "mtp_remote_lfs_sha256": "0e7f2dfe254f3a5d195d105832411acc1007fd7bb9ac980fe9aae4a1f290d671",
894
  "remote_release_gate": "PASS",
895
  "public_release": "PASS"
896
+ },
897
+ "Q3_K_M": {
898
+ "state": "PASS",
899
+ "remote_path": "VeriLoop-E2-Q3_K_M.gguf",
900
+ "main_remote_bytes": 18066506496,
901
+ "main_remote_lfs_sha256": "c2e9539cfb85d87a99605b6914ed602c0fa750164c153ce5574710123aba06fe",
902
+ "remote_exact_size_gate": "PASS",
903
+ "remote_full_sha256_gate": "PASS",
904
+ "remote_readability_gate": "PASS",
905
+ "remote_head_identity_gate": "PASS",
906
+ "remote_tail_identity_gate": "PASS",
907
+ "remote_release_gate": "PASS"
908
  }
909
  },
910
  "throughput": {
 
928
  "paired_speed_protocol_run": false,
929
  "speedup_claimed": false,
930
  "note": "No Q4 throughput speedup claim is made without a frozen paired speed protocol."
931
+ },
932
+ "Q3_K_M": {
933
+ "paired_speed_protocol_run": false,
934
+ "speedup_claimed": false,
935
+ "note": "Stock runtime and MTP correctness are validated. No universal speedup claim is made without a frozen paired throughput protocol."
936
  }
937
  },
938
  "release_matrix": {
 
972
  "state": "planned",
973
  "role": "compact_4bit_class",
974
  "quality_record": "pending"
975
+ },
976
+ "Q3_K_M": {
977
+ "state": "verified_release",
978
+ "role": "minimum_footprint_validated_tier",
979
+ "quality_record": "PASS",
980
+ "engineering_reserve_record": "PASS",
981
+ "runtime_record": "PASS",
982
+ "mtp_record": "PASS",
983
+ "release_identity": "FROZEN",
984
+ "remote_release": "PASS",
985
+ "overall_release": "PASS"
986
  }
987
  },
988
  "current_release_state": {
 
990
  "Q8_0": "RELEASED_VERIFIED",
991
  "Q6_K": "RELEASED_VERIFIED_OVERALL_SWEET_SPOT",
992
  "Q5_K_M": "RELEASED_VERIFIED_MEMORY_CONSTRAINED_SWEET_SPOT",
993
+ "Q4_K_M": "QUANTITATIVE_QC_PASS_RUNTIME_AND_SHA_PENDING",
994
+ "Q3_K_M": "VERIFIED_RELEASE"
995
  },
996
  "deployment_recommendation": {
997
  "overall_sweet_spot": "Q6_K",
998
  "memory_constrained_sweet_spot": "Q5_K_M",
999
+ "minimum_footprint_validated_tier": "Q3_K_M",
1000
+ "q4_positioning": "validated_intermediate_mixed_precision_candidate",
1001
+ "q3_positioning": "footprint_first_not_default_sweet_spot",
1002
+ "basis": "Q6_K preserves BF16 PPL parity within reported uncertainty at 58.96% smaller main-file footprint. Q5_K_M saves a further 7.78% with controlled measured drift. Q3_K_M is 66.42% smaller than BF16 and 11.28% smaller than Q5_K_M, but Mean KLD rises to 0.014349 and Same top-p falls to 95.919%, so Q3 is the minimum-footprint validated tier rather than the balance optimum."
1003
  }
1004
  }