avlp12 commited on
Commit
7792dae
·
verified ·
1 Parent(s): bf15b10

Upload folder using huggingface_hub

Browse files
.gitattributes CHANGED
@@ -33,3 +33,4 @@ 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
+ tokenizer.json filter=lfs diff=lfs merge=lfs -text
README.md ADDED
@@ -0,0 +1,103 @@
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
1
+ ---
2
+ language:
3
+ - en
4
+ - ko
5
+ - zh
6
+ license: apache-2.0
7
+ base_model: bottlecapai/ThinkingCap-Qwen3.6-27B
8
+ base_model_relation: quantized
9
+ library_name: mlx
10
+ pipeline_tag: text-generation
11
+ tags:
12
+ - mlx
13
+ - qwen3_5
14
+ - quantized
15
+ - mixed-precision
16
+ - apple-silicon
17
+ - token-efficient
18
+ - efficient-thinking
19
+ - conversational
20
+ ---
21
+
22
+ # ThinkingCap-Qwen3.6-27B-Alis-MLX-Dynamic
23
+
24
+ Apple Silicon (MLX) **mixed-precision** quantization of [bottlecapai/ThinkingCap-Qwen3.6-27B](https://huggingface.co/bottlecapai/ThinkingCap-Qwen3.6-27B) — the token-efficiency finetune of Qwen3.6-27B (~50% fewer thinking tokens at preserved accuracy). **4.601 bpw, 15.47 GB, GPQA-Diamond 83.3% — 0.5pt from bf16.**
25
+
26
+ | build | weights | GPQA-D* | avg think tokens | decode† | peak mem |
27
+ |---|---|---|---|---|---|
28
+ | **`main` (this)** | **15.47 GB** | **83.3%** | **2,838** | 36.5 tok/s | 15.8 GB |
29
+ | official [Q4_K_M GGUF](https://huggingface.co/bottlecapai/ThinkingCap-Qwen3.6-27B-GGUF) | 16.81 GB | 82.3% | 3,654 | — | — |
30
+ | ThinkingCap bf16 | 55.56 GB | 83.8% | 3,019 | — | — |
31
+
32
+ \* n=198, temperature 1.0, seed-fixed shuffled choices, 32K token cap — identical harness for all three rows (harness validated by reproducing the ThinkingCap card's published 83.8 exactly).
33
+ † single-stream on an M3 Ultra, short prompt.
34
+
35
+ ![Showdown: accuracy, size and thinking tokens vs the official Q4_K_M GGUF and bf16](https://huggingface.co/avlp12/ThinkingCap-Qwen3.6-27B-Alis-MLX-Dynamic/resolve/main/assets/fig_showdown.png)
36
+
37
+ ## Why this build
38
+
39
+ Smaller **and** more accurate than the official 4-bit GGUF, with 22% fewer thinking
40
+ tokens per answer — on Apple Silicon, fewer generated tokens is the speedup that
41
+ matters. Fits 24 GB Macs with room for context (15.8 GB measured peak at short
42
+ context; int8 KV keeps long-context overhead small — only 16 of 64 layers carry KV
43
+ in this 3:1 DeltaNet hybrid).
44
+
45
+ ## The finding behind it: short thinkers survive quantization
46
+
47
+ Across our GPQA campaign, the **same 4.6bpw recipe** loses 12.8pt on vanilla
48
+ Qwen3.6-27B (85.5 → 72.7) but only 0.5pt on ThinkingCap (83.8 → 83.3). Long
49
+ reasoning chains accumulate quantization drift token by token; ThinkingCap's
50
+ ~3K-token chains stay on track where vanilla's ~11K-token chains derail.
51
+ **Token-efficiency finetune first, quantize second** — the two compound.
52
+
53
+ ![GPQA vs bits-per-weight: vanilla quants degrade steeply; the ThinkingCap quant sits on the bf16 line](https://huggingface.co/avlp12/ThinkingCap-Qwen3.6-27B-Alis-MLX-Dynamic/resolve/main/assets/fig_gpqa_curve.png)
54
+
55
+ ## Usage
56
+
57
+ ```python
58
+ from mlx_lm import load, generate
59
+
60
+ model, tokenizer = load("avlp12/ThinkingCap-Qwen3.6-27B-Alis-MLX-Dynamic")
61
+ prompt = tokenizer.apply_chat_template(
62
+ [{"role": "user", "content": "뮤텍스와 세마포어의 차이를 설명해줘."}],
63
+ add_generation_prompt=True,
64
+ )
65
+ print(generate(model, tokenizer, prompt=prompt, max_tokens=512))
66
+ ```
67
+
68
+ ```bash
69
+ mlx_lm.generate --model avlp12/ThinkingCap-Qwen3.6-27B-Alis-MLX-Dynamic --prompt "..." -m 512
70
+ mlx_lm.server --model avlp12/ThinkingCap-Qwen3.6-27B-Alis-MLX-Dynamic --port 8080
71
+ ```
72
+
73
+ Long context: `--kv-bits 8 --kv-group-size 64` (measured quality-free on this family: KL vs bf16-KV ≤ 0.003).
74
+
75
+ ## Recipe (verified from `config.json`)
76
+
77
+ Per-tensor bits by marginal utility from a full weight-space sensitivity scan,
78
+ **validated end-to-end** (the scan alone misranks formats — see the nvfp4 note on the
79
+ [vanilla 27B repo](https://huggingface.co/avlp12/Qwen3.6-27B-Alis-MLX-Dynamic)):
80
+
81
+ | component | precision |
82
+ |---|---|
83
+ | bulk (90.1% of params) | affine 4-bit g64 |
84
+ | sensitivity-ranked top 9.8% | affine 5-bit g64 |
85
+ | routers / small gates | 6-bit pins |
86
+ | embed / lm_head | ≥4-bit |
87
+
88
+ No DWQ retune: at ≥4bpw the validation-gated DWQ rejects every round (already
89
+ teacher-close); conversion-time weights ship as-is.
90
+
91
+ ## Notes & provenance
92
+
93
+ - Text-only conversion (mlx-lm path); the base's vision tower is not included.
94
+ - Eval artifacts: same 198-question GPQA protocol for every row of the table above.
95
+ - Built on an M3 Ultra 512 GB · mlx-lm 0.31.3 · mlx 0.31.2 · 2026-07.
96
+ - Siblings: [Qwen3.6-27B-Alis-MLX-Dynamic](https://huggingface.co/avlp12/Qwen3.6-27B-Alis-MLX-Dynamic) (vanilla golden + 5.5bpw reasoning tier), [Qwen3.6-35B-A3B-Alis-MLX-Dynamic](https://huggingface.co/avlp12/Qwen3.6-35B-A3B-Alis-MLX-Dynamic) (MoE, 102 tok/s).
97
+
98
+ ## Credits
99
+
100
+ - **[bottlecapai](https://huggingface.co/bottlecapai)** — ThinkingCap-Qwen3.6-27B, the token-efficiency finetune this quantizes (and the Q4_K_M GGUF benchmarked against).
101
+ - **[Qwen team](https://huggingface.co/Qwen)** — the underlying Qwen3.6-27B.
102
+ - **[Apple MLX team](https://github.com/ml-explore/mlx)** — mlx / mlx-lm.
103
+ - Quantization recipe & evals: [Alis (avlp12)](https://huggingface.co/avlp12) with the [alis-dwq](https://github.com/avlp12/alis-dwq) pipeline; built with assistance from Claude (Anthropic).
chat_template.jinja ADDED
@@ -0,0 +1,154 @@
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
1
+ {%- set image_count = namespace(value=0) %}
2
+ {%- set video_count = namespace(value=0) %}
3
+ {%- macro render_content(content, do_vision_count, is_system_content=false) %}
4
+ {%- if content is string %}
5
+ {{- content }}
6
+ {%- elif content is iterable and content is not mapping %}
7
+ {%- for item in content %}
8
+ {%- if 'image' in item or 'image_url' in item or item.type == 'image' %}
9
+ {%- if is_system_content %}
10
+ {{- raise_exception('System message cannot contain images.') }}
11
+ {%- endif %}
12
+ {%- if do_vision_count %}
13
+ {%- set image_count.value = image_count.value + 1 %}
14
+ {%- endif %}
15
+ {%- if add_vision_id %}
16
+ {{- 'Picture ' ~ image_count.value ~ ': ' }}
17
+ {%- endif %}
18
+ {{- '<|vision_start|><|image_pad|><|vision_end|>' }}
19
+ {%- elif 'video' in item or item.type == 'video' %}
20
+ {%- if is_system_content %}
21
+ {{- raise_exception('System message cannot contain videos.') }}
22
+ {%- endif %}
23
+ {%- if do_vision_count %}
24
+ {%- set video_count.value = video_count.value + 1 %}
25
+ {%- endif %}
26
+ {%- if add_vision_id %}
27
+ {{- 'Video ' ~ video_count.value ~ ': ' }}
28
+ {%- endif %}
29
+ {{- '<|vision_start|><|video_pad|><|vision_end|>' }}
30
+ {%- elif 'text' in item %}
31
+ {{- item.text }}
32
+ {%- else %}
33
+ {{- raise_exception('Unexpected item type in content.') }}
34
+ {%- endif %}
35
+ {%- endfor %}
36
+ {%- elif content is none or content is undefined %}
37
+ {{- '' }}
38
+ {%- else %}
39
+ {{- raise_exception('Unexpected content type.') }}
40
+ {%- endif %}
41
+ {%- endmacro %}
42
+ {%- if not messages %}
43
+ {{- raise_exception('No messages provided.') }}
44
+ {%- endif %}
45
+ {%- if tools and tools is iterable and tools is not mapping %}
46
+ {{- '<|im_start|>system\n' }}
47
+ {{- "# Tools\n\nYou have access to the following functions:\n\n<tools>" }}
48
+ {%- for tool in tools %}
49
+ {{- "\n" }}
50
+ {{- tool | tojson }}
51
+ {%- endfor %}
52
+ {{- "\n</tools>" }}
53
+ {{- '\n\nIf you choose to call a function ONLY reply in the following format with NO suffix:\n\n<tool_call>\n<function=example_function_name>\n<parameter=example_parameter_1>\nvalue_1\n</parameter>\n<parameter=example_parameter_2>\nThis is the value for the second parameter\nthat can span\nmultiple lines\n</parameter>\n</function>\n</tool_call>\n\n<IMPORTANT>\nReminder:\n- Function calls MUST follow the specified format: an inner <function=...></function> block must be nested within <tool_call></tool_call> XML tags\n- Required parameters MUST be specified\n- You may provide optional reasoning for your function call in natural language BEFORE the function call, but NOT after\n- If there is no function call available, answer the question like normal with your current knowledge and do not tell the user about function calls\n</IMPORTANT>' }}
54
+ {%- if messages[0].role == 'system' %}
55
+ {%- set content = render_content(messages[0].content, false, true)|trim %}
56
+ {%- if content %}
57
+ {{- '\n\n' + content }}
58
+ {%- endif %}
59
+ {%- endif %}
60
+ {{- '<|im_end|>\n' }}
61
+ {%- else %}
62
+ {%- if messages[0].role == 'system' %}
63
+ {%- set content = render_content(messages[0].content, false, true)|trim %}
64
+ {{- '<|im_start|>system\n' + content + '<|im_end|>\n' }}
65
+ {%- endif %}
66
+ {%- endif %}
67
+ {%- set ns = namespace(multi_step_tool=true, last_query_index=messages|length - 1) %}
68
+ {%- for message in messages[::-1] %}
69
+ {%- set index = (messages|length - 1) - loop.index0 %}
70
+ {%- if ns.multi_step_tool and message.role == "user" %}
71
+ {%- set content = render_content(message.content, false)|trim %}
72
+ {%- if not(content.startswith('<tool_response>') and content.endswith('</tool_response>')) %}
73
+ {%- set ns.multi_step_tool = false %}
74
+ {%- set ns.last_query_index = index %}
75
+ {%- endif %}
76
+ {%- endif %}
77
+ {%- endfor %}
78
+ {%- if ns.multi_step_tool %}
79
+ {{- raise_exception('No user query found in messages.') }}
80
+ {%- endif %}
81
+ {%- for message in messages %}
82
+ {%- set content = render_content(message.content, true)|trim %}
83
+ {%- if message.role == "system" %}
84
+ {%- if not loop.first %}
85
+ {{- raise_exception('System message must be at the beginning.') }}
86
+ {%- endif %}
87
+ {%- elif message.role == "user" %}
88
+ {{- '<|im_start|>' + message.role + '\n' + content + '<|im_end|>' + '\n' }}
89
+ {%- elif message.role == "assistant" %}
90
+ {%- set reasoning_content = '' %}
91
+ {%- if message.reasoning_content is string %}
92
+ {%- set reasoning_content = message.reasoning_content %}
93
+ {%- else %}
94
+ {%- if '</think>' in content %}
95
+ {%- set reasoning_content = content.split('</think>')[0].rstrip('\n').split('<think>')[-1].lstrip('\n') %}
96
+ {%- set content = content.split('</think>')[-1].lstrip('\n') %}
97
+ {%- endif %}
98
+ {%- endif %}
99
+ {%- set reasoning_content = reasoning_content|trim %}
100
+ {%- if (preserve_thinking is defined and preserve_thinking is true) or (loop.index0 > ns.last_query_index) %}
101
+ {{- '<|im_start|>' + message.role + '\n<think>\n' + reasoning_content + '\n</think>\n\n' + content }}
102
+ {%- else %}
103
+ {{- '<|im_start|>' + message.role + '\n' + content }}
104
+ {%- endif %}
105
+ {%- if message.tool_calls and message.tool_calls is iterable and message.tool_calls is not mapping %}
106
+ {%- for tool_call in message.tool_calls %}
107
+ {%- if tool_call.function is defined %}
108
+ {%- set tool_call = tool_call.function %}
109
+ {%- endif %}
110
+ {%- if loop.first %}
111
+ {%- if content|trim %}
112
+ {{- '\n\n<tool_call>\n<function=' + tool_call.name + '>\n' }}
113
+ {%- else %}
114
+ {{- '<tool_call>\n<function=' + tool_call.name + '>\n' }}
115
+ {%- endif %}
116
+ {%- else %}
117
+ {{- '\n<tool_call>\n<function=' + tool_call.name + '>\n' }}
118
+ {%- endif %}
119
+ {%- if tool_call.arguments is defined %}
120
+ {%- for args_name, args_value in tool_call.arguments|items %}
121
+ {{- '<parameter=' + args_name + '>\n' }}
122
+ {%- set args_value = args_value | string if args_value is string else args_value | tojson | safe %}
123
+ {{- args_value }}
124
+ {{- '\n</parameter>\n' }}
125
+ {%- endfor %}
126
+ {%- endif %}
127
+ {{- '</function>\n</tool_call>' }}
128
+ {%- endfor %}
129
+ {%- endif %}
130
+ {{- '<|im_end|>\n' }}
131
+ {%- elif message.role == "tool" %}
132
+ {%- if loop.previtem and loop.previtem.role != "tool" %}
133
+ {{- '<|im_start|>user' }}
134
+ {%- endif %}
135
+ {{- '\n<tool_response>\n' }}
136
+ {{- content }}
137
+ {{- '\n</tool_response>' }}
138
+ {%- if not loop.last and loop.nextitem.role != "tool" %}
139
+ {{- '<|im_end|>\n' }}
140
+ {%- elif loop.last %}
141
+ {{- '<|im_end|>\n' }}
142
+ {%- endif %}
143
+ {%- else %}
144
+ {{- raise_exception('Unexpected message role.') }}
145
+ {%- endif %}
146
+ {%- endfor %}
147
+ {%- if add_generation_prompt %}
148
+ {{- '<|im_start|>assistant\n' }}
149
+ {%- if enable_thinking is defined and enable_thinking is false %}
150
+ {{- '<think>\n\n</think>\n\n' }}
151
+ {%- else %}
152
+ {{- '<think>\n' }}
153
+ {%- endif %}
154
+ {%- endif %}
config.json ADDED
The diff for this file is too large to render. See raw diff
 
generation_config.json ADDED
@@ -0,0 +1,13 @@
 
 
 
 
 
 
 
 
 
 
 
 
 
 
1
+ {
2
+ "bos_token_id": 248044,
3
+ "do_sample": true,
4
+ "eos_token_id": [
5
+ 248046,
6
+ 248044
7
+ ],
8
+ "pad_token_id": 248044,
9
+ "temperature": 1.0,
10
+ "top_k": 20,
11
+ "top_p": 0.95,
12
+ "transformers_version": "5.7.0"
13
+ }
model-00001-of-00003.safetensors ADDED
@@ -0,0 +1,3 @@
 
 
 
 
1
+ version https://git-lfs.github.com/spec/v1
2
+ oid sha256:2282bc250064a52f0f3d1e21be3019141a133e6fa52b36e372e1d46f5a5dc3ab
3
+ size 5359250448
model-00002-of-00003.safetensors ADDED
@@ -0,0 +1,3 @@
 
 
 
 
1
+ version https://git-lfs.github.com/spec/v1
2
+ oid sha256:d24ce95a70d3b76caa9c1e9b5d8c8227a603d2fd13fd93e15baff13a774d94c1
3
+ size 5367974699
model-00003-of-00003.safetensors ADDED
@@ -0,0 +1,3 @@
 
 
 
 
1
+ version https://git-lfs.github.com/spec/v1
2
+ oid sha256:4512f7fe8ff107189a81333d69f2b209aae0f7adfbabbc3b37a3701aa2bc17dd
3
+ size 4741362734
model.safetensors.index.json ADDED
The diff for this file is too large to render. See raw diff
 
tokenizer.json ADDED
@@ -0,0 +1,3 @@
 
 
 
 
1
+ version https://git-lfs.github.com/spec/v1
2
+ oid sha256:06b9509352d2af50381ab2247e083b80d32d5c0aba91c272ca9ff729b6a0e523
3
+ size 19989325
tokenizer_config.json ADDED
@@ -0,0 +1,33 @@
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
1
+ {
2
+ "add_prefix_space": false,
3
+ "audio_bos_token": "<|audio_start|>",
4
+ "audio_eos_token": "<|audio_end|>",
5
+ "audio_token": "<|audio_pad|>",
6
+ "backend": "tokenizers",
7
+ "bos_token": null,
8
+ "clean_up_tokenization_spaces": false,
9
+ "eos_token": "<|im_end|>",
10
+ "errors": "replace",
11
+ "image_token": "<|image_pad|>",
12
+ "is_local": true,
13
+ "local_files_only": false,
14
+ "model_max_length": 262144,
15
+ "model_specific_special_tokens": {
16
+ "audio_bos_token": "<|audio_start|>",
17
+ "audio_eos_token": "<|audio_end|>",
18
+ "audio_token": "<|audio_pad|>",
19
+ "image_token": "<|image_pad|>",
20
+ "video_token": "<|video_pad|>",
21
+ "vision_bos_token": "<|vision_start|>",
22
+ "vision_eos_token": "<|vision_end|>"
23
+ },
24
+ "pad_token": "<|endoftext|>",
25
+ "pretokenize_regex": "(?i:'s|'t|'re|'ve|'m|'ll|'d)|[^\\r\\n\\p{L}\\p{N}]?[\\p{L}\\p{M}]+|\\p{N}| ?[^\\s\\p{L}\\p{M}\\p{N}]+[\\r\\n]*|\\s*[\\r\\n]+|\\s+(?!\\S)|\\s+",
26
+ "split_special_tokens": false,
27
+ "tokenizer_class": "Qwen2Tokenizer",
28
+ "tool_parser_type": "qwen3_coder",
29
+ "unk_token": null,
30
+ "video_token": "<|video_pad|>",
31
+ "vision_bos_token": "<|vision_start|>",
32
+ "vision_eos_token": "<|vision_end|>"
33
+ }