1337Hero commited on
Commit
6ec1471
·
verified ·
1 Parent(s): cb34ec9

Upload folder using huggingface_hub

Browse files
.gitattributes CHANGED
@@ -33,3 +33,5 @@ saved_model/**/* filter=lfs diff=lfs merge=lfs -text
33
  *.zip filter=lfs diff=lfs merge=lfs -text
34
  *.zst filter=lfs diff=lfs merge=lfs -text
35
  *tfevents* filter=lfs diff=lfs merge=lfs -text
 
 
 
33
  *.zip filter=lfs diff=lfs merge=lfs -text
34
  *.zst filter=lfs diff=lfs merge=lfs -text
35
  *tfevents* filter=lfs diff=lfs merge=lfs -text
36
+ KAT-Coder-V2.5-Dev-Q4_0_ROCMFP4.gguf filter=lfs diff=lfs merge=lfs -text
37
+ KAT-Coder-V2.5-Dev-Q4_0_ROCMFP4_STRIX_LEAN.gguf filter=lfs diff=lfs merge=lfs -text
KAT-Coder-V2.5-Dev-Q4_0_ROCMFP4.gguf ADDED
@@ -0,0 +1,3 @@
 
 
 
 
1
+ version https://git-lfs.github.com/spec/v1
2
+ oid sha256:f87c3f509c487876dc76d8a7606583faa1a3cbd04407b288c36dd2031b2cd92f
3
+ size 22741457056
KAT-Coder-V2.5-Dev-Q4_0_ROCMFP4_STRIX_LEAN.gguf ADDED
@@ -0,0 +1,3 @@
 
 
 
 
1
+ version https://git-lfs.github.com/spec/v1
2
+ oid sha256:857d39a696d448a9349a000ffdd5811c88761df59ec7d5a67e7ada3ac46a8161
3
+ size 18597337248
README.md ADDED
@@ -0,0 +1,210 @@
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
1
+ ---
2
+ license: apache-2.0
3
+ base_model: Kwaipilot/KAT-Coder-V2.5-Dev
4
+ base_model_relation: quantized
5
+ pipeline_tag: text-generation
6
+ language:
7
+ - en
8
+ - zh
9
+ quantized_by: 1337Hero
10
+ tags:
11
+ - gguf
12
+ - kat-coder
13
+ - quantized
14
+ - rocm
15
+ - amd
16
+ - rdna4
17
+ - gfx1201
18
+ - vulkan
19
+ - moe
20
+ - code
21
+ - experimental
22
+ ---
23
+
24
+ # KAT-Coder-V2.5-Dev — ROCmFP4 GGUF (experimental, AMD RDNA4 / gfx1201)
25
+
26
+ Two experimental 4-bit quantizations of
27
+ [Kwaipilot/KAT-Coder-V2.5-Dev](https://huggingface.co/Kwaipilot/KAT-Coder-V2.5-Dev),
28
+ a 34.66B-parameter MoE coding model (256 experts, 8 active, 256K context,
29
+ `qwen35moe` architecture). Converted and quantized on a Radeon AI PRO R9700
30
+ (`gfx1201`, RDNA4).
31
+
32
+ > [!IMPORTANT]
33
+ > These files do **not** run on upstream llama.cpp, Ollama, LM Studio, or
34
+ > vLLM. They use the custom `Q4_0_ROCMFP4` tensor layouts and require a
35
+ > [ROCmFPX](https://github.com/charlie12345/ROCmFPX) build as described below.
36
+ > Unsupported runtimes should reject the files; if a tool appears to load one
37
+ > anyway, do not trust the output.
38
+
39
+ > [!WARNING]
40
+ > Both files load, generate coherent output, and were throughput-benchmarked
41
+ > on RDNA4 `gfx1201`. That is the **only** validation performed. No Strix Halo
42
+ > testing and **no quality evaluation of any kind** — see [What was not
43
+ > measured](#what-was-not-measured) before relying on either file.
44
+
45
+ ## Which file?
46
+
47
+ | File | Size | Effective BPW | Pick it if |
48
+ | --- | ---: | ---: | --- |
49
+ | `KAT-Coder-V2.5-Dev-Q4_0_ROCMFP4_STRIX_LEAN.gguf` | 17.32 GiB | 4.29 | You want the smaller, faster file. Recommended default. |
50
+ | `KAT-Coder-V2.5-Dev-Q4_0_ROCMFP4.gguf` | 21.18 GiB | 5.25 | You want more bits on the expert down-projections. |
51
+
52
+ `STRIX_LEAN` is 18% smaller *and* measurably faster on both backends, so it is
53
+ the recommended starting point despite the Strix-oriented name. The recipe was
54
+ tuned on `gfx1151`; nothing about the file format is Strix-specific.
55
+
56
+ ## Why the sizes differ from the nominal BPW
57
+
58
+ Both presets apply tensor-aware routing, and on a 256-expert MoE the expert
59
+ tensors dominate the file. The routing difference between the two is almost
60
+ entirely one tensor family:
61
+
62
+ | Tensor | `Q4_0_ROCMFP4` | `Q4_0_ROCMFP4_STRIX_LEAN` |
63
+ | --- | --- | --- |
64
+ | `ffn_down_exps` | `q6_K` | `q4_0_rocmfp4_fast` |
65
+ | `ffn_gate_exps` / `ffn_up_exps` | `q4_0_rocmfp4` | `q4_0_rocmfp4_fast` |
66
+ | `attn_qkv` | `q5_K` | Strix attn K/V recipe |
67
+ | `token_embd` | `q6_K` | `q5_K` |
68
+
69
+ That is why `Q4_0_ROCMFP4` lands at 5.25 BPW rather than its nominal 4.50 —
70
+ `ffn_down_exps` alone is roughly a third of the model's parameters.
71
+
72
+ ## Measured throughput — Radeon AI PRO R9700, `gfx1201`
73
+
74
+ `llama-bench`, `pp512` + `tg128`, 3 repetitions, full offload, FlashAttention
75
+ on, one model resident at a time on an otherwise idle GPU.
76
+
77
+ | Backend | Quant | Prompt fill `pp512` t/s | Decode `tg128` t/s |
78
+ | --- | --- | ---: | ---: |
79
+ | Vulkan0 | **`STRIX_LEAN`** | **3278.14 ± 50.90** | **122.27 ± 1.27** |
80
+ | Vulkan0 | `Q4_0_ROCMFP4` | 3120.99 ± 17.61 | 107.80 ± 1.02 |
81
+ | ROCm0 | `STRIX_LEAN` | 2598.84 ± 5.06 | 59.39 ± 0.19 |
82
+ | ROCm0 | `Q4_0_ROCMFP4` | 1787.51 ± 74.26 | 52.51 ± 0.26 |
83
+
84
+ Two results worth acting on:
85
+
86
+ - **Use Vulkan on this hardware.** Vulkan decodes roughly **2× faster** than
87
+ HIP/ROCm for both files (122 vs 59 t/s on `STRIX_LEAN`) and also leads on
88
+ prompt fill. This matches ROCmFPX's own Strix Halo findings.
89
+ - **`STRIX_LEAN` wins on both axes.** It is 18% smaller *and* faster —
90
+ +13% decode and +5% prefill on Vulkan, +13% decode and +45% prefill on ROCm.
91
+
92
+ No control quant (Q4_K_M or similar) was benchmarked, so these numbers compare
93
+ the two ROCmFP4 files against each other, not against ordinary GGUF quants.
94
+
95
+ ## What was not measured
96
+
97
+ - **Output quality.** No perplexity, KL-divergence, HumanEval, or MBPP
98
+ comparison against the BF16 source. Neither file has been quality-checked at
99
+ all.
100
+ - **Agentic and tool-calling behavior**, which is the point of a coding model.
101
+ Untested.
102
+ - **Any hardware other than `gfx1201`.** Not tested on Strix Halo, RDNA3,
103
+ RDNA2, or CPU.
104
+ - **Long context.** Benchmarked at `pp512`/`tg128`; the model claims 262144.
105
+ Deep-context behavior and KV-cache pressure are unmeasured.
106
+ - **Batch > 1 / concurrent requests.** Single-stream only.
107
+ - **A non-ROCmFPX control quant.** The two files were compared to each other,
108
+ not to Q4_K_M.
109
+
110
+ ## Required runtime
111
+
112
+ ```bash
113
+ git clone https://github.com/charlie12345/ROCmFPX.git
114
+ cd ROCmFPX && git checkout main # built and quantized at commit db6844d
115
+
116
+ env JOBS=16 scripts/build-rdna4.sh # -> build-rdna4/ (gfx1201 auto-detected)
117
+ ```
118
+
119
+ On a Navi 48 card (RX 9070, 9070 XT, AI PRO R9700) the script builds `gfx1201`
120
+ automatically. `gfx1200` builds are **not** interchangeable on these cards.
121
+
122
+ ## Example run
123
+
124
+ ```bash
125
+ ./build-rdna4/bin/llama-server \
126
+ -m KAT-Coder-V2.5-Dev-Q4_0_ROCMFP4_STRIX_LEAN.gguf \
127
+ -dev Vulkan0 \
128
+ -ngl 999 \
129
+ -fa on \
130
+ -c 32768 \
131
+ -b 512 -ub 512 \
132
+ --jinja
133
+ ```
134
+
135
+ `-dev Vulkan0`, not `ROCm0` — see the benchmark table above. Swap in `-dev
136
+ ROCm0` only if Vulkan is unavailable on your system.
137
+
138
+ `--jinja` is required — the model ships a chat template with `<think>`
139
+ reasoning blocks.
140
+
141
+ The model has **no MTP/NextN head** (`mtp_num_hidden_layers = 0` in the source
142
+ config), so ROCmFPX's self-speculative decoding is not available here.
143
+
144
+ ## Artifacts
145
+
146
+ | Field | `STRIX_LEAN` | `Q4_0_ROCMFP4` |
147
+ | --- | --- | --- |
148
+ | Size | 18,597,337,248 bytes | 22,741,457,056 bytes |
149
+ | Effective BPW | 4.29 | 5.25 |
150
+ | SHA-256 | `857d39a696d448a9349a000ffdd5811c88761df59ec7d5a67e7ada3ac46a8161` | `f87c3f509c487876dc76d8a7606583faa1a3cbd04407b288c36dd2031b2cd92f` |
151
+ | Quantization | `Q4_0_ROCMFP4_STRIX_LEAN` | `Q4_0_ROCMFP4` |
152
+ | Importance matrix | none | none |
153
+
154
+ Source: `KAT-Coder-V2.5-Dev-BF16.gguf`, 69,376,637,408 bytes, converted from
155
+ the upstream `safetensors` release with ROCmFPX's `convert_hf_to_gguf.py` at
156
+ commit `db6844d`:
157
+
158
+ ```bash
159
+ python convert_hf_to_gguf.py /path/to/KAT-Coder-V2.5-Dev \
160
+ --outtype bf16 --outfile KAT-Coder-V2.5-Dev-BF16.gguf
161
+ ```
162
+
163
+ Quantization (same commit):
164
+
165
+ ```bash
166
+ ./build-rdna4/bin/llama-quantize \
167
+ KAT-Coder-V2.5-Dev-BF16.gguf \
168
+ KAT-Coder-V2.5-Dev-Q4_0_ROCMFP4_STRIX_LEAN.gguf \
169
+ Q4_0_ROCMFP4_STRIX_LEAN 16
170
+
171
+ ./build-rdna4/bin/llama-quantize \
172
+ KAT-Coder-V2.5-Dev-BF16.gguf \
173
+ KAT-Coder-V2.5-Dev-Q4_0_ROCMFP4.gguf \
174
+ Q4_0_ROCMFP4 16
175
+ ```
176
+
177
+ Verify after download:
178
+
179
+ ```bash
180
+ sha256sum -c SHA256SUMS
181
+ ```
182
+
183
+ ## Notes on the source model
184
+
185
+ The upstream open-weight release ships **language-model weights only** — the
186
+ vision and multimodal components described in the model card are not included,
187
+ and the converted GGUFs contain no multimodal projector. Despite the
188
+ `Qwen3_5MoeForConditionalGeneration` class name, these are text-only files.
189
+
190
+ ## Limitations
191
+
192
+ - Requires the ROCmFPX fork; no upstream llama.cpp compatibility.
193
+ - Validated on exactly one `gfx1201` host, batch 1, shallow context.
194
+ - No quality evaluation of any kind has been published for these artifacts.
195
+ - 34.66B MoE: needs ~18–22 GB for weights plus KV cache. Comfortable on a
196
+ 32 GB card, tight on 24 GB with meaningful context.
197
+
198
+ ## License and attribution
199
+
200
+ - **Base model:** KAT-Coder-V2.5-Dev, Kwaipilot, Apache-2.0. This repository
201
+ redistributes a converted and quantized derivative under the same license.
202
+ - **Format and execution path:** the `Q4_0_ROCMFP4` representations and
203
+ kernels are the work of the
204
+ [ROCmFPX](https://github.com/charlie12345/ROCmFPX) project, which builds on
205
+ [llama.cpp](https://github.com/ggml-org/llama.cpp).
206
+ - **This repository:** the quantized artifacts only.
207
+
208
+ KAT-Coder and related marks belong to their owners. This community
209
+ quantization is not affiliated with or endorsed by Kwaipilot, AMD, ROCmFPX, or
210
+ llama.cpp.
SHA256SUMS ADDED
@@ -0,0 +1,2 @@
 
 
 
1
+ f87c3f509c487876dc76d8a7606583faa1a3cbd04407b288c36dd2031b2cd92f KAT-Coder-V2.5-Dev-Q4_0_ROCMFP4.gguf
2
+ 857d39a696d448a9349a000ffdd5811c88761df59ec7d5a67e7ada3ac46a8161 KAT-Coder-V2.5-Dev-Q4_0_ROCMFP4_STRIX_LEAN.gguf