m0rtyddd commited on
Commit
14e0748
·
verified ·
1 Parent(s): 8502b4d

initial release: clario v2 LoRA + model card

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,249 @@
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
1
+ ---
2
+ library_name: peft
3
+ base_model: unsloth/gemma-4-e4b-it
4
+ license: cc-by-4.0
5
+ language:
6
+ - en
7
+ pipeline_tag: text-generation
8
+ tags:
9
+ - medical
10
+ - clinical-nlp
11
+ - ner
12
+ - hpo
13
+ - rare-disease
14
+ - lora
15
+ - peft
16
+ - gemma
17
+ - entity-extraction
18
+ - symptom-extraction
19
+ datasets:
20
+ - m0rtyddd/clario-synthetic-diary
21
+ model-index:
22
+ - name: clario-gemma4-e4b-lora-v2
23
+ results:
24
+ - task:
25
+ type: token-classification
26
+ name: Symptom entity extraction
27
+ dataset:
28
+ name: clario-synthetic-diary (val split, held-out by disease)
29
+ type: m0rtyddd/clario-synthetic-diary
30
+ metrics:
31
+ - type: f1
32
+ name: Name F1 (synonym-aware)
33
+ value: 0.524
34
+ - type: f1
35
+ name: HPO ID F1 (via name to HPO lookup)
36
+ value: 0.524
37
+ - type: accuracy
38
+ name: JSON schema correctness
39
+ value: 1.0
40
+ - type: accuracy
41
+ name: Entity type accuracy
42
+ value: 1.0
43
+ ---
44
+
45
+ # Clario · Gemma 4 E4B · Symptom-Diary LoRA (v2)
46
+
47
+ LoRA adapter on `unsloth/gemma-4-e4b-it` that converts colloquial patient
48
+ diary text into a structured JSON list of medical entities with canonical
49
+ names suitable for HPO (Human Phenotype Ontology) lookup. Trained on
50
+ 411 distilled `(diary, target_json)` pairs derived from Orphanet rare-disease
51
+ phenotypes and HPO synonyms.
52
+
53
+ The adapter is one stage of a deterministic pipeline:
54
+
55
+ ```
56
+ diary text → [LoRA-adapted Gemma 4 E4B, 4-bit] → JSON entities
57
+ → deterministic HPO synonym lookup → HPO IDs + canonical names
58
+ ```
59
+
60
+ The model is **not** asked to memorise the ~17k HPO IDs from 411 examples.
61
+ Its job is to extract and canonicalise symptom mentions; IDs are resolved
62
+ afterwards from a versioned ontology (see *Limitations* §1).
63
+
64
+ ## Headline results
65
+
66
+ Held-out 68-example validation set (split by disease — 651 Orphanet
67
+ disorders never appear in training). Baseline: the same
68
+ `unsloth/gemma-4-e4b-it` in 4-bit *without* the adapter, apples-to-apples,
69
+ same system prompt.
70
+
71
+ | Metric | Baseline | Fine-tuned | Δ |
72
+ |---|--:|--:|--:|
73
+ | JSON schema correctness | 0%¹ | **100%** | +100 pp |
74
+ | Entity type-field accuracy | 89.1% | **100%** | +10.9 pp |
75
+ | Name F1 (synonym-aware) | 0.209 | **0.524** | **+151%** |
76
+ | HPO ID F1 (via name→HPO lookup) | 0.349 | **0.524** | +50% |
77
+ | Avg entities per example (gold = 2.93) | 5.37 (over-extract) | **2.91** (calibrated) | — |
78
+
79
+ ¹ Vanilla Gemma 4 emits its own ad-hoc shape
80
+ (`{symptoms, triggers, body_parts, medications, lab_values}`); the baseline
81
+ row above is computed *after* normalising those outputs to the requested
82
+ schema. Without normalisation, every baseline score would be 0.
83
+
84
+ ## Quick start
85
+
86
+ ```python
87
+ import json
88
+ from transformers import AutoModelForCausalLM, AutoTokenizer, BitsAndBytesConfig
89
+ from peft import PeftModel
90
+
91
+ BASE = "unsloth/gemma-4-e4b-it"
92
+ ADAPTER = "m0rtyddd/clario-gemma4-e4b-lora-v2"
93
+
94
+ bnb = BitsAndBytesConfig(load_in_4bit=True, bnb_4bit_compute_dtype="bfloat16")
95
+ tok = AutoTokenizer.from_pretrained(ADAPTER)
96
+ base = AutoModelForCausalLM.from_pretrained(BASE, quantization_config=bnb, device_map="auto")
97
+ model = PeftModel.from_pretrained(base, ADAPTER)
98
+ model.eval()
99
+
100
+ SYSTEM = (
101
+ "Extract medical entities from the diary. Return strict JSON: "
102
+ '{"entities":[{"name_colloquial":"…","name_canonical":"…",'
103
+ '"hpo_id":"HP:…","type":"symptom|lab_marker|med|trigger|behavior"}]}. '
104
+ "Use canonical HPO names where possible. Output JSON only."
105
+ )
106
+ diary = (
107
+ "My eyes have been gritty, like there's sand in them. Mouth's been so "
108
+ "dry I can't swallow toast without water. Fingers ache when I type for long."
109
+ )
110
+
111
+ prompt = tok.apply_chat_template(
112
+ [{"role": "system", "content": SYSTEM}, {"role": "user", "content": diary}],
113
+ tokenize=False, add_generation_prompt=True,
114
+ )
115
+ ids = tok(prompt, return_tensors="pt").to(model.device)
116
+ out = model.generate(**ids, max_new_tokens=512, do_sample=False)
117
+ response = tok.decode(out[0][ids["input_ids"].shape[1]:], skip_special_tokens=True)
118
+ print(json.loads(response))
119
+ # {"entities": [
120
+ # {"name_colloquial": "gritty eyes", "name_canonical": "Keratoconjunctivitis sicca", ...},
121
+ # {"name_colloquial": "mouth so dry", "name_canonical": "Xerostomia", ...},
122
+ # {"name_colloquial": "fingers ache", "name_canonical": "Arthralgia", ...},
123
+ # ]}
124
+ ```
125
+
126
+ **Production note.** Discard the model's `hpo_id` field and resolve from
127
+ `name_canonical` via a synonym index built from HPO `hp.obo`
128
+ (42k normalised name → HP:ID entries). See *Limitations* §1.
129
+
130
+ ## Pipeline integration
131
+
132
+ Reference integration (FastAPI sidecar + Clario backend) is open-source:
133
+
134
+ - **Sidecar** (this adapter + HPO post-lookup + few-shot SLE demos):
135
+ `scripts/clario_extractor_service.py`.
136
+ - **Consumer:** `backend/diary/extraction.py::process_one` calls the
137
+ sidecar when `CLARIO_EXTRACTOR_URL` is set, otherwise falls back to
138
+ vanilla Gemma via Ollama.
139
+
140
+ ## Training
141
+
142
+ | | |
143
+ |---|---|
144
+ | Base | `unsloth/gemma-4-e4b-it` (4-bit NF4, BF16 compute) |
145
+ | Adapter | LoRA, r=16, α=32, dropout=0.05 |
146
+ | Target modules | `q/k/v/o/gate/up/down_proj` on all language-model layers |
147
+ | Optimiser | `adamw_8bit` |
148
+ | Learning rate | 5e-5 |
149
+ | Epochs | 1 (on top of a resumed `checkpoint-50` from the v1 run) |
150
+ | Max sequence length | 1536 |
151
+ | Total steps | 22 SGD steps over 343 train examples |
152
+ | Train loss (final) | 0.478 |
153
+ | Hardware | single RTX 5060 Ti 16 GB (Blackwell sm_120) |
154
+ | Wall time | ~22 min |
155
+
156
+ The first training run hung at step 50/66 due to a known interaction
157
+ between `paged_adamw_8bit` and Windows NVIDIA driver 596.36. The resumed
158
+ run with `adamw_8bit` completed cleanly.
159
+
160
+ Training data is published as
161
+ [`m0rtyddd/clario-synthetic-diary`](https://huggingface.co/datasets/m0rtyddd/clario-synthetic-diary).
162
+
163
+ ## Intended use
164
+
165
+ - Extracting symptom, lab-marker, medication, trigger, and behaviour
166
+ entities from short English-language patient diary entries.
167
+ - As the *extraction* stage of a longer pipeline that includes
168
+ deterministic HPO-ID resolution and downstream graph / hypothesis-engine
169
+ logic.
170
+ - Research and educational use around rare-disease symptom canonicalisation.
171
+
172
+ ## Out of scope
173
+
174
+ - **Direct clinical decision-making.** This is an extraction model, not a
175
+ diagnostic one. Outputs require human-in-the-loop review.
176
+ - **Non-English diaries.** All training data is English (see §5 below).
177
+ - **HPO ID generation.** Use the deterministic lookup; do not consume
178
+ `entities[].hpo_id` from the model (see §1 below).
179
+ - **Rationale / explanation generation** for downstream hypothesis ranking
180
+ — this LoRA does not improve that path.
181
+
182
+ ## Limitations
183
+
184
+ **1. The model does not faithfully generate HPO IDs.** 411 training pairs
185
+ cover ~1.5k unique HPO terms out of the ontology's ~17k. On free-form
186
+ generation the model hallucinates sequential dummies
187
+ (`HP:0001211, HP:0001212, HP:0001213, …`). The +50% relative HPO F1 over
188
+ baseline measures how the better *name* extraction improves end-to-end ID
189
+ resolution **once a deterministic lookup is applied**. Consumers must
190
+ discard the model's `hpo_id` field.
191
+
192
+ **2. Eval is synthetic, held-out by disease, but not clinical.** Both
193
+ train and validation come from the same `gpt-oss:20b` teacher pipeline.
194
+ 651 Orphanet disorders never appear in train, so the split is non-trivially
195
+ novel — but the val set is not a clinical golden. A manual 200-pair
196
+ golden set is the next measurement gate and was not completed within the
197
+ hackathon window.
198
+
199
+ **3. Two few-shot demonstrations stack on top of the LoRA for the SLE
200
+ pattern.** The LoRA alone correctly extracts the MCAS-style (Tom) and
201
+ Hashimoto-style (Anna) personas with no prompt scaffolding. For SLE
202
+ specifically, the upstream sidecar prepends two demonstrations to the
203
+ chat history (showing "reddened band across cheekbones → Malar rash" and
204
+ "burning skin where sun hit → Photosensitivity", with surface forms
205
+ *different* from any test diary) to push the model toward those two
206
+ textbook SLE phenotypes. Both contributions stack.
207
+
208
+ **4. Rationale generation is unchanged.** The adapter is scoped to
209
+ extraction. Downstream hypothesis rationales still run on vanilla
210
+ Gemma 4 weights with templated phrasing.
211
+
212
+ **5. English only.** No Russian, Italian, or other-language training data.
213
+ Frontend i18n slots exist upstream, but the extractor would need a
214
+ translate-pass or additional fine-tuning for non-English diaries.
215
+
216
+ ## Licence and attribution
217
+
218
+ This adapter is released under **CC-BY-4.0**, propagating the licence of
219
+ its training-data sources:
220
+
221
+ - **HPO** (Human Phenotype Ontology) phenotype names and synonyms —
222
+ CC-BY-4.0.
223
+ Köhler S. *et al.* (2021) *The Human Phenotype Ontology in 2021.*
224
+ Nucleic Acids Research, 49(D1):D1207–D1217. <https://hpo.jax.org/>
225
+ - **Orphanet** rare-disease ↔ phenotype annotations
226
+ (`en_product4.xml`, 2026-05-13 snapshot) — free for academic and
227
+ commercial use with attribution.
228
+ Orphadata: *Free access products on rare diseases and orphan drugs.*
229
+ INSERM 1978. <https://www.orphadata.com/>
230
+ - **Base model:** `unsloth/gemma-4-e4b-it`, used under the Gemma Terms of
231
+ Use.
232
+ - **Teacher:** `gpt-oss:20b` (Apache-2.0).
233
+
234
+ Cite as:
235
+
236
+ ```bibtex
237
+ @misc{okulov2026clario_lora_v2,
238
+ title = {{Clario} {Gemma 4 E4B} Symptom-Diary {LoRA} (v2)},
239
+ author = {Okulov, Maksim},
240
+ year = {2026},
241
+ howpublished = {\url{https://huggingface.co/m0rtyddd/clario-gemma4-e4b-lora-v2}}
242
+ }
243
+ ```
244
+
245
+ ## Frameworks
246
+
247
+ `peft 0.19.1` · `trl 1.4.0` · `transformers 5.8.0.dev0` ·
248
+ `torch 2.11.0.dev20260108+cu128` · `datasets 4.8.5` · `tokenizers 0.22.2` ·
249
+ `unsloth` (QLoRA path) · `bitsandbytes` (4-bit NF4)
adapter_config.json ADDED
@@ -0,0 +1,40 @@
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
1
+ {
2
+ "alora_invocation_tokens": null,
3
+ "alpha_pattern": {},
4
+ "arrow_config": null,
5
+ "auto_mapping": null,
6
+ "base_model_name_or_path": "unsloth/gemma-4-e4b-it",
7
+ "bias": "none",
8
+ "corda_config": null,
9
+ "ensure_weight_tying": false,
10
+ "eva_config": null,
11
+ "exclude_modules": null,
12
+ "fan_in_fan_out": false,
13
+ "inference_mode": true,
14
+ "init_lora_weights": true,
15
+ "layer_replication": null,
16
+ "layers_pattern": null,
17
+ "layers_to_transform": null,
18
+ "loftq_config": {},
19
+ "lora_alpha": 32,
20
+ "lora_bias": false,
21
+ "lora_dropout": 0.05,
22
+ "lora_ga_config": null,
23
+ "megatron_config": null,
24
+ "megatron_core": "megatron.core",
25
+ "modules_to_save": null,
26
+ "peft_type": "LORA",
27
+ "peft_version": "0.19.1",
28
+ "qalora_group_size": 16,
29
+ "r": 16,
30
+ "rank_pattern": {},
31
+ "revision": null,
32
+ "target_modules": "model\\.language_model\\..*\\.(q_proj|k_proj|v_proj|o_proj|gate_proj|up_proj|down_proj)$",
33
+ "target_parameters": null,
34
+ "task_type": "CAUSAL_LM",
35
+ "trainable_token_indices": null,
36
+ "use_bdlora": null,
37
+ "use_dora": false,
38
+ "use_qalora": false,
39
+ "use_rslora": false
40
+ }
adapter_model.safetensors ADDED
@@ -0,0 +1,3 @@
 
 
 
 
1
+ version https://git-lfs.github.com/spec/v1
2
+ oid sha256:cce987cb1a3a3eb56ef9407d8c52ae0434dae946ccc4d472694b7dfcbd8e78c3
3
+ size 69839888
chat_template.jinja ADDED
@@ -0,0 +1,351 @@
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
1
+ {%- macro format_parameters(properties, required, filter_keys=false) -%}
2
+ {%- set standard_keys = ['description', 'type', 'properties', 'required', 'nullable'] -%}
3
+ {%- set ns = namespace(found_first=false) -%}
4
+ {%- for key, value in properties | dictsort -%}
5
+ {%- set add_comma = false -%}
6
+ {%- if not filter_keys or key not in standard_keys -%}
7
+ {%- if ns.found_first %},{% endif -%}
8
+ {%- set ns.found_first = true -%}
9
+ {{ key }}:{
10
+ {%- if value['description'] -%}
11
+ description:<|"|>{{ value['description'] }}<|"|>
12
+ {%- set add_comma = true -%}
13
+ {%- endif -%}
14
+ {%- if value['type'] | upper == 'STRING' -%}
15
+ {%- if value['enum'] -%}
16
+ {%- if add_comma %},{%- else -%} {%- set add_comma = true -%} {% endif -%}
17
+ enum:{{ format_argument(value['enum']) }}
18
+ {%- endif -%}
19
+ {%- elif value['type'] | upper == 'ARRAY' -%}
20
+ {%- if value['items'] is mapping and value['items'] -%}
21
+ {%- if add_comma %},{%- else -%} {%- set add_comma = true -%} {% endif -%}
22
+ items:{
23
+ {%- set ns_items = namespace(found_first=false) -%}
24
+ {%- for item_key, item_value in value['items'] | dictsort -%}
25
+ {%- if item_value is not none -%}
26
+ {%- if ns_items.found_first %},{% endif -%}
27
+ {%- set ns_items.found_first = true -%}
28
+ {%- if item_key == 'properties' -%}
29
+ properties:{
30
+ {%- if item_value is mapping -%}
31
+ {{- format_parameters(item_value, value['items']['required'] | default([])) -}}
32
+ {%- endif -%}
33
+ }
34
+ {%- elif item_key == 'required' -%}
35
+ required:[
36
+ {%- for req_item in item_value -%}
37
+ <|"|>{{- req_item -}}<|"|>
38
+ {%- if not loop.last %},{% endif -%}
39
+ {%- endfor -%}
40
+ ]
41
+ {%- elif item_key == 'type' -%}
42
+ {%- if item_value is string -%}
43
+ type:{{ format_argument(item_value | upper) }}
44
+ {%- else -%}
45
+ type:{{ format_argument(item_value | map('upper') | list) }}
46
+ {%- endif -%}
47
+ {%- else -%}
48
+ {{ item_key }}:{{ format_argument(item_value) }}
49
+ {%- endif -%}
50
+ {%- endif -%}
51
+ {%- endfor -%}
52
+ }
53
+ {%- endif -%}
54
+ {%- endif -%}
55
+ {%- if value['nullable'] %}
56
+ {%- if add_comma %},{%- else -%} {%- set add_comma = true -%} {% endif -%}
57
+ nullable:true
58
+ {%- endif -%}
59
+ {%- if value['type'] | upper == 'OBJECT' -%}
60
+ {%- if value['properties'] is defined and value['properties'] is mapping -%}
61
+ {%- if add_comma %},{%- else -%} {%- set add_comma = true -%} {% endif -%}
62
+ properties:{
63
+ {{- format_parameters(value['properties'], value['required'] | default([])) -}}
64
+ }
65
+ {%- elif value is mapping -%}
66
+ {%- if add_comma %},{%- else -%} {%- set add_comma = true -%} {% endif -%}
67
+ properties:{
68
+ {{- format_parameters(value, value['required'] | default([]), filter_keys=true) -}}
69
+ }
70
+ {%- endif -%}
71
+ {%- if value['required'] -%}
72
+ {%- if add_comma %},{%- else -%} {%- set add_comma = true -%} {% endif -%}
73
+ required:[
74
+ {%- for item in value['required'] | default([]) -%}
75
+ <|"|>{{- item -}}<|"|>
76
+ {%- if not loop.last %},{% endif -%}
77
+ {%- endfor -%}
78
+ ]
79
+ {%- endif -%}
80
+ {%- endif -%}
81
+ {%- if add_comma %},{%- else -%} {%- set add_comma = true -%} {% endif -%}
82
+ type:<|"|>{{ value['type'] | upper }}<|"|>}
83
+ {%- endif -%}
84
+ {%- endfor -%}
85
+ {%- endmacro -%}
86
+ {%- macro format_function_declaration(tool_data) -%}
87
+ declaration:{{- tool_data['function']['name'] -}}{description:<|"|>{{- tool_data['function']['description'] -}}<|"|>
88
+ {%- set params = tool_data['function']['parameters'] -%}
89
+ {%- if params -%}
90
+ ,parameters:{
91
+ {%- if params['properties'] -%}
92
+ properties:{ {{- format_parameters(params['properties'], params['required']) -}} },
93
+ {%- endif -%}
94
+ {%- if params['required'] -%}
95
+ required:[
96
+ {%- for item in params['required'] -%}
97
+ <|"|>{{- item -}}<|"|>
98
+ {{- ',' if not loop.last -}}
99
+ {%- endfor -%}
100
+ ],
101
+ {%- endif -%}
102
+ {%- if params['type'] -%}
103
+ type:<|"|>{{- params['type'] | upper -}}<|"|>}
104
+ {%- endif -%}
105
+ {%- endif -%}
106
+ {%- if 'response' in tool_data['function'] -%}
107
+ {%- set response_declaration = tool_data['function']['response'] -%}
108
+ ,response:{
109
+ {%- if response_declaration['description'] -%}
110
+ description:<|"|>{{- response_declaration['description'] -}}<|"|>,
111
+ {%- endif -%}
112
+ {%- if response_declaration['type'] | upper == 'OBJECT' -%}
113
+ type:<|"|>{{- response_declaration['type'] | upper -}}<|"|>}
114
+ {%- endif -%}
115
+ {%- endif -%}
116
+ }
117
+ {%- endmacro -%}
118
+ {%- macro format_argument(argument, escape_keys=True) -%}
119
+ {%- if argument is string -%}
120
+ {{- '<|"|>' + argument + '<|"|>' -}}
121
+ {%- elif argument is boolean -%}
122
+ {{- 'true' if argument else 'false' -}}
123
+ {%- elif argument is mapping -%}
124
+ {{- '{' -}}
125
+ {%- set ns = namespace(found_first=false) -%}
126
+ {%- for key, value in argument | dictsort -%}
127
+ {%- if ns.found_first %},{% endif -%}
128
+ {%- set ns.found_first = true -%}
129
+ {%- if escape_keys -%}
130
+ {{- '<|"|>' + key + '<|"|>' -}}
131
+ {%- else -%}
132
+ {{- key -}}
133
+ {%- endif -%}
134
+ :{{- format_argument(value, escape_keys=escape_keys) -}}
135
+ {%- endfor -%}
136
+ {{- '}' -}}
137
+ {%- elif argument is sequence -%}
138
+ {{- '[' -}}
139
+ {%- for item in argument -%}
140
+ {{- format_argument(item, escape_keys=escape_keys) -}}
141
+ {%- if not loop.last %},{% endif -%}
142
+ {%- endfor -%}
143
+ {{- ']' -}}
144
+ {%- else -%}
145
+ {{- argument -}}
146
+ {%- endif -%}
147
+ {%- endmacro -%}
148
+ {%- macro strip_thinking(text) -%}
149
+ {%- set ns = namespace(result='') -%}
150
+ {%- for part in text.split('<channel|>') -%}
151
+ {%- if '<|channel>' in part -%}
152
+ {%- set ns.result = ns.result + part.split('<|channel>')[0] -%}
153
+ {%- else -%}
154
+ {%- set ns.result = ns.result + part -%}
155
+ {%- endif -%}
156
+ {%- endfor -%}
157
+ {{- ns.result | trim -}}
158
+ {%- endmacro -%}
159
+
160
+ {%- macro format_tool_response_block(tool_name, response) -%}
161
+ {{- '<|tool_response>' -}}
162
+ {%- if response is mapping -%}
163
+ {{- 'response:' + tool_name + '{' -}}
164
+ {%- for key, value in response | dictsort -%}
165
+ {{- key -}}:{{- format_argument(value, escape_keys=False) -}}
166
+ {%- if not loop.last %},{% endif -%}
167
+ {%- endfor -%}
168
+ {{- '}' -}}
169
+ {%- else -%}
170
+ {{- 'response:' + tool_name + '{value:' + format_argument(response, escape_keys=False) + '}' -}}
171
+ {%- endif -%}
172
+ {{- '<tool_response|>' -}}
173
+ {%- endmacro -%}
174
+
175
+ {%- set ns = namespace(prev_message_type=None) -%}
176
+ {%- set loop_messages = messages -%}
177
+ {{- bos_token -}}
178
+ {#- Handle System/Tool Definitions Block -#}
179
+ {%- if (enable_thinking is defined and enable_thinking) or tools or messages[0]['role'] in ['system', 'developer'] -%}
180
+ {{- '<|turn>system\n' -}}
181
+ {#- Inject Thinking token at the very top of the FIRST system turn -#}
182
+ {%- if enable_thinking is defined and enable_thinking -%}
183
+ {{- '<|think|>\n' -}}
184
+ {%- set ns.prev_message_type = 'think' -%}
185
+ {%- endif -%}
186
+ {%- if messages[0]['role'] in ['system', 'developer'] -%}
187
+ {%- if messages[0]['content'] is string -%}
188
+ {{- messages[0]['content'] | trim -}}
189
+ {%- elif messages[0]['content'] is sequence -%}
190
+ {%- for item in messages[0]['content'] -%}
191
+ {{- item['text'] | trim + ' '-}}
192
+ {%- endfor -%}
193
+ {%- endif -%}
194
+ {%- set loop_messages = messages[1:] -%}
195
+ {%- endif -%}
196
+ {%- if tools -%}
197
+ {%- for tool in tools %}
198
+ {{- '<|tool>' -}}
199
+ {{- format_function_declaration(tool) | trim -}}
200
+ {{- '<tool|>' -}}
201
+ {%- endfor %}
202
+ {%- set ns.prev_message_type = 'tool' -%}
203
+ {%- endif -%}
204
+ {{- '<turn|>\n' -}}
205
+ {%- endif %}
206
+
207
+ {#- Pre-scan: find last user message index for reasoning guard -#}
208
+ {%- set ns_turn = namespace(last_user_idx=-1) -%}
209
+ {%- for i in range(loop_messages | length) -%}
210
+ {%- if loop_messages[i]['role'] == 'user' -%}
211
+ {%- set ns_turn.last_user_idx = i -%}
212
+ {%- endif -%}
213
+ {%- endfor -%}
214
+
215
+ {#- Loop through messages -#}
216
+ {%- for message in loop_messages -%}
217
+ {%- if message['role'] != 'tool' -%}
218
+ {%- set ns.prev_message_type = None -%}
219
+ {%- set role = 'model' if message['role'] == 'assistant' else message['role'] -%}
220
+ {#- Detect continuation: suppress duplicate <|turn>model when previous non-tool message was also assistant -#}
221
+ {%- set prev_nt = namespace(role=None, found=false) -%}
222
+ {%- if loop.index0 > 0 -%}
223
+ {%- for j in range(loop.index0 - 1, -1, -1) -%}
224
+ {%- if not prev_nt.found -%}
225
+ {%- if loop_messages[j]['role'] != 'tool' -%}
226
+ {%- set prev_nt.role = loop_messages[j]['role'] -%}
227
+ {%- set prev_nt.found = true -%}
228
+ {%- endif -%}
229
+ {%- endif -%}
230
+ {%- endfor -%}
231
+ {%- endif -%}
232
+ {%- set continue_same_model_turn = (role == 'model' and prev_nt.role == 'assistant') -%}
233
+ {%- if not continue_same_model_turn -%}
234
+ {{- '<|turn>' + role + '\n' }}
235
+ {%- endif -%}
236
+
237
+ {#- Render reasoning/reasoning_content as thinking channel -#}
238
+ {%- set thinking_text = message.get('reasoning') or message.get('reasoning_content') -%}
239
+ {%- if thinking_text and loop.index0 > ns_turn.last_user_idx and message.get('tool_calls') -%}
240
+ {{- '<|channel>thought\n' + thinking_text + '\n<channel|>' -}}
241
+ {%- endif -%}
242
+
243
+ {%- if message['tool_calls'] -%}
244
+ {%- for tool_call in message['tool_calls'] -%}
245
+ {%- set function = tool_call['function'] -%}
246
+ {{- '<|tool_call>call:' + function['name'] + '{' -}}
247
+ {%- if function['arguments'] is mapping -%}
248
+ {%- set ns_args = namespace(found_first=false) -%}
249
+ {%- for key, value in function['arguments'] | dictsort -%}
250
+ {%- if ns_args.found_first %},{% endif -%}
251
+ {%- set ns_args.found_first = true -%}
252
+ {{- key -}}:{{- format_argument(value, escape_keys=False) -}}
253
+ {%- endfor -%}
254
+ {%- elif function['arguments'] is string -%}
255
+ {{- function['arguments'] -}}
256
+ {%- endif -%}
257
+ {{- '}<tool_call|>' -}}
258
+ {%- endfor -%}
259
+ {%- set ns.prev_message_type = 'tool_call' -%}
260
+ {%- endif -%}
261
+
262
+ {%- set ns_tr_out = namespace(flag=false) -%}
263
+ {%- if message.get('tool_responses') -%}
264
+ {#- Legacy: tool_responses embedded on the assistant message (Google/Gemma native) -#}
265
+ {%- for tool_response in message['tool_responses'] -%}
266
+ {{- format_tool_response_block(tool_response['name'] | default('unknown'), tool_response['response']) -}}
267
+ {%- set ns_tr_out.flag = true -%}
268
+ {%- set ns.prev_message_type = 'tool_response' -%}
269
+ {%- endfor -%}
270
+ {%- elif message.get('tool_calls') -%}
271
+ {#- OpenAI Chat Completions: forward-scan consecutive role:tool messages -#}
272
+ {%- set ns_tool_scan = namespace(stopped=false) -%}
273
+ {%- for k in range(loop.index0 + 1, loop_messages | length) -%}
274
+ {%- if ns_tool_scan.stopped -%}
275
+ {%- elif loop_messages[k]['role'] != 'tool' -%}
276
+ {%- set ns_tool_scan.stopped = true -%}
277
+ {%- else -%}
278
+ {%- set follow = loop_messages[k] -%}
279
+ {#- Resolve tool_call_id to function name -#}
280
+ {%- set ns_tname = namespace(name=follow.get('name') | default('unknown')) -%}
281
+ {%- for tc in message['tool_calls'] -%}
282
+ {%- if tc.get('id') == follow.get('tool_call_id') -%}
283
+ {%- set ns_tname.name = tc['function']['name'] -%}
284
+ {%- endif -%}
285
+ {%- endfor -%}
286
+ {#- Handle content as string or content-parts array -#}
287
+ {%- set tool_body = follow.get('content') -%}
288
+ {%- if tool_body is string -%}
289
+ {{- format_tool_response_block(ns_tname.name, tool_body) -}}
290
+ {%- elif tool_body is sequence and tool_body is not string -%}
291
+ {%- set ns_txt = namespace(s='') -%}
292
+ {%- for part in tool_body -%}
293
+ {%- if part.get('type') == 'text' -%}
294
+ {%- set ns_txt.s = ns_txt.s + (part.get('text') | default('')) -%}
295
+ {%- endif -%}
296
+ {%- endfor -%}
297
+ {{- format_tool_response_block(ns_tname.name, ns_txt.s) -}}
298
+ {%- else -%}
299
+ {{- format_tool_response_block(ns_tname.name, tool_body) -}}
300
+ {%- endif -%}
301
+ {%- set ns_tr_out.flag = true -%}
302
+ {%- set ns.prev_message_type = 'tool_response' -%}
303
+ {%- endif -%}
304
+ {%- endfor -%}
305
+ {%- endif -%}
306
+
307
+ {%- set captured_content -%}
308
+ {%- if message['content'] is string -%}
309
+ {%- if role == 'model' -%}
310
+ {{- strip_thinking(message['content']) -}}
311
+ {%- else -%}
312
+ {{- message['content'] | trim -}}
313
+ {%- endif -%}
314
+ {%- elif message['content'] is sequence -%}
315
+ {%- for item in message['content'] -%}
316
+ {%- if item['type'] == 'text' -%}
317
+ {%- if role == 'model' -%}
318
+ {{- strip_thinking(item['text']) -}}
319
+ {%- else -%}
320
+ {{- item['text'] | trim -}}
321
+ {%- endif -%}
322
+ {%- elif item['type'] == 'image' -%}
323
+ {{- '<|image|>' -}}
324
+ {%- set ns.prev_message_type = 'image' -%}
325
+ {%- elif item['type'] == 'audio' -%}
326
+ {{- '<|audio|>' -}}
327
+ {%- set ns.prev_message_type = 'audio' -%}
328
+ {%- elif item['type'] == 'video' -%}
329
+ {{- '<|video|>' -}}
330
+ {%- set ns.prev_message_type = 'video' -%}
331
+ {%- endif -%}
332
+ {%- endfor -%}
333
+ {%- endif -%}
334
+ {%- endset -%}
335
+
336
+ {{- captured_content -}}
337
+ {%- set has_content = captured_content | trim | length > 0 -%}
338
+
339
+ {%- if ns.prev_message_type == 'tool_call' and not ns_tr_out.flag -%}
340
+ {{- '<|tool_response>' -}}
341
+ {%- elif not (ns_tr_out.flag and not has_content) -%}
342
+ {{- '<turn|>\n' -}}
343
+ {%- endif -%}
344
+ {%- endif -%}
345
+ {%- endfor -%}
346
+
347
+ {%- if add_generation_prompt -%}
348
+ {%- if ns.prev_message_type != 'tool_response' and ns.prev_message_type != 'tool_call' -%}
349
+ {{- '<|turn>model\n' -}}
350
+ {%- endif -%}
351
+ {%- endif -%}
tokenizer.json ADDED
@@ -0,0 +1,3 @@
 
 
 
 
1
+ version https://git-lfs.github.com/spec/v1
2
+ oid sha256:cc8d3a0ce36466ccc1278bf987df5f71db1719b9ca6b4118264f45cb627bfe0f
3
+ size 32169626
tokenizer_config.json ADDED
@@ -0,0 +1,96 @@
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
1
+ {
2
+ "audio_token": "<|audio|>",
3
+ "backend": "tokenizers",
4
+ "boa_token": "<|audio>",
5
+ "boi_token": "<|image>",
6
+ "bos_token": "<bos>",
7
+ "eoa_token": "<audio|>",
8
+ "eoc_token": "<channel|>",
9
+ "eoi_token": "<image|>",
10
+ "eos_token": "<turn|>",
11
+ "eot_token": "<turn|>",
12
+ "escape_token": "<|\"|>",
13
+ "etc_token": "<tool_call|>",
14
+ "etd_token": "<tool|>",
15
+ "etr_token": "<tool_response|>",
16
+ "extra_special_tokens": [
17
+ "<|video|>"
18
+ ],
19
+ "image_token": "<|image|>",
20
+ "is_local": false,
21
+ "local_files_only": false,
22
+ "mask_token": "<mask>",
23
+ "model_max_length": 131072,
24
+ "model_specific_special_tokens": {
25
+ "audio_token": "<|audio|>",
26
+ "boa_token": "<|audio>",
27
+ "boi_token": "<|image>",
28
+ "eoa_token": "<audio|>",
29
+ "eoc_token": "<channel|>",
30
+ "eoi_token": "<image|>",
31
+ "eot_token": "<turn|>",
32
+ "escape_token": "<|\"|>",
33
+ "etc_token": "<tool_call|>",
34
+ "etd_token": "<tool|>",
35
+ "etr_token": "<tool_response|>",
36
+ "image_token": "<|image|>",
37
+ "soc_token": "<|channel>",
38
+ "sot_token": "<|turn>",
39
+ "stc_token": "<|tool_call>",
40
+ "std_token": "<|tool>",
41
+ "str_token": "<|tool_response>",
42
+ "think_token": "<|think|>"
43
+ },
44
+ "pad_token": "<pad>",
45
+ "padding_side": "left",
46
+ "processor_class": "Gemma4Processor",
47
+ "response_schema": {
48
+ "properties": {
49
+ "content": {
50
+ "type": "string"
51
+ },
52
+ "role": {
53
+ "const": "assistant"
54
+ },
55
+ "thinking": {
56
+ "type": "string"
57
+ },
58
+ "tool_calls": {
59
+ "items": {
60
+ "properties": {
61
+ "function": {
62
+ "properties": {
63
+ "arguments": {
64
+ "additionalProperties": {},
65
+ "type": "object",
66
+ "x-parser": "gemma4-tool-call"
67
+ },
68
+ "name": {
69
+ "type": "string"
70
+ }
71
+ },
72
+ "type": "object",
73
+ "x-regex": "call\\:(?P<name>\\w+)(?P<arguments>\\{.*\\})"
74
+ },
75
+ "type": {
76
+ "const": "function"
77
+ }
78
+ },
79
+ "type": "object"
80
+ },
81
+ "type": "array",
82
+ "x-regex-iterator": "<\\|tool_call>(.*?)<tool_call\\|>"
83
+ }
84
+ },
85
+ "type": "object",
86
+ "x-regex": "(\\<\\|channel\\>thought\\n(?P<thinking>.*?)\\<channel\\|\\>)?(?P<tool_calls>\\<\\|tool_call\\>.*\\<tool_call\\|\\>)?(?P<content>(?:(?!\\<turn\\|\\>)(?!\\<\\|tool_response\\>).)+)?(?:\\<turn\\|\\>|\\<\\|tool_response\\>)?"
87
+ },
88
+ "soc_token": "<|channel>",
89
+ "sot_token": "<|turn>",
90
+ "stc_token": "<|tool_call>",
91
+ "std_token": "<|tool>",
92
+ "str_token": "<|tool_response>",
93
+ "think_token": "<|think|>",
94
+ "tokenizer_class": "GemmaTokenizer",
95
+ "unk_token": "<unk>"
96
+ }
training_args.bin ADDED
@@ -0,0 +1,3 @@
 
 
 
 
1
+ version https://git-lfs.github.com/spec/v1
2
+ oid sha256:44adcec10a3f291931b5b99ee50b90fe457b5b795f002103927b4a6ad411fb41
3
+ size 5777