deucebucket commited on
Commit
67dd37f
Β·
verified Β·
1 Parent(s): 5a405d1

docs: rewrite card around 14GB recommended build; benches in Evaluations; trim legacy v1/v3 clutter

Browse files
Files changed (1) hide show
  1. README.md +30 -82
README.md CHANGED
@@ -76,118 +76,66 @@ model-index:
76
  metrics:
77
  - name: pass@1
78
  type: pass@1
79
- value: 0.652
80
  source:
81
  name: Local benchmark run (RTX 3090, llama.cpp)
82
  url: https://huggingface.co/deucebucket/Qwen3.6-35B-A3B-Cerebellum-GGUF/tree/main/benchmark_results
83
  ---
84
 
85
- ## 14 GB variant β€” recommended (the sweet spot)
86
-
87
- `Qwen3.6-35B-A3B-Cerebellum-14GB.gguf` β€” 14.0 GB, 3.34 bpw. Q3_K_M base + Q4_K on the routed `ffn_down_exps` (ablation-informed).
88
-
89
- Size ladder (1x RTX 3090, llama.cpp; HumanEval/+ via upstream EvalPlus, greedy temp 0, n=164):
90
-
91
- | build | size | HumanEval / HumanEval+ |
92
- |---|---|---|
93
- | micro | 11.96 GB | 90.9 / 87.2 |
94
- | **14 GB** | **14.0 GB** | **93.3 / 90.2** |
95
- | uniform Q3_K_M | 16.0 GB | 91.5 / 89.0 |
96
- | Base | 17.3 GB | 92.7 / 89.0 |
97
-
98
- The 14 GB build has the highest HumanEval of the family β€” above the 16 GB uniform Q3_K_M (-2 GB) and matching the 17.3 GB Base (-3.3 GB). Long-context needle recall passes to 90K+. Decode ~168 tok/s (3B-active MoE); fits 160K+ context at ~19 GB on a 24 GB card.
99
-
100
- Launch (single card): `llama-server -m Qwen3.6-35B-A3B-Cerebellum-14GB.gguf -ngl 99 -fa on --reasoning off`. Evidence: `benchmark_results/14gb/`.
101
-
102
- ---
103
-
104
  <p align="center">
105
  <img src="cerebellum_banner.png" alt="Cerebellum" width="640">
106
  </p>
107
 
108
  # Qwen 3.6 35B-A3B β€” Cerebellum GGUF
109
 
110
- Sensitivity-guided mixed-precision quantization of [Qwen/Qwen3.6-35B-A3B](https://huggingface.co/Qwen/Qwen3.6-35B-A3B). Two variants available:
111
 
112
- | Variant | File | Size | BPW |
113
- |---------|------|------|-----|
114
- | **Cerebellum v3** (recommended) | `Qwen3.6-35B-A3B-Cerebellum-v3-Q3_K_M.gguf` | **11 GB** | 2.76 |
115
- | Cerebellum v1 (legacy) | `Qwen3.6-35B-A3B-Cerebellum-Q3_K_M.gguf` | 12 GB | 2.73 |
116
 
117
- Cerebellum measures which weight groups survive extreme compression and which don't, then writes a single GGUF with per-tensor precision assignments. v3 uses 360 tensor-level overrides guided by group ablation and reverse ablation analysis.
118
 
119
- ## Benchmarks
120
 
121
- All benchmarks measured directly on these GGUF files using llama.cpp inference with cleaned evaluation harness.
 
 
 
 
 
122
 
123
- The model-index metadata in this card's frontmatter mirrors the recommended v3 build. Protocol: local llama.cpp chat harness on RTX 3090, temperature 0, no thinking mode. Full per-question artifacts are in `benchmark_results/v3/`.
124
 
125
- | Benchmark | **v3 (11 GB)** | v1 (12 GB) | Q3_K_M (15.6 GB) |
126
- |-----------|:---:|:---:|:---:|
127
- | **ARC-Challenge** | **95.8%** | 94.8% | 96.1% |
128
- | **HellaSwag** | **92.3%** | 91.5% | 91.5% |
129
- | **MMLU-Redux** | **75.0%** | 73.9% | 74.1% |
130
- | **HumanEval base** | **70.7%** | β€” | 64.0% |
131
- | **HumanEval+** | **65.2%** | β€” | 56.7% |
132
- | Vision smoke (36 images) | **100%** | 100% | β€” |
133
 
134
- v3 at 11 GB is **29% smaller** than stock Q3_K_M (15.6 GB) while outperforming it on 4 of the 5 measured benchmarks (ARC is the one it loses; the vision check has no Q3_K_M baseline to compare). The Q2_K regularization effect on gate/mixing weights actively improves downstream task performance despite reducing perplexity.
135
-
136
- ## v3 Allocation
137
-
138
- | Group | Precision | Rationale |
139
- |-------|-----------|-----------|
140
- | `attn_qkv` | Q3_K_M | Critical for vision and attention routing |
141
- | `ssm_out` | Q3_K_M | Most sensitive tensor per ablation (+0.24 PPL) |
142
- | `ffn_gate_exps` | Q2_K | Q2_K regularization outperforms Q3_K_M |
143
- | `ffn_up_exps` | Q2_K | Q2_K regularization outperforms Q3_K_M |
144
- | `ffn_down_exps` | Q2_K | Acceptable loss for size savings |
145
- | `ffn_gate_shexp` | Q2_K | Q2_K regularization outperforms Q3_K_M |
146
- | `ffn_up_shexp` | Q2_K | Q2_K regularization outperforms Q3_K_M |
147
- | `ffn_down_shexp` | Q2_K | Q2_K regularization outperforms Q3_K_M |
148
- | `attn_gate` | Q2_K | Q2_K regularization outperforms Q3_K_M |
149
- | `ssm_alpha`, `ssm_beta` | Q2_K | Q2_K regularization outperforms Q3_K_M |
150
-
151
- Protected: all norms (F32), SSM state params (F32), router tensors (default).
152
-
153
- ## Ablation Data
154
-
155
- Full ablation methodology and results are in the `ablation/` directory:
156
-
157
- - `group_ablation_results.log` β€” Forward ablation: demote each group to Q2_K, measure PPL
158
- - `reverse_ablation_results.log` β€” Reverse ablation: from fully-demoted v1, restore each group
159
- - `cerebellum_v3_overrides.txt` β€” The 360-line tensor type override file used for v3
160
-
161
- Key finding from reverse ablation: **7 of 10 groups perform better at Q2_K than Q3_K_M** β€” imatrix-guided Q2_K acts as beneficial regularization on gate, mixing, and shared expert weights.
162
 
163
  ## Usage
164
 
165
  ```bash
166
- # v3 (recommended, 11 GB)
167
- llama-server --model Qwen3.6-35B-A3B-Cerebellum-v3-Q3_K_M.gguf \
168
- --mmproj mmproj-F16.gguf --n-gpu-layers 99 --ctx-size 8192
169
 
170
- # v1 (legacy, 12 GB)
171
- llama-server --model Qwen3.6-35B-A3B-Cerebellum-Q3_K_M.gguf \
172
- --mmproj mmproj-F16.gguf --n-gpu-layers 99 --ctx-size 8192
173
  ```
174
 
175
  ## Files
176
 
177
- | File | Size | Description |
178
- |------|------|-------------|
179
- | `Qwen3.6-35B-A3B-Cerebellum-v3-Q3_K_M.gguf` | 11 GB | v3 β€” recommended, 29% smaller than Q3_K_M |
180
- | `Qwen3.6-35B-A3B-Cerebellum-Q3_K_M.gguf` | 12 GB | v1 β€” legacy |
181
- | `mmproj-F16.gguf` | 858 MB | Vision projection (F16) |
182
- | `benchmark_results/v3/` | β€” | Full benchmark JSON artifacts for v3 |
183
- | `ablation/` | β€” | Ablation logs and override files |
184
 
185
  ## Methodology
186
 
187
- Built with [Cerebellum](https://github.com/deucebucket/cerebellum) β€” sensitivity-guided mixed-precision quantization. v3 uses unsloth coder imatrix for importance-weighted quantization within each precision level.
188
-
189
- Quantized by [@deucebucket](https://huggingface.co/deucebucket).
190
 
191
  ## Independent records
192
 
193
- This build has a recorded data point in [club-3090's BENCHMARKS](https://github.com/noonghunna/club-3090/blob/master/BENCHMARKS.md) (author-rig numbers from a full `report.sh --full` chain: bench n=5, verify-full pass, soak-continuous pass). The same report led to a correction of their engine support table for this model ([issue #390](https://github.com/noonghunna/club-3090/issues/390), [PR #393](https://github.com/noonghunna/club-3090/pull/393)). The numbers there are author-reported, not club-validated.
 
76
  metrics:
77
  - name: pass@1
78
  type: pass@1
79
+ value: 0.902
80
  source:
81
  name: Local benchmark run (RTX 3090, llama.cpp)
82
  url: https://huggingface.co/deucebucket/Qwen3.6-35B-A3B-Cerebellum-GGUF/tree/main/benchmark_results
83
  ---
84
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
85
  <p align="center">
86
  <img src="cerebellum_banner.png" alt="Cerebellum" width="640">
87
  </p>
88
 
89
  # Qwen 3.6 35B-A3B β€” Cerebellum GGUF
90
 
91
+ Sensitivity-guided mixed-precision quantization of [Qwen/Qwen3.6-35B-A3B](https://huggingface.co/Qwen/Qwen3.6-35B-A3B). Cerebellum measures which weight groups survive extreme compression and which don't, then writes a single GGUF with per-tensor precision assignments β€” a standard GGUF that runs on stock `llama.cpp`, no fork.
92
 
93
+ | Variant | File | Size | BPW | Best for |
94
+ |---------|------|------|-----|----------|
95
+ | **14 GB** (recommended) | `Qwen3.6-35B-A3B-Cerebellum-14GB.gguf` | **14.0 GB** | 3.34 | best coding, 160K+ context |
96
+ | v3 (smallest) | `Qwen3.6-35B-A3B-Cerebellum-v3-Q3_K_M.gguf` | 11 GB | 2.76 | tightest VRAM, vision |
97
 
98
+ ## Evaluations
99
 
100
+ Coding β€” upstream EvalPlus (`evalplus.codegen` against `llama-server`, greedy / temp 0, n=164), same protocol across the size ladder:
101
 
102
+ | build | size | HumanEval | HumanEval+ |
103
+ |-------|------|:---:|:---:|
104
+ | micro | 11.96 GB | 90.9 | 87.2 |
105
+ | **14 GB (recommended)** | **14.0 GB** | **93.3** | **90.2** |
106
+ | uniform Q3_K_M | 16.0 GB | 91.5 | 89.0 |
107
+ | Base | 17.3 GB | 92.7 | 89.0 |
108
 
109
+ Long-context: needle recall passes to 90K+ (`verify-stress`). Throughput: ~168 tok/s decode (3B-active MoE); fits 160K+ context at ~19 GB on a 24 GB card. Per-question artifacts in `benchmark_results/14gb/`.
110
 
111
+ ## Why the 14 GB over v3
 
 
 
 
 
 
 
112
 
113
+ v3 (11 GB) is the tightest-VRAM build. The 14 GB spends ~3 GB more to promote the routed `ffn_down_exps` to Q4_K β€” the group the ablation identifies as where the quality lives β€” and that gives it the family's **best coding** plus 160K+ context headroom. It posts above the 16 GB uniform Q3_K_M (βˆ’2 GB) and matches the 17.3 GB Base (βˆ’3.3 GB): the Base's extra promotions buy ~0 coding, so 14 GB is the efficient point. Pick v3 only when VRAM is tight or you need the vision projector.
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
114
 
115
  ## Usage
116
 
117
  ```bash
118
+ # 14 GB (recommended)
119
+ llama-server -m Qwen3.6-35B-A3B-Cerebellum-14GB.gguf -ngl 99 -fa on --reasoning off
 
120
 
121
+ # v3 (smallest, with vision)
122
+ llama-server -m Qwen3.6-35B-A3B-Cerebellum-v3-Q3_K_M.gguf --mmproj mmproj-F16.gguf -ngl 99 -c 8192
 
123
  ```
124
 
125
  ## Files
126
 
127
+ | File | Size | Notes |
128
+ |------|------|-------|
129
+ | `Qwen3.6-35B-A3B-Cerebellum-14GB.gguf` | 14 GB | recommended β€” best coding, 160K+ ctx |
130
+ | `Qwen3.6-35B-A3B-Cerebellum-v3-Q3_K_M.gguf` | 11 GB | smallest; vision (with mmproj) |
131
+ | `mmproj-F16.gguf` | 858 MB | vision projector (F16) |
132
+ | `benchmark_results/` | β€” | per-question evaluation artifacts |
133
+ | `ablation/` | β€” | ablation logs + tensor override maps |
134
 
135
  ## Methodology
136
 
137
+ Built with [Cerebellum](https://github.com/deucebucket/cerebellum) β€” sensitivity-guided mixed-precision quantization: crush each tensor group, measure the impact, allocate precision under a size budget, output a plain GGUF. imatrix-calibrated. Quantized by [@deucebucket](https://huggingface.co/deucebucket).
 
 
138
 
139
  ## Independent records
140
 
141
+ This line has a recorded data point in [club-3090's BENCHMARKS](https://github.com/noonghunna/club-3090/blob/master/BENCHMARKS.md) (author-rig numbers from a full `report.sh --full` chain). The same report corrected their engine-support table for this model ([issue #390](https://github.com/noonghunna/club-3090/issues/390), [PR #393](https://github.com/noonghunna/club-3090/pull/393)). Numbers there are author-reported, not club-validated.