Caesarrr commited on
Commit
5381a3a
·
verified ·
1 Parent(s): c78b688

Publish latency-aware/mikasa-intercept-grab-fast/vla/starvla-qwenoft-h8/fixed3-prefix63-restart-20260925/training/bootstrap/step_05000

Browse files
Files changed (14) hide show
  1. latency-aware/mikasa-intercept-grab-fast/vla/starvla-qwenoft-h8/fixed3-prefix63-restart-20260925/training/bootstrap/step_05000/checkpoints/model.pt +3 -0
  2. latency-aware/mikasa-intercept-grab-fast/vla/starvla-qwenoft-h8/fixed3-prefix63-restart-20260925/training/bootstrap/step_05000/config.yaml +35 -0
  3. latency-aware/mikasa-intercept-grab-fast/vla/starvla-qwenoft-h8/fixed3-prefix63-restart-20260925/training/bootstrap/step_05000/dataset_statistics.json +463 -0
  4. latency-aware/mikasa-intercept-grab-fast/vla/starvla-qwenoft-h8/fixed3-prefix63-restart-20260925/training/bootstrap/step_05000/provenance.json +6 -0
  5. latency-aware/mikasa-intercept-grab-fast/vla/starvla-qwenoft-h8/fixed3-prefix63-restart-20260925/training/bootstrap/step_05000/task_contract.json +504 -0
  6. latency-aware/mikasa-intercept-grab-fast/vla/starvla-qwenoft-h8/fixed3-prefix63-restart-20260925/training/bootstrap/step_05000/trainer_config.yaml +103 -0
  7. latency-aware/mikasa-intercept-grab-fast/vla/starvla-qwenoft-h8/fixed3-prefix63-restart-20260925/training/bootstrap/step_05000/trainer_state/custom_checkpoint_0.pkl +3 -0
  8. latency-aware/mikasa-intercept-grab-fast/vla/starvla-qwenoft-h8/fixed3-prefix63-restart-20260925/training/bootstrap/step_05000/trainer_state/latest +1 -0
  9. latency-aware/mikasa-intercept-grab-fast/vla/starvla-qwenoft-h8/fixed3-prefix63-restart-20260925/training/bootstrap/step_05000/trainer_state/pytorch_model/bf16_zero_pp_rank_0_mp_rank_00_optim_states.pt +3 -0
  10. latency-aware/mikasa-intercept-grab-fast/vla/starvla-qwenoft-h8/fixed3-prefix63-restart-20260925/training/bootstrap/step_05000/trainer_state/pytorch_model/bf16_zero_pp_rank_1_mp_rank_00_optim_states.pt +3 -0
  11. latency-aware/mikasa-intercept-grab-fast/vla/starvla-qwenoft-h8/fixed3-prefix63-restart-20260925/training/bootstrap/step_05000/trainer_state/pytorch_model/mp_rank_00_model_states.pt +3 -0
  12. latency-aware/mikasa-intercept-grab-fast/vla/starvla-qwenoft-h8/fixed3-prefix63-restart-20260925/training/bootstrap/step_05000/trainer_state/random_states_0.pkl +3 -0
  13. latency-aware/mikasa-intercept-grab-fast/vla/starvla-qwenoft-h8/fixed3-prefix63-restart-20260925/training/bootstrap/step_05000/trainer_state/random_states_1.pkl +3 -0
  14. latency-aware/mikasa-intercept-grab-fast/vla/starvla-qwenoft-h8/fixed3-prefix63-restart-20260925/training/bootstrap/step_05000/trainer_state/zero_to_fp32.py +760 -0
latency-aware/mikasa-intercept-grab-fast/vla/starvla-qwenoft-h8/fixed3-prefix63-restart-20260925/training/bootstrap/step_05000/checkpoints/model.pt ADDED
@@ -0,0 +1,3 @@
 
 
 
 
1
+ version https://git-lfs.github.com/spec/v1
2
+ oid sha256:71fc61428601747d9b70af75265e618350a56d9c1c06f812052ad62f149dea93
3
+ size 9785388449
latency-aware/mikasa-intercept-grab-fast/vla/starvla-qwenoft-h8/fixed3-prefix63-restart-20260925/training/bootstrap/step_05000/config.yaml ADDED
@@ -0,0 +1,35 @@
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
1
+ framework:
2
+ name: QwenOFT
3
+ qwenvl:
4
+ base_vlm: Qwen/Qwen3-VL-4B-Instruct
5
+ attn_implementation: flash_attention_2
6
+ enable_gradient_checkpointing: false
7
+ action_model:
8
+ action_model_type: MLP
9
+ action_dim: 7
10
+ state_dim: 63
11
+ action_hidden_dim: 2560
12
+ future_action_window_size: 7
13
+ past_action_window_size: 0
14
+ loss_type: l1
15
+ state_encoding: continuous_projector
16
+ task_objective: null
17
+ action_env_dim: 7
18
+ action_horizon: 8
19
+ version_id: '0.21'
20
+ backbone:
21
+ repo_id: Qwen/Qwen3-VL-4B-Instruct
22
+ revision: ebb281ec70b05090aa6165b016eac8ec08e71b17
23
+ datasets:
24
+ vla_data:
25
+ include_state: true
26
+ obs_image_size:
27
+ - 224
28
+ - 224
29
+ image_mode: single
30
+ stitch_grid:
31
+ - 1
32
+ - 2
33
+ num_obs_frames: 1
34
+ trainer:
35
+ pretrained_checkpoint: null
latency-aware/mikasa-intercept-grab-fast/vla/starvla-qwenoft-h8/fixed3-prefix63-restart-20260925/training/bootstrap/step_05000/dataset_statistics.json ADDED
@@ -0,0 +1,463 @@
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
1
+ {
2
+ "new_embodiment": {
3
+ "action": {
4
+ "mean": [
5
+ -0.09156566858291626,
6
+ 0.06825543940067291,
7
+ -0.2338506430387497,
8
+ -0.23645973205566406,
9
+ -0.4093474745750427,
10
+ 0.16556566953659058,
11
+ 0.02442399226129055
12
+ ],
13
+ "std": [
14
+ 0.22998179495334625,
15
+ 0.5366711020469666,
16
+ 0.25270169973373413,
17
+ 0.27451473474502563,
18
+ 0.31424298882484436,
19
+ 0.2932277023792267,
20
+ 0.42333734035491943
21
+ ],
22
+ "max": [
23
+ 0.9532759785652161,
24
+ 0.9897072315216064,
25
+ 0.7722779512405396,
26
+ 1.0,
27
+ 0.7285586595535278,
28
+ 1.0,
29
+ 0.9742894172668457
30
+ ],
31
+ "min": [
32
+ -1.0,
33
+ -1.0,
34
+ -1.0,
35
+ -1.0,
36
+ -1.0,
37
+ -0.8733115196228027,
38
+ -1.0
39
+ ],
40
+ "q01": [
41
+ -0.8094067573547363,
42
+ -1.0,
43
+ -0.8675947189331055,
44
+ -0.6810638308525085,
45
+ -0.9625000953674316,
46
+ -0.4024769365787506,
47
+ -0.8370487689971924
48
+ ],
49
+ "q99": [
50
+ 0.27119386196136475,
51
+ 0.8228588700294495,
52
+ 0.19267156720161438,
53
+ 0.5329436659812927,
54
+ 0.2626880705356598,
55
+ 0.7799819707870483,
56
+ 0.6529542803764343
57
+ ],
58
+ "mask": [
59
+ true,
60
+ true,
61
+ true,
62
+ true,
63
+ true,
64
+ true,
65
+ true
66
+ ]
67
+ },
68
+ "state": {
69
+ "mean": [
70
+ -0.16800929605960846,
71
+ -0.0783684253692627,
72
+ 0.12454501539468765,
73
+ -2.1669600009918213,
74
+ 0.27709731459617615,
75
+ -0.13695164024829865,
76
+ 0.04954284057021141,
77
+ -0.11882534623146057,
78
+ -0.0005465356516651809,
79
+ -0.2718977928161621,
80
+ -0.20903266966342926,
81
+ -0.43656283617019653,
82
+ 0.20606711506843567,
83
+ 0.08333394676446915,
84
+ -0.10127021372318268,
85
+ 0.031661562621593475,
86
+ -0.24624598026275635,
87
+ -0.21333561837673187,
88
+ -0.41504159569740295,
89
+ 0.1752912700176239,
90
+ 0.05674679949879646,
91
+ -0.08229604363441467,
92
+ 0.06599719822406769,
93
+ -0.2199336588382721,
94
+ -0.22095930576324463,
95
+ -0.3870457708835602,
96
+ 0.15723580121994019,
97
+ 0.03842059150338173,
98
+ 0.0,
99
+ 0.0,
100
+ 0.0,
101
+ 0.0,
102
+ 0.0,
103
+ 0.0,
104
+ 0.0,
105
+ 0.0,
106
+ 0.0,
107
+ 0.0,
108
+ 0.0,
109
+ 0.0,
110
+ 0.0,
111
+ 0.0,
112
+ 0.0,
113
+ 0.0,
114
+ 0.0,
115
+ 0.0,
116
+ 0.0,
117
+ 0.0,
118
+ 0.0,
119
+ 0.0,
120
+ 0.0,
121
+ 0.0,
122
+ 0.0,
123
+ 0.0,
124
+ 0.0,
125
+ 0.0,
126
+ 0.0,
127
+ 0.0,
128
+ 0.0,
129
+ 0.0,
130
+ 0.0,
131
+ 0.0,
132
+ 0.0
133
+ ],
134
+ "std": [
135
+ 0.08844474703073502,
136
+ 0.11787261813879013,
137
+ 0.11225748807191849,
138
+ 2.1127517223358154,
139
+ 0.1971157342195511,
140
+ 0.10493948310613632,
141
+ 0.015816964209079742,
142
+ 0.2609225809574127,
143
+ 0.5754884481430054,
144
+ 0.2747531831264496,
145
+ 0.2786228656768799,
146
+ 0.3093158006668091,
147
+ 0.3050784170627594,
148
+ 0.3753158450126648,
149
+ 0.24173393845558167,
150
+ 0.5492150783538818,
151
+ 0.2606605589389801,
152
+ 0.2764761447906494,
153
+ 0.3152492046356201,
154
+ 0.2834121584892273,
155
+ 0.38152414560317993,
156
+ 0.21935689449310303,
157
+ 0.5191959142684937,
158
+ 0.24507014453411102,
159
+ 0.27280646562576294,
160
+ 0.3164590299129486,
161
+ 0.2817789912223816,
162
+ 0.3958720564842224,
163
+ 0.0,
164
+ 0.0,
165
+ 0.0,
166
+ 0.0,
167
+ 0.0,
168
+ 0.0,
169
+ 0.0,
170
+ 0.0,
171
+ 0.0,
172
+ 0.0,
173
+ 0.0,
174
+ 0.0,
175
+ 0.0,
176
+ 0.0,
177
+ 0.0,
178
+ 0.0,
179
+ 0.0,
180
+ 0.0,
181
+ 0.0,
182
+ 0.0,
183
+ 0.0,
184
+ 0.0,
185
+ 0.0,
186
+ 0.0,
187
+ 0.0,
188
+ 0.0,
189
+ 0.0,
190
+ 0.0,
191
+ 0.0,
192
+ 0.0,
193
+ 0.0,
194
+ 0.0,
195
+ 0.0,
196
+ 0.0,
197
+ 0.0
198
+ ],
199
+ "max": [
200
+ 0.0659027099609375,
201
+ 0.2413959503173828,
202
+ 0.3793128728866577,
203
+ 3.141590118408203,
204
+ 1.2818690538406372,
205
+ 0.09846330434083939,
206
+ 0.07999999821186066,
207
+ 1.0,
208
+ 1.0,
209
+ 1.0,
210
+ 1.0,
211
+ 1.0,
212
+ 1.0,
213
+ 1.0,
214
+ 1.0,
215
+ 1.0,
216
+ 1.0,
217
+ 1.0,
218
+ 1.0,
219
+ 1.0,
220
+ 1.0,
221
+ 1.0,
222
+ 1.0,
223
+ 1.0,
224
+ 1.0,
225
+ 1.0,
226
+ 1.0,
227
+ 1.0,
228
+ 1.0,
229
+ 1.0,
230
+ 1.0,
231
+ 1.0,
232
+ 1.0,
233
+ 1.0,
234
+ 1.0,
235
+ 1.0,
236
+ 1.0,
237
+ 1.0,
238
+ 1.0,
239
+ 1.0,
240
+ 1.0,
241
+ 1.0,
242
+ 1.0,
243
+ 1.0,
244
+ 1.0,
245
+ 1.0,
246
+ 1.0,
247
+ 1.0,
248
+ 1.0,
249
+ 1.0,
250
+ 1.0,
251
+ 1.0,
252
+ 1.0,
253
+ 1.0,
254
+ 1.0,
255
+ 1.0,
256
+ 1.0,
257
+ 1.0,
258
+ 1.0,
259
+ 1.0,
260
+ 1.0,
261
+ 1.0,
262
+ 1.0
263
+ ],
264
+ "min": [
265
+ -0.6102104187011719,
266
+ -0.34939002990722656,
267
+ 0.010278970003128052,
268
+ -3.141592025756836,
269
+ -0.11077408492565155,
270
+ -0.6710227131843567,
271
+ 0.0007261869614012539,
272
+ -1.0,
273
+ -1.0,
274
+ -1.0,
275
+ -1.0,
276
+ -1.0,
277
+ -1.0,
278
+ -1.0,
279
+ -1.0,
280
+ -1.0,
281
+ -1.0,
282
+ -1.0,
283
+ -1.0,
284
+ -1.0,
285
+ -1.0,
286
+ -1.0,
287
+ -1.0,
288
+ -1.0,
289
+ -1.0,
290
+ -1.0,
291
+ -1.0,
292
+ -1.0,
293
+ -1.0,
294
+ -1.0,
295
+ -1.0,
296
+ -1.0,
297
+ -1.0,
298
+ -1.0,
299
+ -1.0,
300
+ -1.0,
301
+ -1.0,
302
+ -1.0,
303
+ -1.0,
304
+ -1.0,
305
+ -1.0,
306
+ -1.0,
307
+ -1.0,
308
+ -1.0,
309
+ -1.0,
310
+ -1.0,
311
+ -1.0,
312
+ -1.0,
313
+ -1.0,
314
+ -1.0,
315
+ -1.0,
316
+ -1.0,
317
+ -1.0,
318
+ -1.0,
319
+ -1.0,
320
+ -1.0,
321
+ -1.0,
322
+ -1.0,
323
+ -1.0,
324
+ -1.0,
325
+ -1.0,
326
+ -1.0,
327
+ -1.0
328
+ ],
329
+ "q01": [
330
+ -0.3593454360961914,
331
+ -0.30287304520606995,
332
+ 0.01798463985323906,
333
+ -3.139918088912964,
334
+ -0.054751649498939514,
335
+ -0.3311103582382202,
336
+ 0.028472520411014557,
337
+ -0.9264813661575317,
338
+ -1.0,
339
+ -0.9855209589004517,
340
+ -0.6804830431938171,
341
+ -0.9615814685821533,
342
+ -0.4036506712436676,
343
+ -0.8259176015853882,
344
+ -0.8743070363998413,
345
+ -1.0,
346
+ -0.8862442970275879,
347
+ -0.6730726361274719,
348
+ -0.9939756393432617,
349
+ -0.3903995752334595,
350
+ -0.821707546710968,
351
+ -0.773688018321991,
352
+ -1.0,
353
+ -0.7957248091697693,
354
+ -0.6865230202674866,
355
+ -0.9611991047859192,
356
+ -0.39955219626426697,
357
+ -0.8029178380966187,
358
+ 0.0,
359
+ 0.0,
360
+ 0.0,
361
+ 0.0,
362
+ 0.0,
363
+ 0.0,
364
+ 0.0,
365
+ 0.0,
366
+ 0.0,
367
+ 0.0,
368
+ 0.0,
369
+ 0.0,
370
+ 0.0,
371
+ 0.0,
372
+ 0.0,
373
+ 0.0,
374
+ 0.0,
375
+ 0.0,
376
+ 0.0,
377
+ 0.0,
378
+ 0.0,
379
+ 0.0,
380
+ 0.0,
381
+ 0.0,
382
+ 0.0,
383
+ 0.0,
384
+ 0.0,
385
+ 0.0,
386
+ 0.0,
387
+ 0.0,
388
+ 0.0,
389
+ 0.0,
390
+ 0.0,
391
+ 0.0,
392
+ 0.0
393
+ ],
394
+ "q99": [
395
+ -0.034003712236881256,
396
+ 0.1623462587594986,
397
+ 0.34088584780693054,
398
+ 3.140087604522705,
399
+ 0.7054323554039001,
400
+ 0.06150749325752258,
401
+ 0.07999999821186066,
402
+ 0.2647519111633301,
403
+ 0.8145509958267212,
404
+ 0.17960961163043976,
405
+ 0.5346103310585022,
406
+ 0.24825401604175568,
407
+ 0.88252192735672,
408
+ 0.6508035063743591,
409
+ 0.2725047171115875,
410
+ 0.8214802145957947,
411
+ 0.1841362565755844,
412
+ 0.5200607180595398,
413
+ 0.24127230048179626,
414
+ 0.7586654424667358,
415
+ 0.6513977646827698,
416
+ 0.2772558033466339,
417
+ 0.8248680233955383,
418
+ 0.18817591667175293,
419
+ 0.5099866390228271,
420
+ 0.25153353810310364,
421
+ 0.7538114190101624,
422
+ 0.6500475406646729,
423
+ 0.0,
424
+ 0.0,
425
+ 0.0,
426
+ 0.0,
427
+ 0.0,
428
+ 0.0,
429
+ 0.0,
430
+ 0.0,
431
+ 0.0,
432
+ 0.0,
433
+ 0.0,
434
+ 0.0,
435
+ 0.0,
436
+ 0.0,
437
+ 0.0,
438
+ 0.0,
439
+ 0.0,
440
+ 0.0,
441
+ 0.0,
442
+ 0.0,
443
+ 0.0,
444
+ 0.0,
445
+ 0.0,
446
+ 0.0,
447
+ 0.0,
448
+ 0.0,
449
+ 0.0,
450
+ 0.0,
451
+ 0.0,
452
+ 0.0,
453
+ 0.0,
454
+ 0.0,
455
+ 0.0,
456
+ 0.0,
457
+ 0.0
458
+ ]
459
+ },
460
+ "num_transitions": 13661,
461
+ "num_trajectories": 1211
462
+ }
463
+ }
latency-aware/mikasa-intercept-grab-fast/vla/starvla-qwenoft-h8/fixed3-prefix63-restart-20260925/training/bootstrap/step_05000/provenance.json ADDED
@@ -0,0 +1,6 @@
 
 
 
 
 
 
 
1
+ {
2
+ "step": 5000,
3
+ "phase": "bootstrap",
4
+ "condition": "fixed-3",
5
+ "status": "training phase complete"
6
+ }
latency-aware/mikasa-intercept-grab-fast/vla/starvla-qwenoft-h8/fixed3-prefix63-restart-20260925/training/bootstrap/step_05000/task_contract.json ADDED
@@ -0,0 +1,504 @@
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
1
+ {
2
+ "format": "latency_bench_starvla_h8_v3",
3
+ "task": "mikasa_intercept_grab_fast",
4
+ "robot_type": "latency_mikasa_conditioned_h8",
5
+ "state_dim": 63,
6
+ "action_dim": 7,
7
+ "action_horizon": 8,
8
+ "fps": 20.0,
9
+ "state_key": "observation.state",
10
+ "action_key": "issued_command_chunk",
11
+ "video_keys": [
12
+ "video.top",
13
+ "video.wrist"
14
+ ],
15
+ "auxiliary": {
16
+ "action_prefix_mask": {
17
+ "shape": [
18
+ 8
19
+ ],
20
+ "column": "action_prefix_mask"
21
+ },
22
+ "action_loss_mask": {
23
+ "shape": [
24
+ 8
25
+ ],
26
+ "column": "action_loss_mask"
27
+ }
28
+ },
29
+ "normalization": {
30
+ "state": {
31
+ "mean": [
32
+ -0.16800929605960846,
33
+ -0.0783684253692627,
34
+ 0.12454501539468765,
35
+ -2.1669600009918213,
36
+ 0.27709731459617615,
37
+ -0.13695164024829865,
38
+ 0.04954284057021141,
39
+ -0.11882534623146057,
40
+ -0.0005465356516651809,
41
+ -0.2718977928161621,
42
+ -0.20903266966342926,
43
+ -0.43656283617019653,
44
+ 0.20606711506843567,
45
+ 0.08333394676446915,
46
+ -0.10127021372318268,
47
+ 0.031661562621593475,
48
+ -0.24624598026275635,
49
+ -0.21333561837673187,
50
+ -0.41504159569740295,
51
+ 0.1752912700176239,
52
+ 0.05674679949879646,
53
+ -0.08229604363441467,
54
+ 0.06599719822406769,
55
+ -0.2199336588382721,
56
+ -0.22095930576324463,
57
+ -0.3870457708835602,
58
+ 0.15723580121994019,
59
+ 0.03842059150338173,
60
+ 0.0,
61
+ 0.0,
62
+ 0.0,
63
+ 0.0,
64
+ 0.0,
65
+ 0.0,
66
+ 0.0,
67
+ 0.0,
68
+ 0.0,
69
+ 0.0,
70
+ 0.0,
71
+ 0.0,
72
+ 0.0,
73
+ 0.0,
74
+ 0.0,
75
+ 0.0,
76
+ 0.0,
77
+ 0.0,
78
+ 0.0,
79
+ 0.0,
80
+ 0.0,
81
+ 0.0,
82
+ 0.0,
83
+ 0.0,
84
+ 0.0,
85
+ 0.0,
86
+ 0.0,
87
+ 0.0,
88
+ 0.0,
89
+ 0.0,
90
+ 0.0,
91
+ 0.0,
92
+ 0.0,
93
+ 0.0,
94
+ 0.0
95
+ ],
96
+ "std": [
97
+ 0.08844474703073502,
98
+ 0.11787261813879013,
99
+ 0.11225748807191849,
100
+ 2.1127517223358154,
101
+ 0.1971157342195511,
102
+ 0.10493948310613632,
103
+ 0.015816964209079742,
104
+ 0.2609225809574127,
105
+ 0.5754884481430054,
106
+ 0.2747531831264496,
107
+ 0.2786228656768799,
108
+ 0.3093158006668091,
109
+ 0.3050784170627594,
110
+ 0.3753158450126648,
111
+ 0.24173393845558167,
112
+ 0.5492150783538818,
113
+ 0.2606605589389801,
114
+ 0.2764761447906494,
115
+ 0.3152492046356201,
116
+ 0.2834121584892273,
117
+ 0.38152414560317993,
118
+ 0.21935689449310303,
119
+ 0.5191959142684937,
120
+ 0.24507014453411102,
121
+ 0.27280646562576294,
122
+ 0.3164590299129486,
123
+ 0.2817789912223816,
124
+ 0.3958720564842224,
125
+ 0.0,
126
+ 0.0,
127
+ 0.0,
128
+ 0.0,
129
+ 0.0,
130
+ 0.0,
131
+ 0.0,
132
+ 0.0,
133
+ 0.0,
134
+ 0.0,
135
+ 0.0,
136
+ 0.0,
137
+ 0.0,
138
+ 0.0,
139
+ 0.0,
140
+ 0.0,
141
+ 0.0,
142
+ 0.0,
143
+ 0.0,
144
+ 0.0,
145
+ 0.0,
146
+ 0.0,
147
+ 0.0,
148
+ 0.0,
149
+ 0.0,
150
+ 0.0,
151
+ 0.0,
152
+ 0.0,
153
+ 0.0,
154
+ 0.0,
155
+ 0.0,
156
+ 0.0,
157
+ 0.0,
158
+ 0.0,
159
+ 0.0
160
+ ],
161
+ "min": [
162
+ -0.6102104187011719,
163
+ -0.34939002990722656,
164
+ 0.010278970003128052,
165
+ -3.141592025756836,
166
+ -0.11077408492565155,
167
+ -0.6710227131843567,
168
+ 0.0007261869614012539,
169
+ -1.0,
170
+ -1.0,
171
+ -1.0,
172
+ -1.0,
173
+ -1.0,
174
+ -1.0,
175
+ -1.0,
176
+ -1.0,
177
+ -1.0,
178
+ -1.0,
179
+ -1.0,
180
+ -1.0,
181
+ -1.0,
182
+ -1.0,
183
+ -1.0,
184
+ -1.0,
185
+ -1.0,
186
+ -1.0,
187
+ -1.0,
188
+ -1.0,
189
+ -1.0,
190
+ -1.0,
191
+ -1.0,
192
+ -1.0,
193
+ -1.0,
194
+ -1.0,
195
+ -1.0,
196
+ -1.0,
197
+ -1.0,
198
+ -1.0,
199
+ -1.0,
200
+ -1.0,
201
+ -1.0,
202
+ -1.0,
203
+ -1.0,
204
+ -1.0,
205
+ -1.0,
206
+ -1.0,
207
+ -1.0,
208
+ -1.0,
209
+ -1.0,
210
+ -1.0,
211
+ -1.0,
212
+ -1.0,
213
+ -1.0,
214
+ -1.0,
215
+ -1.0,
216
+ -1.0,
217
+ -1.0,
218
+ -1.0,
219
+ -1.0,
220
+ -1.0,
221
+ -1.0,
222
+ -1.0,
223
+ -1.0,
224
+ -1.0
225
+ ],
226
+ "max": [
227
+ 0.0659027099609375,
228
+ 0.2413959503173828,
229
+ 0.3793128728866577,
230
+ 3.141590118408203,
231
+ 1.2818690538406372,
232
+ 0.09846330434083939,
233
+ 0.07999999821186066,
234
+ 1.0,
235
+ 1.0,
236
+ 1.0,
237
+ 1.0,
238
+ 1.0,
239
+ 1.0,
240
+ 1.0,
241
+ 1.0,
242
+ 1.0,
243
+ 1.0,
244
+ 1.0,
245
+ 1.0,
246
+ 1.0,
247
+ 1.0,
248
+ 1.0,
249
+ 1.0,
250
+ 1.0,
251
+ 1.0,
252
+ 1.0,
253
+ 1.0,
254
+ 1.0,
255
+ 1.0,
256
+ 1.0,
257
+ 1.0,
258
+ 1.0,
259
+ 1.0,
260
+ 1.0,
261
+ 1.0,
262
+ 1.0,
263
+ 1.0,
264
+ 1.0,
265
+ 1.0,
266
+ 1.0,
267
+ 1.0,
268
+ 1.0,
269
+ 1.0,
270
+ 1.0,
271
+ 1.0,
272
+ 1.0,
273
+ 1.0,
274
+ 1.0,
275
+ 1.0,
276
+ 1.0,
277
+ 1.0,
278
+ 1.0,
279
+ 1.0,
280
+ 1.0,
281
+ 1.0,
282
+ 1.0,
283
+ 1.0,
284
+ 1.0,
285
+ 1.0,
286
+ 1.0,
287
+ 1.0,
288
+ 1.0,
289
+ 1.0
290
+ ],
291
+ "q01": [
292
+ -0.3593454360961914,
293
+ -0.30287304520606995,
294
+ 0.01798463985323906,
295
+ -3.139918088912964,
296
+ -0.054751649498939514,
297
+ -0.3311103582382202,
298
+ 0.028472520411014557,
299
+ -0.9264813661575317,
300
+ -1.0,
301
+ -0.9855209589004517,
302
+ -0.6804830431938171,
303
+ -0.9615814685821533,
304
+ -0.4036506712436676,
305
+ -0.8259176015853882,
306
+ -0.8743070363998413,
307
+ -1.0,
308
+ -0.8862442970275879,
309
+ -0.6730726361274719,
310
+ -0.9939756393432617,
311
+ -0.3903995752334595,
312
+ -0.821707546710968,
313
+ -0.773688018321991,
314
+ -1.0,
315
+ -0.7957248091697693,
316
+ -0.6865230202674866,
317
+ -0.9611991047859192,
318
+ -0.39955219626426697,
319
+ -0.8029178380966187,
320
+ 0.0,
321
+ 0.0,
322
+ 0.0,
323
+ 0.0,
324
+ 0.0,
325
+ 0.0,
326
+ 0.0,
327
+ 0.0,
328
+ 0.0,
329
+ 0.0,
330
+ 0.0,
331
+ 0.0,
332
+ 0.0,
333
+ 0.0,
334
+ 0.0,
335
+ 0.0,
336
+ 0.0,
337
+ 0.0,
338
+ 0.0,
339
+ 0.0,
340
+ 0.0,
341
+ 0.0,
342
+ 0.0,
343
+ 0.0,
344
+ 0.0,
345
+ 0.0,
346
+ 0.0,
347
+ 0.0,
348
+ 0.0,
349
+ 0.0,
350
+ 0.0,
351
+ 0.0,
352
+ 0.0,
353
+ 0.0,
354
+ 0.0
355
+ ],
356
+ "q99": [
357
+ -0.034003712236881256,
358
+ 0.1623462587594986,
359
+ 0.34088584780693054,
360
+ 3.140087604522705,
361
+ 0.7054323554039001,
362
+ 0.06150749325752258,
363
+ 0.07999999821186066,
364
+ 0.2647519111633301,
365
+ 0.8145509958267212,
366
+ 0.17960961163043976,
367
+ 0.5346103310585022,
368
+ 0.24825401604175568,
369
+ 0.88252192735672,
370
+ 0.6508035063743591,
371
+ 0.2725047171115875,
372
+ 0.8214802145957947,
373
+ 0.1841362565755844,
374
+ 0.5200607180595398,
375
+ 0.24127230048179626,
376
+ 0.7586654424667358,
377
+ 0.6513977646827698,
378
+ 0.2772558033466339,
379
+ 0.8248680233955383,
380
+ 0.18817591667175293,
381
+ 0.5099866390228271,
382
+ 0.25153353810310364,
383
+ 0.7538114190101624,
384
+ 0.6500475406646729,
385
+ 0.0,
386
+ 0.0,
387
+ 0.0,
388
+ 0.0,
389
+ 0.0,
390
+ 0.0,
391
+ 0.0,
392
+ 0.0,
393
+ 0.0,
394
+ 0.0,
395
+ 0.0,
396
+ 0.0,
397
+ 0.0,
398
+ 0.0,
399
+ 0.0,
400
+ 0.0,
401
+ 0.0,
402
+ 0.0,
403
+ 0.0,
404
+ 0.0,
405
+ 0.0,
406
+ 0.0,
407
+ 0.0,
408
+ 0.0,
409
+ 0.0,
410
+ 0.0,
411
+ 0.0,
412
+ 0.0,
413
+ 0.0,
414
+ 0.0,
415
+ 0.0,
416
+ 0.0,
417
+ 0.0,
418
+ 0.0,
419
+ 0.0
420
+ ]
421
+ },
422
+ "action": {
423
+ "mean": [
424
+ -0.09156566858291626,
425
+ 0.06825543940067291,
426
+ -0.2338506430387497,
427
+ -0.23645973205566406,
428
+ -0.4093474745750427,
429
+ 0.16556566953659058,
430
+ 0.02442399226129055
431
+ ],
432
+ "std": [
433
+ 0.22998179495334625,
434
+ 0.5366711020469666,
435
+ 0.25270169973373413,
436
+ 0.27451473474502563,
437
+ 0.31424298882484436,
438
+ 0.2932277023792267,
439
+ 0.42333734035491943
440
+ ],
441
+ "min": [
442
+ -1.0,
443
+ -1.0,
444
+ -1.0,
445
+ -1.0,
446
+ -1.0,
447
+ -0.8733115196228027,
448
+ -1.0
449
+ ],
450
+ "max": [
451
+ 0.9532759785652161,
452
+ 0.9897072315216064,
453
+ 0.7722779512405396,
454
+ 1.0,
455
+ 0.7285586595535278,
456
+ 1.0,
457
+ 0.9742894172668457
458
+ ],
459
+ "q01": [
460
+ -0.8094067573547363,
461
+ -1.0,
462
+ -0.8675947189331055,
463
+ -0.6810638308525085,
464
+ -0.9625000953674316,
465
+ -0.4024769365787506,
466
+ -0.8370487689971924
467
+ ],
468
+ "q99": [
469
+ 0.27119386196136475,
470
+ 0.8228588700294495,
471
+ 0.19267156720161438,
472
+ 0.5329436659812927,
473
+ 0.2626880705356598,
474
+ 0.7799819707870483,
475
+ 0.6529542803764343
476
+ ]
477
+ }
478
+ },
479
+ "prompt": "Intercept the rolling ball and grasp it to stop it.",
480
+ "action_prefix": {
481
+ "mode": "fixed_frames",
482
+ "frames": 3,
483
+ "env_fps": 20,
484
+ "action_horizon": 8,
485
+ "action_dim": 7
486
+ },
487
+ "label_provenance": {
488
+ "semantics": "zero_h1_teacher_after_causal_prefix",
489
+ "teacher_checkpoint": "/home/ubuntu/codex/mikasa-prefix63-restart-20260925/outputs/starvla/artifacts/models/zero-latency/mikasa-intercept-grab-fast/small-policy/ppo-v1/checkpoint.pt",
490
+ "condition": "fixed-3",
491
+ "model": "shared",
492
+ "latency": {
493
+ "method": "fixed",
494
+ "fixed_latency_ms": 150.0
495
+ },
496
+ "action_prefix": {
497
+ "mode": "fixed_frames",
498
+ "frames": 3,
499
+ "env_fps": 20,
500
+ "action_horizon": 8,
501
+ "action_dim": 7
502
+ }
503
+ }
504
+ }
latency-aware/mikasa-intercept-grab-fast/vla/starvla-qwenoft-h8/fixed3-prefix63-restart-20260925/training/bootstrap/step_05000/trainer_config.yaml ADDED
@@ -0,0 +1,103 @@
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
1
+ run_id: bootstrap
2
+ wandb_name: mikasa_conditioned_h8-fixed-3-qwenoft
3
+ run_root_dir: /home/ubuntu/codex/mikasa-prefix63-restart-20260925/outputs/starvla/runs/mikasa_intercept_grab_fast/fixed3-prefix63-restart-20260925/sft/training
4
+ seed: 0
5
+ wandb_project: starvla_tasks
6
+ wandb_entity: zihanwang-ai-northwestern-university
7
+ wandb_group: vla-train
8
+ wandb_tags:
9
+ - mikasa_conditioned_h8
10
+ - h8
11
+ - formal
12
+ - fixed-3
13
+ training_latency_condition: fixed-3
14
+ is_debug: false
15
+ version_id: '0.21'
16
+ framework:
17
+ name: QwenOFT
18
+ qwenvl:
19
+ base_vlm: /home/ubuntu/.cache/huggingface/hub/models--Qwen--Qwen3-VL-4B-Instruct/snapshots/ebb281ec70b05090aa6165b016eac8ec08e71b17
20
+ attn_implementation: flash_attention_2
21
+ enable_gradient_checkpointing: false
22
+ action_model:
23
+ action_model_type: MLP
24
+ action_dim: 7
25
+ state_dim: 63
26
+ action_hidden_dim: 2560
27
+ future_action_window_size: 7
28
+ past_action_window_size: 0
29
+ loss_type: l1
30
+ state_encoding: continuous_projector
31
+ task_objective: null
32
+ action_env_dim: 7
33
+ action_horizon: 8
34
+ datasets:
35
+ vla_data:
36
+ dataset_py: latency_bench_tasks
37
+ lerobot_version: v3.0
38
+ include_state: true
39
+ task_contract_path: /home/ubuntu/codex/mikasa-prefix63-restart-20260925/outputs/starvla/datasets/mikasa_intercept_grab_fast/fixed3-prefix63-restart-20260925/fixed-3/lerobot/task_contract.json
40
+ data_root_dir: /
41
+ data_mix: train
42
+ eval_data_mix: validation
43
+ custom_mixtures_path: /home/ubuntu/codex/mikasa-prefix63-restart-20260925/outputs/starvla/runs/mikasa_intercept_grab_fast/fixed3-prefix63-restart-20260925/sft/bootstrap_mixture.json
44
+ sequential_step_sampling: true
45
+ per_device_batch_size: 64
46
+ pin_memory: true
47
+ persistent_workers: true
48
+ num_workers: 8
49
+ prefetch_factor: 3
50
+ obs_image_size:
51
+ - 224
52
+ - 224
53
+ video_backend: pyav
54
+ image_mode: single
55
+ stitch_grid:
56
+ - 1
57
+ - 2
58
+ num_obs_frames: 1
59
+ trainer:
60
+ max_train_steps: 5000
61
+ num_warmup_steps: 100
62
+ save_interval: 500
63
+ eval_interval: 5000
64
+ eval_num_batches: 1
65
+ logging_frequency: 5
66
+ learning_rate:
67
+ base: 3.0e-05
68
+ action_model: 0.0001
69
+ lr_scheduler_type: cosine_with_min_lr
70
+ scheduler_specific_kwargs:
71
+ min_lr: 1.0e-06
72
+ freeze_modules: ''
73
+ freeze_vit: false
74
+ freeze_tied_embedding: false
75
+ freeze_llm_layers: []
76
+ loss_scale:
77
+ vla: 1.0
78
+ gradient_clipping: 1.0
79
+ gradient_accumulation_steps: 1
80
+ pretrained_checkpoint: null
81
+ is_resume: false
82
+ distributed_backend: deepspeed
83
+ optimizer:
84
+ name: AdamW
85
+ betas:
86
+ - 0.9
87
+ - 0.95
88
+ eps: 1.0e-08
89
+ weight_decay: 1.0e-08
90
+ fused: true
91
+ stop_after_steps: 5000
92
+ profile_timing:
93
+ enabled: false
94
+ log_interval: 10
95
+ checkpoint:
96
+ save_best_model: false
97
+ save_final_model: true
98
+ save_pt_file: true
99
+ save_training_state: true
100
+ local:
101
+ keep_last_n: 2
102
+ config_yaml: /home/ubuntu/codex/mikasa-prefix63-restart-20260925/outputs/starvla/runs/mikasa_intercept_grab_fast/fixed3-prefix63-restart-20260925/sft/bootstrap.yaml
103
+ output_dir: /home/ubuntu/codex/mikasa-prefix63-restart-20260925/outputs/starvla/runs/mikasa_intercept_grab_fast/fixed3-prefix63-restart-20260925/sft/training/bootstrap
latency-aware/mikasa-intercept-grab-fast/vla/starvla-qwenoft-h8/fixed3-prefix63-restart-20260925/training/bootstrap/step_05000/trainer_state/custom_checkpoint_0.pkl ADDED
@@ -0,0 +1,3 @@
 
 
 
 
1
+ version https://git-lfs.github.com/spec/v1
2
+ oid sha256:4f2f99b7145922f6a1aa58ef156069bdb6ea34e0b3d24750bc0752f5b38c7fd1
3
+ size 1525
latency-aware/mikasa-intercept-grab-fast/vla/starvla-qwenoft-h8/fixed3-prefix63-restart-20260925/training/bootstrap/step_05000/trainer_state/latest ADDED
@@ -0,0 +1 @@
 
 
1
+ pytorch_model
latency-aware/mikasa-intercept-grab-fast/vla/starvla-qwenoft-h8/fixed3-prefix63-restart-20260925/training/bootstrap/step_05000/trainer_state/pytorch_model/bf16_zero_pp_rank_0_mp_rank_00_optim_states.pt ADDED
@@ -0,0 +1,3 @@
 
 
 
 
1
+ version https://git-lfs.github.com/spec/v1
2
+ oid sha256:ce138a9e8568d1eedefe7474db17d4be74a46775aa2fb97235ddefd635d761d6
3
+ size 27021673085
latency-aware/mikasa-intercept-grab-fast/vla/starvla-qwenoft-h8/fixed3-prefix63-restart-20260925/training/bootstrap/step_05000/trainer_state/pytorch_model/bf16_zero_pp_rank_1_mp_rank_00_optim_states.pt ADDED
@@ -0,0 +1,3 @@
 
 
 
 
1
+ version https://git-lfs.github.com/spec/v1
2
+ oid sha256:0e631dd5398bbd06b45f94793c17740faa5d0e29146857dc9a10d8b40ad41be9
3
+ size 27021651453
latency-aware/mikasa-intercept-grab-fast/vla/starvla-qwenoft-h8/fixed3-prefix63-restart-20260925/training/bootstrap/step_05000/trainer_state/pytorch_model/mp_rank_00_model_states.pt ADDED
@@ -0,0 +1,3 @@
 
 
 
 
1
+ version https://git-lfs.github.com/spec/v1
2
+ oid sha256:2a68cccdd401db583ae4f89b081b2e1990c975d94d75b7fae3736ffb08d3e508
3
+ size 9007481061
latency-aware/mikasa-intercept-grab-fast/vla/starvla-qwenoft-h8/fixed3-prefix63-restart-20260925/training/bootstrap/step_05000/trainer_state/random_states_0.pkl ADDED
@@ -0,0 +1,3 @@
 
 
 
 
1
+ version https://git-lfs.github.com/spec/v1
2
+ oid sha256:d941a9657caba00045418ce4bd1c0a25f918c543af57e5825de2b1178cf047e4
3
+ size 14953
latency-aware/mikasa-intercept-grab-fast/vla/starvla-qwenoft-h8/fixed3-prefix63-restart-20260925/training/bootstrap/step_05000/trainer_state/random_states_1.pkl ADDED
@@ -0,0 +1,3 @@
 
 
 
 
1
+ version https://git-lfs.github.com/spec/v1
2
+ oid sha256:e381c3041ee50113fb4c9114764f363c4699b73e6177124121e43238fec57bb7
3
+ size 15017
latency-aware/mikasa-intercept-grab-fast/vla/starvla-qwenoft-h8/fixed3-prefix63-restart-20260925/training/bootstrap/step_05000/trainer_state/zero_to_fp32.py ADDED
@@ -0,0 +1,760 @@
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
1
+ #!/usr/bin/env python
2
+
3
+ # Copyright (c) Microsoft Corporation.
4
+ # SPDX-License-Identifier: Apache-2.0
5
+
6
+ # DeepSpeed Team
7
+
8
+ # This script extracts fp32 consolidated weights from a zero 1, 2 and 3 DeepSpeed checkpoints. It gets
9
+ # copied into the top level checkpoint dir, so the user can easily do the conversion at any point in
10
+ # the future. Once extracted, the weights don't require DeepSpeed and can be used in any
11
+ # application.
12
+ #
13
+ # example:
14
+ # python zero_to_fp32.py . output_dir/
15
+ # or
16
+ # python zero_to_fp32.py . output_dir/ --safe_serialization
17
+
18
+ import argparse
19
+ import torch
20
+ import glob
21
+ import math
22
+ import os
23
+ import re
24
+ import gc
25
+ import json
26
+ import numpy as np
27
+ from tqdm import tqdm
28
+ from collections import OrderedDict
29
+ from dataclasses import dataclass
30
+
31
+ # while this script doesn't use deepspeed to recover data, since the checkpoints are pickled with
32
+ # DeepSpeed data structures it has to be available in the current python environment.
33
+ from deepspeed.utils import logger
34
+ from deepspeed.checkpoint.constants import (DS_VERSION, OPTIMIZER_STATE_DICT, SINGLE_PARTITION_OF_FP32_GROUPS,
35
+ FP32_FLAT_GROUPS, ZERO_STAGE, PARTITION_COUNT, PARAM_SHAPES, BUFFER_NAMES,
36
+ FROZEN_PARAM_SHAPES, FROZEN_PARAM_FRAGMENTS)
37
+
38
+
39
+ @dataclass
40
+ class zero_model_state:
41
+ buffers: dict()
42
+ param_shapes: dict()
43
+ shared_params: list
44
+ ds_version: int
45
+ frozen_param_shapes: dict()
46
+ frozen_param_fragments: dict()
47
+
48
+
49
+ debug = 0
50
+
51
+ # load to cpu
52
+ device = torch.device('cpu')
53
+
54
+
55
+ def atoi(text):
56
+ return int(text) if text.isdigit() else text
57
+
58
+
59
+ def natural_keys(text):
60
+ '''
61
+ alist.sort(key=natural_keys) sorts in human order
62
+ http://nedbatchelder.com/blog/200712/human_sorting.html
63
+ (See Toothy's implementation in the comments)
64
+ '''
65
+ return [atoi(c) for c in re.split(r'(\d+)', text)]
66
+
67
+
68
+ def get_model_state_file(checkpoint_dir, zero_stage):
69
+ if not os.path.isdir(checkpoint_dir):
70
+ raise FileNotFoundError(f"Directory '{checkpoint_dir}' doesn't exist")
71
+
72
+ # there should be only one file
73
+ if zero_stage <= 2:
74
+ file = os.path.join(checkpoint_dir, "mp_rank_00_model_states.pt")
75
+ elif zero_stage == 3:
76
+ file = os.path.join(checkpoint_dir, "zero_pp_rank_0_mp_rank_00_model_states.pt")
77
+
78
+ if not os.path.exists(file):
79
+ raise FileNotFoundError(f"can't find model states file at '{file}'")
80
+
81
+ return file
82
+
83
+
84
+ def get_checkpoint_files(checkpoint_dir, glob_pattern):
85
+ # XXX: need to test that this simple glob rule works for multi-node setup too
86
+ ckpt_files = sorted(glob.glob(os.path.join(checkpoint_dir, glob_pattern)), key=natural_keys)
87
+
88
+ if len(ckpt_files) == 0:
89
+ raise FileNotFoundError(f"can't find {glob_pattern} files in directory '{checkpoint_dir}'")
90
+
91
+ return ckpt_files
92
+
93
+
94
+ def get_optim_files(checkpoint_dir):
95
+ return get_checkpoint_files(checkpoint_dir, "*_optim_states.pt")
96
+
97
+
98
+ def get_model_state_files(checkpoint_dir):
99
+ return get_checkpoint_files(checkpoint_dir, "*_model_states.pt")
100
+
101
+
102
+ def parse_model_states(files):
103
+ zero_model_states = []
104
+ for file in files:
105
+ state_dict = torch.load(file, map_location=device, weights_only=False)
106
+
107
+ if BUFFER_NAMES not in state_dict:
108
+ raise ValueError(f"{file} is not a model state checkpoint")
109
+ buffer_names = state_dict[BUFFER_NAMES]
110
+ if debug:
111
+ print("Found buffers:", buffer_names)
112
+
113
+ # recover just the buffers while restoring them to fp32 if they were saved in fp16
114
+ buffers = {k: v.float() for k, v in state_dict["module"].items() if k in buffer_names}
115
+ param_shapes = state_dict[PARAM_SHAPES]
116
+
117
+ # collect parameters that are included in param_shapes
118
+ param_names = []
119
+ for s in param_shapes:
120
+ for name in s.keys():
121
+ param_names.append(name)
122
+
123
+ # update with frozen parameters
124
+ frozen_param_shapes = state_dict.get(FROZEN_PARAM_SHAPES, None)
125
+ if frozen_param_shapes is not None:
126
+ if debug:
127
+ print(f"Found frozen_param_shapes: {frozen_param_shapes}")
128
+ param_names += list(frozen_param_shapes.keys())
129
+
130
+ # handle shared params
131
+ shared_params = [[k, v] for k, v in state_dict["shared_params"].items()]
132
+
133
+ ds_version = state_dict.get(DS_VERSION, None)
134
+
135
+ frozen_param_fragments = state_dict.get(FROZEN_PARAM_FRAGMENTS, None)
136
+
137
+ z_model_state = zero_model_state(buffers=buffers,
138
+ param_shapes=param_shapes,
139
+ shared_params=shared_params,
140
+ ds_version=ds_version,
141
+ frozen_param_shapes=frozen_param_shapes,
142
+ frozen_param_fragments=frozen_param_fragments)
143
+ zero_model_states.append(z_model_state)
144
+
145
+ return zero_model_states
146
+
147
+
148
+ def parse_optim_states(files, ds_checkpoint_dir):
149
+ total_files = len(files)
150
+ state_dicts = []
151
+ for f in tqdm(files, desc='Loading checkpoint shards'):
152
+ state_dict = torch.load(f, map_location=device, mmap=True, weights_only=False)
153
+ # immediately discard the potentially huge 2 optimizer states as we only care for fp32 master weights
154
+ # and also handle the case where it was already removed by another helper script
155
+ state_dict["optimizer_state_dict"].pop("optimizer_state_dict", None)
156
+ state_dicts.append(state_dict)
157
+
158
+ if not ZERO_STAGE in state_dicts[0][OPTIMIZER_STATE_DICT]:
159
+ raise ValueError(f"{files[0]} is not a zero checkpoint")
160
+ zero_stage = state_dicts[0][OPTIMIZER_STATE_DICT][ZERO_STAGE]
161
+ world_size = state_dicts[0][OPTIMIZER_STATE_DICT][PARTITION_COUNT]
162
+
163
+ # For ZeRO-2 each param group can have different partition_count as data parallelism for expert
164
+ # parameters can be different from data parallelism for non-expert parameters. So we can just
165
+ # use the max of the partition_count to get the dp world_size.
166
+
167
+ if type(world_size) is list:
168
+ world_size = max(world_size)
169
+
170
+ if world_size != total_files:
171
+ raise ValueError(
172
+ f"Expected {world_size} of '*_optim_states.pt' under '{ds_checkpoint_dir}' but found {total_files} files. "
173
+ "Possibly due to an overwrite of an old checkpoint, or a checkpoint didn't get saved by one or more processes."
174
+ )
175
+
176
+ # the groups are named differently in each stage
177
+ if zero_stage <= 2:
178
+ fp32_groups_key = SINGLE_PARTITION_OF_FP32_GROUPS
179
+ elif zero_stage == 3:
180
+ fp32_groups_key = FP32_FLAT_GROUPS
181
+ else:
182
+ raise ValueError(f"unknown zero stage {zero_stage}")
183
+
184
+ fp32_flat_groups = [state_dicts[i][OPTIMIZER_STATE_DICT][fp32_groups_key] for i in range(len(state_dicts))]
185
+ return zero_stage, world_size, fp32_flat_groups
186
+
187
+
188
+ def _get_fp32_state_dict_from_zero_checkpoint(ds_checkpoint_dir, exclude_frozen_parameters):
189
+ """
190
+ Returns fp32 state_dict reconstructed from ds checkpoint
191
+
192
+ Args:
193
+ - ``ds_checkpoint_dir``: path to the deepspeed checkpoint folder (where the optimizer files are)
194
+
195
+ """
196
+ print(f"Processing zero checkpoint '{ds_checkpoint_dir}'")
197
+
198
+ optim_files = get_optim_files(ds_checkpoint_dir)
199
+ zero_stage, world_size, fp32_flat_groups = parse_optim_states(optim_files, ds_checkpoint_dir)
200
+ print(f"Detected checkpoint of type zero stage {zero_stage}, world_size: {world_size}")
201
+
202
+ model_files = get_model_state_files(ds_checkpoint_dir)
203
+
204
+ zero_model_states = parse_model_states(model_files)
205
+ print(f'Parsing checkpoint created by deepspeed=={zero_model_states[0].ds_version}')
206
+
207
+ if zero_stage <= 2:
208
+ return _get_fp32_state_dict_from_zero2_checkpoint(world_size, fp32_flat_groups, zero_model_states,
209
+ exclude_frozen_parameters)
210
+ elif zero_stage == 3:
211
+ return _get_fp32_state_dict_from_zero3_checkpoint(world_size, fp32_flat_groups, zero_model_states,
212
+ exclude_frozen_parameters)
213
+
214
+
215
+ def _zero2_merge_frozen_params(state_dict, zero_model_states):
216
+ if zero_model_states[0].frozen_param_shapes is None or len(zero_model_states[0].frozen_param_shapes) == 0:
217
+ return
218
+
219
+ frozen_param_shapes = zero_model_states[0].frozen_param_shapes
220
+ frozen_param_fragments = zero_model_states[0].frozen_param_fragments
221
+
222
+ if debug:
223
+ num_elem = sum(s.numel() for s in frozen_param_shapes.values())
224
+ print(f'rank 0: {FROZEN_PARAM_SHAPES}.numel = {num_elem}')
225
+
226
+ wanted_params = len(frozen_param_shapes)
227
+ wanted_numel = sum(s.numel() for s in frozen_param_shapes.values())
228
+ avail_numel = sum([p.numel() for p in frozen_param_fragments.values()])
229
+ print(f'Frozen params: Have {avail_numel} numels to process.')
230
+ print(f'Frozen params: Need {wanted_numel} numels in {wanted_params} params')
231
+
232
+ total_params = 0
233
+ total_numel = 0
234
+ for name, shape in frozen_param_shapes.items():
235
+ total_params += 1
236
+ unpartitioned_numel = shape.numel()
237
+ total_numel += unpartitioned_numel
238
+
239
+ state_dict[name] = frozen_param_fragments[name]
240
+
241
+ if debug:
242
+ print(f"{name} full shape: {shape} unpartitioned numel {unpartitioned_numel} ")
243
+
244
+ print(f"Reconstructed Frozen fp32 state dict with {total_params} params {total_numel} elements")
245
+
246
+
247
+ def _has_callable(obj, fn):
248
+ attr = getattr(obj, fn, None)
249
+ return callable(attr)
250
+
251
+
252
+ def _zero2_merge_trainable_params(state_dict, world_size, fp32_flat_groups, zero_model_states):
253
+ param_shapes = zero_model_states[0].param_shapes
254
+
255
+ # Reconstruction protocol:
256
+ #
257
+ # XXX: document this
258
+
259
+ if debug:
260
+ for i in range(world_size):
261
+ for j in range(len(fp32_flat_groups[0])):
262
+ print(f"{FP32_FLAT_GROUPS}[{i}][{j}].shape={fp32_flat_groups[i][j].shape}")
263
+
264
+ # XXX: memory usage doubles here (zero2)
265
+ num_param_groups = len(fp32_flat_groups[0])
266
+ merged_single_partition_of_fp32_groups = []
267
+ for i in range(num_param_groups):
268
+ merged_partitions = [sd[i] for sd in fp32_flat_groups]
269
+ full_single_fp32_vector = torch.cat(merged_partitions, 0)
270
+ merged_single_partition_of_fp32_groups.append(full_single_fp32_vector)
271
+ avail_numel = sum(
272
+ [full_single_fp32_vector.numel() for full_single_fp32_vector in merged_single_partition_of_fp32_groups])
273
+
274
+ if debug:
275
+ wanted_params = sum([len(shapes) for shapes in param_shapes])
276
+ wanted_numel = sum([sum(shape.numel() for shape in shapes.values()) for shapes in param_shapes])
277
+ # not asserting if there is a mismatch due to possible padding
278
+ print(f"Have {avail_numel} numels to process.")
279
+ print(f"Need {wanted_numel} numels in {wanted_params} params.")
280
+
281
+ # params
282
+ # XXX: for huge models that can't fit into the host's RAM we will have to recode this to support
283
+ # out-of-core computing solution
284
+ total_numel = 0
285
+ total_params = 0
286
+ for shapes, full_single_fp32_vector in zip(param_shapes, merged_single_partition_of_fp32_groups):
287
+ offset = 0
288
+ avail_numel = full_single_fp32_vector.numel()
289
+ for name, shape in shapes.items():
290
+
291
+ unpartitioned_numel = shape.numel() if _has_callable(shape, 'numel') else math.prod(shape)
292
+ total_numel += unpartitioned_numel
293
+ total_params += 1
294
+
295
+ if debug:
296
+ print(f"{name} full shape: {shape} unpartitioned numel {unpartitioned_numel} ")
297
+ state_dict[name] = full_single_fp32_vector.narrow(0, offset, unpartitioned_numel).view(shape)
298
+ offset += unpartitioned_numel
299
+
300
+ # Z2 started to align to 2*world_size to improve nccl performance. Therefore both offset and
301
+ # avail_numel can differ by anywhere between 0..2*world_size. Due to two unrelated complex
302
+ # paddings performed in the code it's almost impossible to predict the exact numbers w/o the
303
+ # live optimizer object, so we are checking that the numbers are within the right range
304
+ align_to = 2 * world_size
305
+
306
+ def zero2_align(x):
307
+ return align_to * math.ceil(x / align_to)
308
+
309
+ if debug:
310
+ print(f"original offset={offset}, avail_numel={avail_numel}")
311
+
312
+ offset = zero2_align(offset)
313
+ avail_numel = zero2_align(avail_numel)
314
+
315
+ if debug:
316
+ print(f"aligned offset={offset}, avail_numel={avail_numel}")
317
+
318
+ # Sanity check
319
+ if offset != avail_numel:
320
+ raise ValueError(f"consumed {offset} numels out of {avail_numel} - something is wrong")
321
+
322
+ print(f"Reconstructed fp32 state dict with {total_params} params {total_numel} elements")
323
+
324
+
325
+ def _get_fp32_state_dict_from_zero2_checkpoint(world_size, fp32_flat_groups, zero_model_states,
326
+ exclude_frozen_parameters):
327
+ state_dict = OrderedDict()
328
+
329
+ # buffers
330
+ buffers = zero_model_states[0].buffers
331
+ state_dict.update(buffers)
332
+ if debug:
333
+ print(f"added {len(buffers)} buffers")
334
+
335
+ if not exclude_frozen_parameters:
336
+ _zero2_merge_frozen_params(state_dict, zero_model_states)
337
+
338
+ _zero2_merge_trainable_params(state_dict, world_size, fp32_flat_groups, zero_model_states)
339
+
340
+ # recover shared parameters
341
+ for pair in zero_model_states[0].shared_params:
342
+ if pair[1] in state_dict:
343
+ state_dict[pair[0]] = state_dict[pair[1]]
344
+
345
+ return state_dict
346
+
347
+
348
+ def zero3_partitioned_param_info(unpartitioned_numel, world_size):
349
+ remainder = unpartitioned_numel % world_size
350
+ padding_numel = (world_size - remainder) if remainder else 0
351
+ partitioned_numel = math.ceil(unpartitioned_numel / world_size)
352
+ return partitioned_numel, padding_numel
353
+
354
+
355
+ def _zero3_merge_frozen_params(state_dict, world_size, zero_model_states):
356
+ if zero_model_states[0].frozen_param_shapes is None or len(zero_model_states[0].frozen_param_shapes) == 0:
357
+ return
358
+
359
+ if debug:
360
+ for i in range(world_size):
361
+ num_elem = sum(s.numel() for s in zero_model_states[i].frozen_param_fragments.values())
362
+ print(f'rank {i}: {FROZEN_PARAM_SHAPES}.numel = {num_elem}')
363
+
364
+ frozen_param_shapes = zero_model_states[0].frozen_param_shapes
365
+ wanted_params = len(frozen_param_shapes)
366
+ wanted_numel = sum(s.numel() for s in frozen_param_shapes.values())
367
+ avail_numel = sum([p.numel() for p in zero_model_states[0].frozen_param_fragments.values()]) * world_size
368
+ print(f'Frozen params: Have {avail_numel} numels to process.')
369
+ print(f'Frozen params: Need {wanted_numel} numels in {wanted_params} params')
370
+
371
+ total_params = 0
372
+ total_numel = 0
373
+ for name, shape in zero_model_states[0].frozen_param_shapes.items():
374
+ total_params += 1
375
+ unpartitioned_numel = shape.numel()
376
+ total_numel += unpartitioned_numel
377
+
378
+ param_frags = tuple(model_state.frozen_param_fragments[name] for model_state in zero_model_states)
379
+ state_dict[name] = torch.cat(param_frags, 0).narrow(0, 0, unpartitioned_numel).view(shape)
380
+
381
+ partitioned_numel, partitioned_padding_numel = zero3_partitioned_param_info(unpartitioned_numel, world_size)
382
+
383
+ if debug:
384
+ print(
385
+ f"Frozen params: {total_params} {name} full shape: {shape} partition0 numel={partitioned_numel} partitioned_padding_numel={partitioned_padding_numel}"
386
+ )
387
+
388
+ print(f"Reconstructed Frozen fp32 state dict with {total_params} params {total_numel} elements")
389
+
390
+
391
+ class GatheredTensor:
392
+ """
393
+ A pseudo tensor that collects partitioned weights.
394
+ It is more memory efficient when there are multiple groups.
395
+ """
396
+
397
+ def __init__(self, flat_groups, flat_groups_offset, offset, partitioned_numel, shape):
398
+ self.flat_groups = flat_groups
399
+ self.flat_groups_offset = flat_groups_offset
400
+ self.offset = offset
401
+ self.partitioned_numel = partitioned_numel
402
+ self.shape = shape
403
+ self.dtype = self.flat_groups[0][0].dtype
404
+
405
+ def contiguous(self):
406
+ """
407
+ Merge partitioned weights from flat_groups into a single tensor.
408
+ """
409
+ end_idx = self.offset + self.partitioned_numel
410
+ world_size = len(self.flat_groups)
411
+ pad_flat_param_chunks = []
412
+
413
+ for rank_i in range(world_size):
414
+ # for each rank, we need to collect weights from related group/groups
415
+ flat_groups_at_rank_i = self.flat_groups[rank_i]
416
+ start_group_id = None
417
+ end_group_id = None
418
+ for group_id in range(len(self.flat_groups_offset)):
419
+ if self.flat_groups_offset[group_id] <= self.offset < self.flat_groups_offset[group_id + 1]:
420
+ start_group_id = group_id
421
+ if self.flat_groups_offset[group_id] < end_idx <= self.flat_groups_offset[group_id + 1]:
422
+ end_group_id = group_id
423
+ break
424
+ # collect weights from related group/groups
425
+ for group_id in range(start_group_id, end_group_id + 1):
426
+ flat_tensor = flat_groups_at_rank_i[group_id]
427
+ start_offset = self.offset - self.flat_groups_offset[group_id]
428
+ end_offset = min(end_idx, self.flat_groups_offset[group_id + 1]) - self.flat_groups_offset[group_id]
429
+ pad_flat_param_chunks.append(flat_tensor[start_offset:end_offset])
430
+
431
+ # collect weights from all ranks
432
+ pad_flat_param = torch.cat(pad_flat_param_chunks, dim=0)
433
+ param = pad_flat_param[:self.shape.numel()].view(self.shape).contiguous()
434
+ return param
435
+
436
+
437
+ def _zero3_merge_trainable_params(state_dict, world_size, fp32_flat_groups, zero_model_states):
438
+ param_shapes = zero_model_states[0].param_shapes
439
+ avail_numel = sum([flat_group.numel() for flat_group in fp32_flat_groups[0]]) * world_size
440
+
441
+ # Reconstruction protocol: For zero3 we need to zip the partitions together at boundary of each
442
+ # param, re-consolidating each param, while dealing with padding if any
443
+
444
+ # merge list of dicts, preserving order
445
+ param_shapes = {k: v for d in param_shapes for k, v in d.items()}
446
+
447
+ if debug:
448
+ for i in range(world_size):
449
+ print(f"{FP32_FLAT_GROUPS}[{i}].shape={fp32_flat_groups[i].shape}")
450
+
451
+ wanted_params = len(param_shapes)
452
+ wanted_numel = sum(shape.numel() for shape in param_shapes.values())
453
+ # not asserting if there is a mismatch due to possible padding
454
+ avail_numel = fp32_flat_groups[0].numel() * world_size
455
+ print(f"Trainable params: Have {avail_numel} numels to process.")
456
+ print(f"Trainable params: Need {wanted_numel} numels in {wanted_params} params.")
457
+
458
+ # params
459
+ # XXX: for huge models that can't fit into the host's RAM we will have to recode this to support
460
+ # out-of-core computing solution
461
+ offset = 0
462
+ total_numel = 0
463
+ total_params = 0
464
+ flat_groups_offset = [0] + list(np.cumsum([flat_tensor.numel() for flat_tensor in fp32_flat_groups[0]]))
465
+ for name, shape in tqdm(param_shapes.items(), desc='Gathering sharded weights'):
466
+ unpartitioned_numel = shape.numel()
467
+ total_numel += unpartitioned_numel
468
+ total_params += 1
469
+ partitioned_numel, partitioned_padding_numel = zero3_partitioned_param_info(unpartitioned_numel, world_size)
470
+
471
+ if debug:
472
+ print(
473
+ f"Trainable params: {total_params} {name} full shape: {shape} partition0 numel={partitioned_numel} partitioned_padding_numel={partitioned_padding_numel}"
474
+ )
475
+
476
+ # memory efficient tensor
477
+ tensor = GatheredTensor(fp32_flat_groups, flat_groups_offset, offset, partitioned_numel, shape)
478
+ state_dict[name] = tensor
479
+ offset += partitioned_numel
480
+
481
+ offset *= world_size
482
+
483
+ # Sanity check
484
+ if offset != avail_numel:
485
+ raise ValueError(f"consumed {offset} numels out of {avail_numel} - something is wrong")
486
+
487
+ print(f"Reconstructed Trainable fp32 state dict with {total_params} params {total_numel} elements")
488
+
489
+
490
+ def _get_fp32_state_dict_from_zero3_checkpoint(world_size, fp32_flat_groups, zero_model_states,
491
+ exclude_frozen_parameters):
492
+ state_dict = OrderedDict()
493
+
494
+ # buffers
495
+ buffers = zero_model_states[0].buffers
496
+ state_dict.update(buffers)
497
+ if debug:
498
+ print(f"added {len(buffers)} buffers")
499
+
500
+ if not exclude_frozen_parameters:
501
+ _zero3_merge_frozen_params(state_dict, world_size, zero_model_states)
502
+
503
+ _zero3_merge_trainable_params(state_dict, world_size, fp32_flat_groups, zero_model_states)
504
+
505
+ # recover shared parameters
506
+ for pair in zero_model_states[0].shared_params:
507
+ if pair[1] in state_dict:
508
+ state_dict[pair[0]] = state_dict[pair[1]]
509
+
510
+ return state_dict
511
+
512
+
513
+ def to_torch_tensor(state_dict, return_empty_tensor=False):
514
+ """
515
+ Convert state_dict of GatheredTensor to torch tensor
516
+ """
517
+ torch_state_dict = {}
518
+ converted_tensors = {}
519
+ for name, tensor in state_dict.items():
520
+ tensor_id = id(tensor)
521
+ if tensor_id in converted_tensors: # shared tensors
522
+ shared_tensor = torch_state_dict[converted_tensors[tensor_id]]
523
+ torch_state_dict[name] = shared_tensor
524
+ else:
525
+ converted_tensors[tensor_id] = name
526
+ if return_empty_tensor:
527
+ torch_state_dict[name] = torch.empty(tensor.shape, dtype=tensor.dtype)
528
+ else:
529
+ torch_state_dict[name] = tensor.contiguous()
530
+ return torch_state_dict
531
+
532
+
533
+ def get_fp32_state_dict_from_zero_checkpoint(checkpoint_dir,
534
+ tag=None,
535
+ exclude_frozen_parameters=False,
536
+ lazy_mode=False):
537
+ """
538
+ Convert ZeRO 2 or 3 checkpoint into a single fp32 consolidated state_dict that can be loaded with
539
+ ``load_state_dict()`` and used for training without DeepSpeed or shared with others, for example
540
+ via a model hub.
541
+
542
+ Args:
543
+ - ``checkpoint_dir``: path to the desired checkpoint folder
544
+ - ``tag``: checkpoint tag used as a unique identifier for checkpoint. If not provided will attempt to load tag in 'latest' file. e.g., ``global_step14``
545
+ - ``exclude_frozen_parameters``: exclude frozen parameters
546
+ - ``lazy_mode``: get state_dict in lazy mode. It returns a dict of pesduo tensor instead of torch tensor, which is more memory efficient.
547
+ Convert the pesduo tensor to torch tensor by ``.contiguous()``
548
+
549
+ Returns:
550
+ - pytorch ``state_dict``
551
+
552
+ A typical usage might be ::
553
+
554
+ from deepspeed.utils.zero_to_fp32 import get_fp32_state_dict_from_zero_checkpoint
555
+ # do the training and checkpoint saving
556
+ state_dict = get_fp32_state_dict_from_zero_checkpoint(checkpoint_dir) # already on cpu
557
+ model = model.cpu() # move to cpu
558
+ model.load_state_dict(state_dict)
559
+ # submit to model hub or save the model to share with others
560
+
561
+ In this example the ``model`` will no longer be usable in the deepspeed context of the same
562
+ application. i.e. you will need to re-initialize the deepspeed engine, since
563
+ ``model.load_state_dict(state_dict)`` will remove all the deepspeed magic from it.
564
+
565
+ If you want it all done for you, use ``load_state_dict_from_zero_checkpoint`` instead.
566
+
567
+ Note: the above usage may not work if your application doesn't have sufficient free CPU memory.
568
+ You may need to use the offline approach using the ``zero_to_fp32.py`` script that is saved with
569
+ the checkpoint. Or you can load state_dict in lazy mode ::
570
+
571
+ from deepspeed.utils.zero_to_fp32 import get_fp32_state_dict_from_zero_checkpoint
572
+ state_dict = get_fp32_state_dict_from_zero_checkpoint(checkpoint_dir, lazy_mode=True) # not on cpu
573
+ for name, lazy_tensor in state_dict.item():
574
+ tensor = lazy_tensor.contiguous() # to cpu
575
+ print(name, tensor)
576
+ # del tensor to release memory if it no longer in use
577
+ """
578
+ if tag is None:
579
+ latest_path = os.path.join(checkpoint_dir, 'latest')
580
+ if os.path.isfile(latest_path):
581
+ with open(latest_path, 'r') as fd:
582
+ tag = fd.read().strip()
583
+ else:
584
+ raise ValueError(f"Unable to find 'latest' file at {latest_path}")
585
+
586
+ ds_checkpoint_dir = os.path.join(checkpoint_dir, tag)
587
+
588
+ if not os.path.isdir(ds_checkpoint_dir):
589
+ raise FileNotFoundError(f"Directory '{ds_checkpoint_dir}' doesn't exist")
590
+
591
+ state_dict = _get_fp32_state_dict_from_zero_checkpoint(ds_checkpoint_dir, exclude_frozen_parameters)
592
+ if lazy_mode:
593
+ return state_dict
594
+ else:
595
+ return to_torch_tensor(state_dict)
596
+
597
+
598
+ def convert_zero_checkpoint_to_fp32_state_dict(checkpoint_dir,
599
+ output_dir,
600
+ max_shard_size="5GB",
601
+ safe_serialization=False,
602
+ tag=None,
603
+ exclude_frozen_parameters=False):
604
+ """
605
+ Convert ZeRO 2 or 3 checkpoint into a single fp32 consolidated ``state_dict`` file that can be
606
+ loaded with ``torch.load(file)`` + ``load_state_dict()`` and used for training without DeepSpeed.
607
+
608
+ Args:
609
+ - ``checkpoint_dir``: path to the desired checkpoint folder. (one that contains the tag-folder, like ``global_step14``)
610
+ - ``output_dir``: directory to the pytorch fp32 state_dict output files
611
+ - ``max_shard_size``: the maximum size for a checkpoint before being sharded, default value is 5GB
612
+ - ``safe_serialization``: whether to save the model using `safetensors` or the traditional PyTorch way (that uses `pickle`).
613
+ - ``tag``: checkpoint tag used as a unique identifier for checkpoint. If not provided will attempt to load tag in the file named ``latest`` in the checkpoint folder, e.g., ``global_step14``
614
+ - ``exclude_frozen_parameters``: exclude frozen parameters
615
+ """
616
+
617
+ # Dependency pre-check
618
+ if safe_serialization:
619
+ try:
620
+ from safetensors.torch import save_file
621
+ except ImportError:
622
+ print('If you want to use `safe_serialization`, please `pip install safetensors`')
623
+ raise
624
+ if max_shard_size is not None:
625
+ try:
626
+ from huggingface_hub import split_torch_state_dict_into_shards
627
+ except ImportError:
628
+ print('If you want to use `max_shard_size`, please `pip install huggingface_hub`')
629
+ raise
630
+
631
+ # Convert zero checkpoint to state_dict
632
+ state_dict = get_fp32_state_dict_from_zero_checkpoint(checkpoint_dir,
633
+ tag,
634
+ exclude_frozen_parameters,
635
+ lazy_mode=True)
636
+
637
+ # Shard the model if it is too big.
638
+ weights_name = "model.safetensors" if safe_serialization else "pytorch_model.bin"
639
+ if max_shard_size is not None:
640
+ filename_pattern = weights_name.replace(".bin", "{suffix}.bin").replace(".safetensors", "{suffix}.safetensors")
641
+ # an memory-efficient approach for sharding
642
+ empty_state_dict = to_torch_tensor(state_dict, return_empty_tensor=True)
643
+ state_dict_split = split_torch_state_dict_into_shards(empty_state_dict,
644
+ filename_pattern=filename_pattern,
645
+ max_shard_size=max_shard_size)
646
+ else:
647
+ from collections import namedtuple
648
+ StateDictSplit = namedtuple("StateDictSplit", ["is_sharded", "filename_to_tensors"])
649
+ state_dict_split = StateDictSplit(is_sharded=False,
650
+ filename_to_tensors={weights_name: list(state_dict.keys())})
651
+
652
+ # Save the model by shard
653
+ os.makedirs(output_dir, exist_ok=True)
654
+ filename_to_tensors = state_dict_split.filename_to_tensors.items()
655
+ for shard_file, tensors in tqdm(filename_to_tensors, desc="Saving checkpoint shards"):
656
+ shard_state_dict = {tensor_name: state_dict[tensor_name] for tensor_name in tensors}
657
+ shard_state_dict = to_torch_tensor(shard_state_dict)
658
+ output_path = os.path.join(output_dir, shard_file)
659
+ if safe_serialization:
660
+ save_file(shard_state_dict, output_path, metadata={"format": "pt"})
661
+ else:
662
+ torch.save(shard_state_dict, output_path)
663
+ # release the memory of current shard
664
+ for tensor_name in list(shard_state_dict.keys()):
665
+ del state_dict[tensor_name]
666
+ del shard_state_dict[tensor_name]
667
+ del shard_state_dict
668
+ gc.collect()
669
+
670
+ # Save index if sharded
671
+ if state_dict_split.is_sharded:
672
+ index = {
673
+ "metadata": state_dict_split.metadata,
674
+ "weight_map": state_dict_split.tensor_to_filename,
675
+ }
676
+ save_index_file = "model.safetensors.index.json" if safe_serialization else "pytorch_model.bin.index.json"
677
+ save_index_file = os.path.join(output_dir, save_index_file)
678
+ with open(save_index_file, "w", encoding="utf-8") as f:
679
+ content = json.dumps(index, indent=2, sort_keys=True) + "\n"
680
+ f.write(content)
681
+
682
+
683
+ def load_state_dict_from_zero_checkpoint(model, checkpoint_dir, tag=None):
684
+ """
685
+ 1. Put the provided model to cpu
686
+ 2. Convert ZeRO 2 or 3 checkpoint into a single fp32 consolidated ``state_dict``
687
+ 3. Load it into the provided model
688
+
689
+ Args:
690
+ - ``model``: the model object to update
691
+ - ``checkpoint_dir``: path to the desired checkpoint folder. (one that contains the tag-folder, like ``global_step14``)
692
+ - ``tag``: checkpoint tag used as a unique identifier for checkpoint. If not provided will attempt to load tag in the file named ``latest`` in the checkpoint folder, e.g., ``global_step14``
693
+
694
+ Returns:
695
+ - ``model`: modified model
696
+
697
+ Make sure you have plenty of CPU memory available before you call this function. If you don't
698
+ have enough use the ``zero_to_fp32.py`` utility to do the conversion. You will find it
699
+ conveniently placed for you in the checkpoint folder.
700
+
701
+ A typical usage might be ::
702
+
703
+ from deepspeed.utils.zero_to_fp32 import load_state_dict_from_zero_checkpoint
704
+ model = load_state_dict_from_zero_checkpoint(trainer.model, checkpoint_dir)
705
+ # submit to model hub or save the model to share with others
706
+
707
+ Note, that once this was run, the ``model`` will no longer be usable in the deepspeed context
708
+ of the same application. i.e. you will need to re-initialize the deepspeed engine, since
709
+ ``model.load_state_dict(state_dict)`` will remove all the deepspeed magic from it.
710
+
711
+ """
712
+ logger.info(f"Extracting fp32 weights")
713
+ state_dict = get_fp32_state_dict_from_zero_checkpoint(checkpoint_dir, tag)
714
+
715
+ logger.info(f"Overwriting model with fp32 weights")
716
+ model = model.cpu()
717
+ model.load_state_dict(state_dict, strict=False)
718
+
719
+ return model
720
+
721
+
722
+ if __name__ == "__main__":
723
+ parser = argparse.ArgumentParser()
724
+ parser.add_argument("checkpoint_dir",
725
+ type=str,
726
+ help="path to the desired checkpoint folder, e.g., path/checkpoint-12")
727
+ parser.add_argument("output_dir",
728
+ type=str,
729
+ help="directory to the pytorch fp32 state_dict output files"
730
+ "(e.g. path/checkpoint-12-output/)")
731
+ parser.add_argument(
732
+ "--max_shard_size",
733
+ type=str,
734
+ default="5GB",
735
+ help="The maximum size for a checkpoint before being sharded. Checkpoints shard will then be each of size"
736
+ "lower than this size. If expressed as a string, needs to be digits followed by a unit (like `5MB`"
737
+ "We default it to 5GB in order for models to be able to run easily on free-tier google colab instances"
738
+ "without CPU OOM issues.")
739
+ parser.add_argument(
740
+ "--safe_serialization",
741
+ default=False,
742
+ action='store_true',
743
+ help="Whether to save the model using `safetensors` or the traditional PyTorch way (that uses `pickle`).")
744
+ parser.add_argument("-t",
745
+ "--tag",
746
+ type=str,
747
+ default=None,
748
+ help="checkpoint tag used as a unique identifier for checkpoint. e.g., global_step1")
749
+ parser.add_argument("--exclude_frozen_parameters", action='store_true', help="exclude frozen parameters")
750
+ parser.add_argument("-d", "--debug", action='store_true', help="enable debug")
751
+ args = parser.parse_args()
752
+
753
+ debug = args.debug
754
+
755
+ convert_zero_checkpoint_to_fp32_state_dict(args.checkpoint_dir,
756
+ args.output_dir,
757
+ max_shard_size=args.max_shard_size,
758
+ safe_serialization=args.safe_serialization,
759
+ tag=args.tag,
760
+ exclude_frozen_parameters=args.exclude_frozen_parameters)