Text Generation
PEFT
Safetensors
English
French
lora
qlora
function-calling
tool-calling
nemotron
llama-3.1
built-with-llama
multilingual
conversational
Eval Results (legacy)
abdelstark commited on
Commit
624b71d
·
verified ·
1 Parent(s): d813816

Add the bilingual en+fr adapter, tokenizer metadata, card, and run reports

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,199 @@
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
1
+ ---
2
+ language:
3
+ - en
4
+ - fr
5
+ license: other
6
+ license_name: nvidia-open-model-license
7
+ license_link: https://www.nvidia.com/en-us/agreements/enterprise-software/nvidia-open-model-license/
8
+ library_name: peft
9
+ pipeline_tag: text-generation
10
+ base_model: nvidia/Llama-3.1-Nemotron-Nano-8B-v1
11
+ base_model_relation: adapter
12
+ datasets:
13
+ - abdelstark/sommelier-xlam-single-call-splits
14
+ - abdelstark/sommelier-xlam-single-call-splits-fr
15
+ - Salesforce/xlam-function-calling-60k
16
+ tags:
17
+ - lora
18
+ - qlora
19
+ - peft
20
+ - function-calling
21
+ - tool-calling
22
+ - nemotron
23
+ - llama-3.1
24
+ - built-with-llama
25
+ - multilingual
26
+ model-index:
27
+ - name: llama-3.1-nemotron-nano-8b-xlam-tool-calling-fr-en-lora
28
+ results:
29
+ - task:
30
+ type: text-generation
31
+ name: Single JSON tool-call generation (English slice)
32
+ dataset:
33
+ type: abdelstark/sommelier-xlam-single-call-splits
34
+ name: sommelier-xlam-single-call-splits
35
+ split: test
36
+ metrics:
37
+ - type: valid_json_rate
38
+ name: Valid JSON rate
39
+ value: 0.997
40
+ - type: function_name_accuracy
41
+ name: Function name accuracy
42
+ value: 0.993
43
+ - type: argument_exact_match
44
+ name: Argument exact match
45
+ value: 0.873
46
+ - type: argument_f1
47
+ name: Argument F1 (micro, flattened keys)
48
+ value: 0.9211
49
+ - type: full_call_exact_match
50
+ name: Full-call exact match
51
+ value: 0.87
52
+ - task:
53
+ type: text-generation
54
+ name: Single JSON tool-call generation (French slice)
55
+ dataset:
56
+ type: abdelstark/sommelier-xlam-single-call-splits-fr
57
+ name: sommelier-xlam-single-call-splits-fr
58
+ split: test
59
+ metrics:
60
+ - type: valid_json_rate
61
+ name: Valid JSON rate
62
+ value: 0.9954
63
+ - type: function_name_accuracy
64
+ name: Function name accuracy
65
+ value: 0.9898
66
+ - type: argument_exact_match
67
+ name: Argument exact match
68
+ value: 0.8760
69
+ - type: argument_f1
70
+ name: Argument F1 (micro, flattened keys)
71
+ value: 0.9208
72
+ - type: full_call_exact_match
73
+ name: Full-call exact match
74
+ value: 0.8726
75
+ ---
76
+
77
+ # Llama-3.1-Nemotron-Nano-8B — bilingual (en+fr) xlam tool-calling LoRA
78
+
79
+ **Built with Llama.**
80
+
81
+ A QLoRA adapter for
82
+ [nvidia/Llama-3.1-Nemotron-Nano-8B-v1](https://huggingface.co/nvidia/Llama-3.1-Nemotron-Nano-8B-v1)
83
+ that turns free-form user requests, in English or French, plus a set of
84
+ JSON tool schemas into **exactly one schema-valid JSON tool call** — no
85
+ prose, no markdown fences, no explanations.
86
+
87
+ This is the v2 of
88
+ [llama-3.1-nemotron-nano-8b-xlam-tool-calling-lora](https://huggingface.co/abdelstark/llama-3.1-nemotron-nano-8b-xlam-tool-calling-lora):
89
+ same base model, same hyperparameters, same pipeline, one changed
90
+ variable — the training data adds a French paired variant of every
91
+ selected row ([abdelstark/sommelier-xlam-single-call-splits-fr](https://huggingface.co/datasets/abdelstark/sommelier-xlam-single-call-splits-fr)),
92
+ where only the query is translated and tool schemas and gold answers stay
93
+ byte identical. Trained and evaluated end to end with
94
+ [sommelier](https://github.com/AbdelStark/sommelier); this repository
95
+ contains the adapter weights, tokenizer metadata, and the machine-readable
96
+ evaluation evidence for the exact run that produced them
97
+ (`nemotron-8b-fr-full-4`).
98
+
99
+ ## Why this exists
100
+
101
+ Tool calling should work as well in French as in English, and that is a
102
+ claim worth measuring rather than assuming. Measured on this task family
103
+ (n=1000 en, n=879 fr, same prompts by digest, greedy decoding, conservative
104
+ parser):
105
+
106
+ - The base model loses 4.2 points of full-call exact match on French input
107
+ (0.663 vs 0.705).
108
+ - The English-only v1 adapter transfers surprisingly well, narrowing the
109
+ gap to 2.3 points (fr 0.851).
110
+ - This adapter closes the gap to measurement noise: **fr 0.873 vs en
111
+ 0.870** (+0.3 points, French slightly ahead).
112
+
113
+ ## Evaluation
114
+
115
+ Base model vs. this adapter, per language slice, on the held-out test
116
+ splits. Both evaluations used byte-identical prompts per slice, greedy
117
+ decoding (temperature 0.0, `max_new_tokens` 512), and the same conservative
118
+ parser (`sommelier.parser.v1`) that counts every parse failure as a metric
119
+ failure. The comparison is only written when config, test-split, per-slice
120
+ prompt-set, parser, and decoding digests all match.
121
+
122
+ ### English slice (n=1000)
123
+
124
+ | Metric | Base | Adapter | Delta |
125
+ |--------|------|---------|-------|
126
+ | valid_json_rate | 0.9160 | **0.9970** | +0.0810 |
127
+ | function_name_accuracy | 0.9110 | **0.9930** | +0.0820 |
128
+ | argument_exact_match | 0.7070 | **0.8730** | +0.1660 |
129
+ | argument_f1 | 0.7569 | **0.9211** | +0.1642 |
130
+ | full_call_exact_match | 0.7050 | **0.8700** | +0.1650 |
131
+
132
+ ### French slice (n=879)
133
+
134
+ | Metric | Base | Adapter | Delta |
135
+ |--------|------|---------|-------|
136
+ | valid_json_rate | 0.9044 | **0.9954** | +0.0910 |
137
+ | function_name_accuracy | 0.8976 | **0.9898** | +0.0922 |
138
+ | argument_exact_match | 0.6655 | **0.8760** | +0.2105 |
139
+ | argument_f1 | 0.7091 | **0.9208** | +0.2117 |
140
+ | full_call_exact_match | 0.6633 | **0.8726** | +0.2093 |
141
+
142
+ Relative to the v1 English-only adapter, the English slice sits 0.3 to 0.8
143
+ points lower (full-call 0.870 vs 0.874, argument F1 0.9211 vs 0.9291), within
144
+ one standard error at n=1000, while French gains 2.2 points of full-call
145
+ exact match. The full per-slice reports, the gated comparison with its
146
+ language-gaps section, and the runtime evidence (L40S, 5 h 42 m training,
147
+ peak 26,369 MiB, pinned package versions) are in [`reports/`](./reports).
148
+
149
+ ## Training
150
+
151
+ QLoRA (NF4, bf16 compute), rank 16, alpha 32, dropout 0.05, all seven
152
+ projection modules, 2 epochs, effective batch 16, cosine schedule with
153
+ 3 percent warmup, `max_sequence_length` 4096, completion-only loss with a
154
+ proven prompt boundary. Data: the 15,000-row English train split plus
155
+ 13,113 French paired rows (the French set runs short where the gold
156
+ contract rejects translation; the drop accounting is in the dataset card).
157
+ The system prompt stays English for both languages: the query language is
158
+ the only moving variable.
159
+
160
+ ## Usage
161
+
162
+ ```python
163
+ from peft import PeftModel
164
+ from transformers import AutoModelForCausalLM, AutoTokenizer
165
+
166
+ base = "nvidia/Llama-3.1-Nemotron-Nano-8B-v1"
167
+ adapter = "abdelstark/llama-3.1-nemotron-nano-8b-xlam-tool-calling-fr-en-lora"
168
+
169
+ tokenizer = AutoTokenizer.from_pretrained(base)
170
+ model = AutoModelForCausalLM.from_pretrained(base, dtype="auto", device_map="auto")
171
+ model = PeftModel.from_pretrained(model, adapter)
172
+ ```
173
+
174
+ Prompt format: system message with the instruction and the canonical JSON
175
+ of the available tools, then the user request (English or French); the
176
+ model answers with the canonical JSON of one tool call. See the
177
+ [sommelier documentation](https://abdelstark.github.io/sommelier/) for the
178
+ exact template contract.
179
+
180
+ ## Limitations
181
+
182
+ - Single tool call per request; multi-call plans are out of scope.
183
+ - One run, one seed. The French test slice is machine-translated (reviewed
184
+ on samples, not row by row) and excludes rows whose gold arguments embed
185
+ English text, so it is slightly biased toward language-neutral arguments.
186
+ - Exact canonical-JSON scoring penalizes semantically equivalent forms;
187
+ both models face the identical contract.
188
+ - Instruction-language effects are unmeasured: the system prompt is English
189
+ for both slices by design.
190
+
191
+ ## License and attribution
192
+
193
+ Adapter weights: [NVIDIA Open Model License](https://www.nvidia.com/en-us/agreements/enterprise-software/nvidia-open-model-license/),
194
+ as a derivative of nvidia/Llama-3.1-Nemotron-Nano-8B-v1. **Built with
195
+ Llama**: the base model derives from Llama 3.1 and this repository follows
196
+ the [Llama 3.1 Community License](https://www.llama.com/llama3_1/license/)
197
+ naming and notice requirements. Training data derives from
198
+ [Salesforce/xlam-function-calling-60k](https://huggingface.co/datasets/Salesforce/xlam-function-calling-60k)
199
+ (CC BY 4.0).
adapter_config.json ADDED
@@ -0,0 +1,48 @@
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
1
+ {
2
+ "alora_invocation_tokens": null,
3
+ "alpha_pattern": {},
4
+ "arrow_config": null,
5
+ "auto_mapping": null,
6
+ "base_model_name_or_path": "nvidia/Llama-3.1-Nemotron-Nano-8B-v1",
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": [
33
+ "k_proj",
34
+ "down_proj",
35
+ "gate_proj",
36
+ "v_proj",
37
+ "q_proj",
38
+ "up_proj",
39
+ "o_proj"
40
+ ],
41
+ "target_parameters": null,
42
+ "task_type": "CAUSAL_LM",
43
+ "trainable_token_indices": null,
44
+ "use_bdlora": null,
45
+ "use_dora": false,
46
+ "use_qalora": false,
47
+ "use_rslora": false
48
+ }
adapter_model.safetensors ADDED
@@ -0,0 +1,3 @@
 
 
 
 
1
+ version https://git-lfs.github.com/spec/v1
2
+ oid sha256:5fe9eaa16fde9317e0e2bcb5801d683ad8dc87108bd1b8275e54776384c74d89
3
+ size 167832240
chat_template.jinja ADDED
@@ -0,0 +1,17 @@
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
1
+ {%- if messages[0]['role'] == 'system' -%}{%- set system_message = messages[0]['content'] | trim -%}{%- set messages = messages[1:] -%}{%- else -%}{%- set system_message = '' -%}{%- endif -%}{%- if tools is not none -%}{{- '<|begin_of_text|><|start_header_id|>system<|end_header_id|>' + '
2
+
3
+ ' + system_message -}} {{- '
4
+
5
+ ' if system_message else '' -}} {{- '<AVAILABLE_TOOLS>[' -}} {% for t in tools %}{{- (t.function if t.function is defined else t) | tojson() -}}{{- ', ' if not loop.last else '' -}}{%- endfor -%} {{- ']</AVAILABLE_TOOLS>' -}} {{- '<|eot_id|>' -}}{%- else -%}{{- '<|begin_of_text|><|start_header_id|>system<|end_header_id|>' + '
6
+
7
+ ' + system_message + '<|eot_id|>' -}}{%- endif -%}{%- for message in messages -%}{%- if (message['role'] in ['user', 'tool']) != (loop.index0 % 2 == 0) -%}{{- raise_exception('Conversation roles must alternate between user/tool and assistant') -}}{%- elif message['role'] == 'user' -%}{{- '<|start_header_id|>user<|end_header_id|>' + '
8
+
9
+ ' + message['content'] | trim + '<|eot_id|>' -}}{%- elif message['role'] == 'tool' -%}{%- set tool_response = '<TOOL_RESPONSE>[' + message['content'] | trim + ']</TOOL_RESPONSE>' -%}{{- '<|start_header_id|>user<|end_header_id|>' + '
10
+
11
+ ' + tool_response + '<|eot_id|>' -}}{%- elif message['role'] == 'assistant' and message.get('tool_calls') is not none -%}{%- set tool_calls = message['tool_calls'] -%}{{- '<|start_header_id|>assistant<|end_header_id|>' + '
12
+
13
+ ' + '<TOOLCALL>[' -}}{%- for tool_call in tool_calls -%}{{ '{' + '"name": "' + tool_call.function.name + '", "arguments": ' + tool_call.function.arguments | tojson + '}' }}{%- if not loop.last -%}{{ ', ' }}{%- else -%}{{ ']</TOOLCALL>' + '<|eot_id|>' }}{%- endif -%}{%- endfor -%}{%- elif message['role'] == 'assistant' -%}{{- '<|start_header_id|>assistant<|end_header_id|>' + '
14
+
15
+ ' + message['content'] | trim + '<|eot_id|>' -}}{%- endif -%}{%- endfor -%}{%- if add_generation_prompt -%}{{ '<|start_header_id|>assistant<|end_header_id|>' + '
16
+
17
+ ' }}{%- endif -%}
reports/comparison_report.json ADDED
@@ -0,0 +1,286 @@
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
1
+ {
2
+ "adapter": {
3
+ "adapter_source": {
4
+ "kind": "local_directory",
5
+ "revision": null,
6
+ "source": "/__modal/volumes/vo-I7HI9wRvHXpMpsKs7Yc61o/artifacts/runs/nemotron-8b-fr-full-4/train/adapter"
7
+ },
8
+ "metrics": {
9
+ "argument_exact_match": {
10
+ "denominator": 1879,
11
+ "numerator": 1643,
12
+ "value": 0.8744012772751464
13
+ },
14
+ "argument_f1": {
15
+ "denominator": 10207,
16
+ "numerator": 9400,
17
+ "value": 0.9209366121289311
18
+ },
19
+ "full_call_exact_match": {
20
+ "denominator": 1879,
21
+ "numerator": 1637,
22
+ "value": 0.8712080894092602
23
+ },
24
+ "function_name_accuracy": {
25
+ "denominator": 1879,
26
+ "numerator": 1863,
27
+ "value": 0.9914848323576371
28
+ },
29
+ "valid_json_rate": {
30
+ "denominator": 1879,
31
+ "numerator": 1872,
32
+ "value": 0.9962746141564662
33
+ }
34
+ },
35
+ "run_id": "nemotron-8b-fr-full-4"
36
+ },
37
+ "base": {
38
+ "adapter_source": null,
39
+ "metrics": {
40
+ "argument_exact_match": {
41
+ "denominator": 1879,
42
+ "numerator": 1292,
43
+ "value": 0.6875997871208089
44
+ },
45
+ "argument_f1": {
46
+ "denominator": 9328,
47
+ "numerator": 6858,
48
+ "value": 0.7352058319039451
49
+ },
50
+ "full_call_exact_match": {
51
+ "denominator": 1879,
52
+ "numerator": 1288,
53
+ "value": 0.6854709952102181
54
+ },
55
+ "function_name_accuracy": {
56
+ "denominator": 1879,
57
+ "numerator": 1700,
58
+ "value": 0.9047365620010644
59
+ },
60
+ "valid_json_rate": {
61
+ "denominator": 1879,
62
+ "numerator": 1711,
63
+ "value": 0.9105907397551889
64
+ }
65
+ },
66
+ "run_id": "nemotron-8b-fr-full-4"
67
+ },
68
+ "created_at": "2026-07-06T09:06:44.927671+00:00",
69
+ "deltas": {
70
+ "argument_exact_match": 0.18680149015433745,
71
+ "argument_f1": 0.18573078022498601,
72
+ "full_call_exact_match": 0.18573709419904205,
73
+ "function_name_accuracy": 0.08674827035657262,
74
+ "valid_json_rate": 0.08568387440127734
75
+ },
76
+ "language_gaps": {
77
+ "adapter": {
78
+ "fr": {
79
+ "argument_exact_match": 0.002995449374288972,
80
+ "argument_f1": -0.0003166404540679846,
81
+ "full_call_exact_match": 0.0025824800910124734,
82
+ "function_name_accuracy": -0.0032389078498293866,
83
+ "valid_json_rate": -0.0015506257110352584
84
+ }
85
+ },
86
+ "base": {
87
+ "fr": {
88
+ "argument_exact_match": -0.04147098976109209,
89
+ "argument_f1": -0.04786359932831308,
90
+ "full_call_exact_match": -0.04174630261660972,
91
+ "function_name_accuracy": -0.013389078498293516,
92
+ "valid_json_rate": -0.01156313993174063
93
+ }
94
+ },
95
+ "reference": "en"
96
+ },
97
+ "run_id": "nemotron-8b-fr-full-4",
98
+ "runtime": {
99
+ "available": true,
100
+ "cost_source": "unavailable",
101
+ "hardware": {
102
+ "gpu": "L40S",
103
+ "source": "config"
104
+ },
105
+ "observed_cost_usd": null,
106
+ "peak_gpu_memory_mb": 26369,
107
+ "schema_version": "sommelier.runtime_metadata.v1",
108
+ "stages": {
109
+ "data": {
110
+ "elapsed_seconds": 8.057
111
+ },
112
+ "eval-adapter": {
113
+ "elapsed_seconds": 2835.133
114
+ },
115
+ "eval-base": {
116
+ "elapsed_seconds": 1805.156
117
+ },
118
+ "format": {
119
+ "elapsed_seconds": 30.606
120
+ },
121
+ "train": {
122
+ "elapsed_seconds": 20540.327
123
+ }
124
+ }
125
+ },
126
+ "schema_version": "sommelier.comparison_report.v2",
127
+ "shared": {
128
+ "config_sha256": "87a6c067167d801d85cbf3105d08b145c62955f4298de0559a0c44608e3fca89",
129
+ "decoding": {
130
+ "do_sample": false,
131
+ "max_new_tokens": 512,
132
+ "temperature": 0.0
133
+ },
134
+ "parser_version": "sommelier.parser.v1",
135
+ "split": "test",
136
+ "test_split_sha256": "11267f2e2e6293b6132a1a955b28a84caa12b15c980a2a39653d4e4ee33d80e9"
137
+ },
138
+ "slices": {
139
+ "en": {
140
+ "adapter": {
141
+ "metrics": {
142
+ "argument_exact_match": {
143
+ "denominator": 1000,
144
+ "numerator": 873,
145
+ "value": 0.873
146
+ },
147
+ "argument_f1": {
148
+ "denominator": 5550,
149
+ "numerator": 5112,
150
+ "value": 0.9210810810810811
151
+ },
152
+ "full_call_exact_match": {
153
+ "denominator": 1000,
154
+ "numerator": 870,
155
+ "value": 0.87
156
+ },
157
+ "function_name_accuracy": {
158
+ "denominator": 1000,
159
+ "numerator": 993,
160
+ "value": 0.993
161
+ },
162
+ "valid_json_rate": {
163
+ "denominator": 1000,
164
+ "numerator": 997,
165
+ "value": 0.997
166
+ }
167
+ }
168
+ },
169
+ "base": {
170
+ "metrics": {
171
+ "argument_exact_match": {
172
+ "denominator": 1000,
173
+ "numerator": 707,
174
+ "value": 0.707
175
+ },
176
+ "argument_f1": {
177
+ "denominator": 5097,
178
+ "numerator": 3858,
179
+ "value": 0.7569158328428487
180
+ },
181
+ "full_call_exact_match": {
182
+ "denominator": 1000,
183
+ "numerator": 705,
184
+ "value": 0.705
185
+ },
186
+ "function_name_accuracy": {
187
+ "denominator": 1000,
188
+ "numerator": 911,
189
+ "value": 0.911
190
+ },
191
+ "valid_json_rate": {
192
+ "denominator": 1000,
193
+ "numerator": 916,
194
+ "value": 0.916
195
+ }
196
+ }
197
+ },
198
+ "deltas": {
199
+ "argument_exact_match": 0.16600000000000004,
200
+ "argument_f1": 0.16416524823823242,
201
+ "full_call_exact_match": 0.16500000000000004,
202
+ "function_name_accuracy": 0.08199999999999996,
203
+ "valid_json_rate": 0.08099999999999996
204
+ },
205
+ "examples": 1000,
206
+ "generation_artifacts": {
207
+ "adapter": "runs/nemotron-8b-fr-full-4/eval/adapter/generations.en.jsonl",
208
+ "base": "runs/nemotron-8b-fr-full-4/eval/base/generations.en.jsonl"
209
+ },
210
+ "prompt_set_sha256": "a0da8fa28835a329dba5c5314ada3aff21f950939af2e1ae186155d3b494f39a"
211
+ },
212
+ "fr": {
213
+ "adapter": {
214
+ "metrics": {
215
+ "argument_exact_match": {
216
+ "denominator": 879,
217
+ "numerator": 770,
218
+ "value": 0.875995449374289
219
+ },
220
+ "argument_f1": {
221
+ "denominator": 4657,
222
+ "numerator": 4288,
223
+ "value": 0.9207644406270131
224
+ },
225
+ "full_call_exact_match": {
226
+ "denominator": 879,
227
+ "numerator": 767,
228
+ "value": 0.8725824800910125
229
+ },
230
+ "function_name_accuracy": {
231
+ "denominator": 879,
232
+ "numerator": 870,
233
+ "value": 0.9897610921501706
234
+ },
235
+ "valid_json_rate": {
236
+ "denominator": 879,
237
+ "numerator": 875,
238
+ "value": 0.9954493742889647
239
+ }
240
+ }
241
+ },
242
+ "base": {
243
+ "metrics": {
244
+ "argument_exact_match": {
245
+ "denominator": 879,
246
+ "numerator": 585,
247
+ "value": 0.6655290102389079
248
+ },
249
+ "argument_f1": {
250
+ "denominator": 4231,
251
+ "numerator": 3000,
252
+ "value": 0.7090522335145356
253
+ },
254
+ "full_call_exact_match": {
255
+ "denominator": 879,
256
+ "numerator": 583,
257
+ "value": 0.6632536973833902
258
+ },
259
+ "function_name_accuracy": {
260
+ "denominator": 879,
261
+ "numerator": 789,
262
+ "value": 0.8976109215017065
263
+ },
264
+ "valid_json_rate": {
265
+ "denominator": 879,
266
+ "numerator": 795,
267
+ "value": 0.9044368600682594
268
+ }
269
+ }
270
+ },
271
+ "deltas": {
272
+ "argument_exact_match": 0.2104664391353811,
273
+ "argument_f1": 0.2117122071124775,
274
+ "full_call_exact_match": 0.20932878270762223,
275
+ "function_name_accuracy": 0.09215017064846409,
276
+ "valid_json_rate": 0.09101251422070533
277
+ },
278
+ "examples": 879,
279
+ "generation_artifacts": {
280
+ "adapter": "runs/nemotron-8b-fr-full-4/eval/adapter/generations.fr.jsonl",
281
+ "base": "runs/nemotron-8b-fr-full-4/eval/base/generations.fr.jsonl"
282
+ },
283
+ "prompt_set_sha256": "b6111339b6dd6d6a911aeea4e0bf960bd3d78cd68ed14a1da05403aeacb76783"
284
+ }
285
+ }
286
+ }
reports/comparison_report.md ADDED
@@ -0,0 +1,103 @@
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
1
+ # Sommelier Comparison Report
2
+
3
+ The JSON report (`comparison_report.json`) is authoritative for automation; this document is a human rendering.
4
+
5
+ ## Run Identity
6
+
7
+ - Run ID: `nemotron-8b-fr-full-4`
8
+ - Evidence class: full run
9
+ - Created at: 2026-07-06T09:06:44.927671+00:00
10
+ - Config digest: `87a6c067167d801d85cbf3105d08b145c62955f4298de0559a0c44608e3fca89`
11
+ - Parser version: `sommelier.parser.v1`
12
+ - Decoding: `{"do_sample": false, "max_new_tokens": 512, "temperature": 0.0}`
13
+ - Adapter source: `/__modal/volumes/vo-I7HI9wRvHXpMpsKs7Yc61o/artifacts/runs/nemotron-8b-fr-full-4/train/adapter` (local_directory, revision None)
14
+
15
+ ## Split Summary
16
+
17
+ - Split: test
18
+ - Slices: `en`, `fr`
19
+ - Examples evaluated: 1879 across all slices
20
+ - Test split digest: `11267f2e2e6293b6132a1a955b28a84caa12b15c980a2a39653d4e4ee33d80e9`
21
+
22
+ ## Metrics, all slices
23
+
24
+ | Metric | Base | Adapter | Delta |
25
+ |--------|------|---------|-------|
26
+ | argument_exact_match | 0.6876 (1292/1879) | 0.8744 (1643/1879) | +0.1868 |
27
+ | argument_f1 | 0.7352 (6858/9328) | 0.9209 (9400/10207) | +0.1857 |
28
+ | full_call_exact_match | 0.6855 (1288/1879) | 0.8712 (1637/1879) | +0.1857 |
29
+ | function_name_accuracy | 0.9047 (1700/1879) | 0.9915 (1863/1879) | +0.0867 |
30
+ | valid_json_rate | 0.9106 (1711/1879) | 0.9963 (1872/1879) | +0.0857 |
31
+
32
+ ## Metrics, slice `en`
33
+
34
+ - Examples: 1000
35
+ - Prompt set digest: `a0da8fa28835a329dba5c5314ada3aff21f950939af2e1ae186155d3b494f39a`
36
+
37
+ | Metric | Base | Adapter | Delta |
38
+ |--------|------|---------|-------|
39
+ | argument_exact_match | 0.7070 (707/1000) | 0.8730 (873/1000) | +0.1660 |
40
+ | argument_f1 | 0.7569 (3858/5097) | 0.9211 (5112/5550) | +0.1642 |
41
+ | full_call_exact_match | 0.7050 (705/1000) | 0.8700 (870/1000) | +0.1650 |
42
+ | function_name_accuracy | 0.9110 (911/1000) | 0.9930 (993/1000) | +0.0820 |
43
+ | valid_json_rate | 0.9160 (916/1000) | 0.9970 (997/1000) | +0.0810 |
44
+
45
+ ## Metrics, slice `fr`
46
+
47
+ - Examples: 879
48
+ - Prompt set digest: `b6111339b6dd6d6a911aeea4e0bf960bd3d78cd68ed14a1da05403aeacb76783`
49
+
50
+ | Metric | Base | Adapter | Delta |
51
+ |--------|------|---------|-------|
52
+ | argument_exact_match | 0.6655 (585/879) | 0.8760 (770/879) | +0.2105 |
53
+ | argument_f1 | 0.7091 (3000/4231) | 0.9208 (4288/4657) | +0.2117 |
54
+ | full_call_exact_match | 0.6633 (583/879) | 0.8726 (767/879) | +0.2093 |
55
+ | function_name_accuracy | 0.8976 (789/879) | 0.9898 (870/879) | +0.0922 |
56
+ | valid_json_rate | 0.9044 (795/879) | 0.9954 (875/879) | +0.0910 |
57
+
58
+ ## Language Gaps
59
+
60
+ Each slice against the `en` reference slice (positive means the slice scores higher):
61
+
62
+ ### `fr` minus `en`
63
+
64
+ | Metric | Base gap | Adapter gap |
65
+ |--------|----------|-------------|
66
+ | argument_exact_match | -0.0415 | +0.0030 |
67
+ | argument_f1 | -0.0479 | -0.0003 |
68
+ | full_call_exact_match | -0.0417 | +0.0026 |
69
+ | function_name_accuracy | -0.0134 | -0.0032 |
70
+ | valid_json_rate | -0.0116 | -0.0016 |
71
+
72
+
73
+ ## Runtime and Cost
74
+
75
+ - Hardware: L40S (source: config)
76
+ - Peak GPU memory: 26369 MiB
77
+ - Observed cost: unavailable (source: unavailable)
78
+ - data: 8.057 s elapsed
79
+ - eval-adapter: 2835.133 s elapsed
80
+ - eval-base: 1805.156 s elapsed
81
+ - format: 30.606 s elapsed
82
+ - train: 20540.327 s elapsed
83
+
84
+ ## Reproduction
85
+
86
+ Using the resolved config stored in this run directory:
87
+
88
+ ```bash
89
+ sommelier eval run --config config.resolved.yaml --model base --data formatted --out eval/base --run-id nemotron-8b-fr-full-4
90
+ sommelier train run --config config.resolved.yaml --data formatted --out train/adapter --run-id nemotron-8b-fr-full-4
91
+ sommelier eval run --config config.resolved.yaml --model adapter --adapter train/adapter --data formatted --out eval/adapter --run-id nemotron-8b-fr-full-4
92
+ sommelier report compare --base eval/base --adapter eval/adapter --out report
93
+ ```
94
+
95
+ Generation artifacts per slice: `en`: `runs/nemotron-8b-fr-full-4/eval/base/generations.en.jsonl` (base), `runs/nemotron-8b-fr-full-4/eval/adapter/generations.en.jsonl` (adapter); `fr`: `runs/nemotron-8b-fr-full-4/eval/base/generations.fr.jsonl` (base), `runs/nemotron-8b-fr-full-4/eval/adapter/generations.fr.jsonl` (adapter).
96
+
97
+ ## Limitations
98
+
99
+ - Metrics measure schema-valid single tool calls on the configured held-out test split only; multi-call plans are out of scope.
100
+ - Non-English slices are machine-translated variants of the English test rows, not natively authored requests, and share their gold answers by construction.
101
+ - Argument comparisons are exact canonical-JSON matches; semantically equivalent but differently formatted values count as mismatches.
102
+ - Results describe the recorded run (hardware, dependencies, dataset revision) and do not claim production readiness, broad reliability, or generalization beyond the evaluated split.
103
+ - Parse failures count against every metric; raw generations are retained for audit.
reports/evaluation_report_adapter.json ADDED
@@ -0,0 +1,113 @@
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
1
+ {
2
+ "adapter_source": {
3
+ "kind": "local_directory",
4
+ "revision": null,
5
+ "source": "/__modal/volumes/vo-I7HI9wRvHXpMpsKs7Yc61o/artifacts/runs/nemotron-8b-fr-full-4/train/adapter"
6
+ },
7
+ "config_sha256": "87a6c067167d801d85cbf3105d08b145c62955f4298de0559a0c44608e3fca89",
8
+ "created_at": "2026-07-06T09:06:43.409328+00:00",
9
+ "decoding": {
10
+ "do_sample": false,
11
+ "max_new_tokens": 512,
12
+ "temperature": 0.0
13
+ },
14
+ "metrics": {
15
+ "argument_exact_match": {
16
+ "denominator": 1879,
17
+ "numerator": 1643,
18
+ "value": 0.8744012772751464
19
+ },
20
+ "argument_f1": {
21
+ "denominator": 10207,
22
+ "numerator": 9400,
23
+ "value": 0.9209366121289311
24
+ },
25
+ "full_call_exact_match": {
26
+ "denominator": 1879,
27
+ "numerator": 1637,
28
+ "value": 0.8712080894092602
29
+ },
30
+ "function_name_accuracy": {
31
+ "denominator": 1879,
32
+ "numerator": 1863,
33
+ "value": 0.9914848323576371
34
+ },
35
+ "valid_json_rate": {
36
+ "denominator": 1879,
37
+ "numerator": 1872,
38
+ "value": 0.9962746141564662
39
+ }
40
+ },
41
+ "model_kind": "adapter",
42
+ "parser_version": "sommelier.parser.v1",
43
+ "run_id": "nemotron-8b-fr-full-4",
44
+ "schema_version": "sommelier.evaluation_report.v2",
45
+ "slices": {
46
+ "en": {
47
+ "examples": 1000,
48
+ "generation_artifact": "runs/nemotron-8b-fr-full-4/eval/adapter/generations.en.jsonl",
49
+ "metrics": {
50
+ "argument_exact_match": {
51
+ "denominator": 1000,
52
+ "numerator": 873,
53
+ "value": 0.873
54
+ },
55
+ "argument_f1": {
56
+ "denominator": 5550,
57
+ "numerator": 5112,
58
+ "value": 0.9210810810810811
59
+ },
60
+ "full_call_exact_match": {
61
+ "denominator": 1000,
62
+ "numerator": 870,
63
+ "value": 0.87
64
+ },
65
+ "function_name_accuracy": {
66
+ "denominator": 1000,
67
+ "numerator": 993,
68
+ "value": 0.993
69
+ },
70
+ "valid_json_rate": {
71
+ "denominator": 1000,
72
+ "numerator": 997,
73
+ "value": 0.997
74
+ }
75
+ },
76
+ "prompt_set_sha256": "a0da8fa28835a329dba5c5314ada3aff21f950939af2e1ae186155d3b494f39a"
77
+ },
78
+ "fr": {
79
+ "examples": 879,
80
+ "generation_artifact": "runs/nemotron-8b-fr-full-4/eval/adapter/generations.fr.jsonl",
81
+ "metrics": {
82
+ "argument_exact_match": {
83
+ "denominator": 879,
84
+ "numerator": 770,
85
+ "value": 0.875995449374289
86
+ },
87
+ "argument_f1": {
88
+ "denominator": 4657,
89
+ "numerator": 4288,
90
+ "value": 0.9207644406270131
91
+ },
92
+ "full_call_exact_match": {
93
+ "denominator": 879,
94
+ "numerator": 767,
95
+ "value": 0.8725824800910125
96
+ },
97
+ "function_name_accuracy": {
98
+ "denominator": 879,
99
+ "numerator": 870,
100
+ "value": 0.9897610921501706
101
+ },
102
+ "valid_json_rate": {
103
+ "denominator": 879,
104
+ "numerator": 875,
105
+ "value": 0.9954493742889647
106
+ }
107
+ },
108
+ "prompt_set_sha256": "b6111339b6dd6d6a911aeea4e0bf960bd3d78cd68ed14a1da05403aeacb76783"
109
+ }
110
+ },
111
+ "split": "test",
112
+ "test_split_sha256": "11267f2e2e6293b6132a1a955b28a84caa12b15c980a2a39653d4e4ee33d80e9"
113
+ }
reports/evaluation_report_base.json ADDED
@@ -0,0 +1,109 @@
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
1
+ {
2
+ "adapter_source": null,
3
+ "config_sha256": "87a6c067167d801d85cbf3105d08b145c62955f4298de0559a0c44608e3fca89",
4
+ "created_at": "2026-07-06T02:37:07.786757+00:00",
5
+ "decoding": {
6
+ "do_sample": false,
7
+ "max_new_tokens": 512,
8
+ "temperature": 0.0
9
+ },
10
+ "metrics": {
11
+ "argument_exact_match": {
12
+ "denominator": 1879,
13
+ "numerator": 1292,
14
+ "value": 0.6875997871208089
15
+ },
16
+ "argument_f1": {
17
+ "denominator": 9328,
18
+ "numerator": 6858,
19
+ "value": 0.7352058319039451
20
+ },
21
+ "full_call_exact_match": {
22
+ "denominator": 1879,
23
+ "numerator": 1288,
24
+ "value": 0.6854709952102181
25
+ },
26
+ "function_name_accuracy": {
27
+ "denominator": 1879,
28
+ "numerator": 1700,
29
+ "value": 0.9047365620010644
30
+ },
31
+ "valid_json_rate": {
32
+ "denominator": 1879,
33
+ "numerator": 1711,
34
+ "value": 0.9105907397551889
35
+ }
36
+ },
37
+ "model_kind": "base",
38
+ "parser_version": "sommelier.parser.v1",
39
+ "run_id": "nemotron-8b-fr-full-4",
40
+ "schema_version": "sommelier.evaluation_report.v2",
41
+ "slices": {
42
+ "en": {
43
+ "examples": 1000,
44
+ "generation_artifact": "runs/nemotron-8b-fr-full-4/eval/base/generations.en.jsonl",
45
+ "metrics": {
46
+ "argument_exact_match": {
47
+ "denominator": 1000,
48
+ "numerator": 707,
49
+ "value": 0.707
50
+ },
51
+ "argument_f1": {
52
+ "denominator": 5097,
53
+ "numerator": 3858,
54
+ "value": 0.7569158328428487
55
+ },
56
+ "full_call_exact_match": {
57
+ "denominator": 1000,
58
+ "numerator": 705,
59
+ "value": 0.705
60
+ },
61
+ "function_name_accuracy": {
62
+ "denominator": 1000,
63
+ "numerator": 911,
64
+ "value": 0.911
65
+ },
66
+ "valid_json_rate": {
67
+ "denominator": 1000,
68
+ "numerator": 916,
69
+ "value": 0.916
70
+ }
71
+ },
72
+ "prompt_set_sha256": "a0da8fa28835a329dba5c5314ada3aff21f950939af2e1ae186155d3b494f39a"
73
+ },
74
+ "fr": {
75
+ "examples": 879,
76
+ "generation_artifact": "runs/nemotron-8b-fr-full-4/eval/base/generations.fr.jsonl",
77
+ "metrics": {
78
+ "argument_exact_match": {
79
+ "denominator": 879,
80
+ "numerator": 585,
81
+ "value": 0.6655290102389079
82
+ },
83
+ "argument_f1": {
84
+ "denominator": 4231,
85
+ "numerator": 3000,
86
+ "value": 0.7090522335145356
87
+ },
88
+ "full_call_exact_match": {
89
+ "denominator": 879,
90
+ "numerator": 583,
91
+ "value": 0.6632536973833902
92
+ },
93
+ "function_name_accuracy": {
94
+ "denominator": 879,
95
+ "numerator": 789,
96
+ "value": 0.8976109215017065
97
+ },
98
+ "valid_json_rate": {
99
+ "denominator": 879,
100
+ "numerator": 795,
101
+ "value": 0.9044368600682594
102
+ }
103
+ },
104
+ "prompt_set_sha256": "b6111339b6dd6d6a911aeea4e0bf960bd3d78cd68ed14a1da05403aeacb76783"
105
+ }
106
+ },
107
+ "split": "test",
108
+ "test_split_sha256": "11267f2e2e6293b6132a1a955b28a84caa12b15c980a2a39653d4e4ee33d80e9"
109
+ }
reports/runtime_metadata.json ADDED
@@ -0,0 +1,30 @@
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
1
+ {
2
+ "cost_source": "unavailable",
3
+ "hardware": {
4
+ "gpu": "L40S",
5
+ "source": "config"
6
+ },
7
+ "observed_cost_usd": null,
8
+ "peak_gpu_memory_mb": 26369,
9
+ "schema_version": "sommelier.runtime_metadata.v1",
10
+ "stages": {
11
+ "compare": {
12
+ "elapsed_seconds": 1.121
13
+ },
14
+ "data": {
15
+ "elapsed_seconds": 8.057
16
+ },
17
+ "eval-adapter": {
18
+ "elapsed_seconds": 2835.133
19
+ },
20
+ "eval-base": {
21
+ "elapsed_seconds": 1805.156
22
+ },
23
+ "format": {
24
+ "elapsed_seconds": 30.606
25
+ },
26
+ "train": {
27
+ "elapsed_seconds": 20540.327
28
+ }
29
+ }
30
+ }
tokenizer.json ADDED
@@ -0,0 +1,3 @@
 
 
 
 
1
+ version https://git-lfs.github.com/spec/v1
2
+ oid sha256:6b9e4e7fb171f92fd137b777cc2714bf87d11576700a1dcd7a399e7bbe39537b
3
+ size 17209920
tokenizer_config.json ADDED
@@ -0,0 +1,15 @@
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
1
+ {
2
+ "backend": "tokenizers",
3
+ "bos_token": "<|begin_of_text|>",
4
+ "clean_up_tokenization_spaces": true,
5
+ "eos_token": "<|eot_id|>",
6
+ "is_local": false,
7
+ "local_files_only": false,
8
+ "model_input_names": [
9
+ "input_ids",
10
+ "attention_mask"
11
+ ],
12
+ "model_max_length": 131072,
13
+ "pad_token": "<|eot_id|>",
14
+ "tokenizer_class": "TokenizersBackend"
15
+ }