Upload policy weights, train config and readme
Browse files- README.md +62 -0
- config.json +75 -0
- model.safetensors +3 -0
- train_config.json +181 -0
README.md
ADDED
@@ -0,0 +1,62 @@
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
1 |
+
---
|
2 |
+
datasets: kelvinzhaozg/digit_third_arm_mujoco_dataset_walking
|
3 |
+
library_name: lerobot
|
4 |
+
license: apache-2.0
|
5 |
+
model_name: vq_flow_transformer
|
6 |
+
pipeline_tag: robotics
|
7 |
+
tags:
|
8 |
+
- robotics
|
9 |
+
- lerobot
|
10 |
+
- vq_flow_transformer
|
11 |
+
---
|
12 |
+
|
13 |
+
# Model Card for vq_flow_transformer
|
14 |
+
|
15 |
+
<!-- Provide a quick summary of what the model is/does. -->
|
16 |
+
|
17 |
+
|
18 |
+
_Model type not recognized — please update this template._
|
19 |
+
|
20 |
+
|
21 |
+
This policy has been trained and pushed to the Hub using [LeRobot](https://github.com/huggingface/lerobot).
|
22 |
+
See the full documentation at [LeRobot Docs](https://huggingface.co/docs/lerobot/index).
|
23 |
+
|
24 |
+
---
|
25 |
+
|
26 |
+
## How to Get Started with the Model
|
27 |
+
|
28 |
+
For a complete walkthrough, see the [training guide](https://huggingface.co/docs/lerobot/il_robots#train-a-policy).
|
29 |
+
Below is the short version on how to train and run inference/eval:
|
30 |
+
|
31 |
+
### Train from scratch
|
32 |
+
|
33 |
+
```bash
|
34 |
+
lerobot-train \
|
35 |
+
--dataset.repo_id=${HF_USER}/<dataset> \
|
36 |
+
--policy.type=act \
|
37 |
+
--output_dir=outputs/train/<desired_policy_repo_id> \
|
38 |
+
--job_name=lerobot_training \
|
39 |
+
--policy.device=cuda \
|
40 |
+
--policy.repo_id=${HF_USER}/<desired_policy_repo_id>
|
41 |
+
--wandb.enable=true
|
42 |
+
```
|
43 |
+
|
44 |
+
_Writes checkpoints to `outputs/train/<desired_policy_repo_id>/checkpoints/`._
|
45 |
+
|
46 |
+
### Evaluate the policy/run inference
|
47 |
+
|
48 |
+
```bash
|
49 |
+
lerobot-record \
|
50 |
+
--robot.type=so100_follower \
|
51 |
+
--dataset.repo_id=<hf_user>/eval_<dataset> \
|
52 |
+
--policy.path=<hf_user>/<desired_policy_repo_id> \
|
53 |
+
--episodes=10
|
54 |
+
```
|
55 |
+
|
56 |
+
Prefix the dataset repo with **eval\_** and supply `--policy.path` pointing to a local or hub checkpoint.
|
57 |
+
|
58 |
+
---
|
59 |
+
|
60 |
+
## Model Details
|
61 |
+
|
62 |
+
- **License:** apache-2.0
|
config.json
ADDED
@@ -0,0 +1,75 @@
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
1 |
+
{
|
2 |
+
"type": "vq_flow_transformer",
|
3 |
+
"n_obs_steps": 1,
|
4 |
+
"normalization_mapping": {},
|
5 |
+
"input_features": {
|
6 |
+
"observation.images.rgb": {
|
7 |
+
"type": "VISUAL",
|
8 |
+
"shape": [
|
9 |
+
3,
|
10 |
+
240,
|
11 |
+
424
|
12 |
+
]
|
13 |
+
},
|
14 |
+
"observation.state": {
|
15 |
+
"type": "STATE",
|
16 |
+
"shape": [
|
17 |
+
24
|
18 |
+
]
|
19 |
+
}
|
20 |
+
},
|
21 |
+
"output_features": {
|
22 |
+
"action": {
|
23 |
+
"type": "ACTION",
|
24 |
+
"shape": [
|
25 |
+
21
|
26 |
+
]
|
27 |
+
}
|
28 |
+
},
|
29 |
+
"device": "cuda",
|
30 |
+
"use_amp": false,
|
31 |
+
"push_to_hub": true,
|
32 |
+
"repo_id": "kelvinzhaozg/vq_flow_transformer_digit_third_arm_mujoco_walking",
|
33 |
+
"private": null,
|
34 |
+
"tags": null,
|
35 |
+
"license": null,
|
36 |
+
"chunk_size": 100,
|
37 |
+
"n_action_steps": 32,
|
38 |
+
"horizon": 64,
|
39 |
+
"action_chunk_size": 8,
|
40 |
+
"vision_backbone": "resnet18",
|
41 |
+
"pretrained_backbone_weights": null,
|
42 |
+
"use_group_norm": true,
|
43 |
+
"spatial_softmax_num_keypoints": 32,
|
44 |
+
"crop_shape": [
|
45 |
+
224,
|
46 |
+
224
|
47 |
+
],
|
48 |
+
"crop_is_random": true,
|
49 |
+
"use_separate_rgb_encoder_per_camera": true,
|
50 |
+
"vqvae_n_embed": 32,
|
51 |
+
"vqvae_embedding_dim": 256,
|
52 |
+
"vqvae_num_layers": 2,
|
53 |
+
"vqvae_enc_hidden_dim": 128,
|
54 |
+
"n_vqvae_training_steps": 100000,
|
55 |
+
"vqvae_commitment_beta": 0.25,
|
56 |
+
"attention_embed_dim": 768,
|
57 |
+
"n_attention_heads": 12,
|
58 |
+
"n_decoder_layers": 8,
|
59 |
+
"attention_dropout": 0.1,
|
60 |
+
"embedding_dropout": 0.1,
|
61 |
+
"use_causal_attention": true,
|
62 |
+
"flow_matching_type": "discrete",
|
63 |
+
"num_integration_steps": 50,
|
64 |
+
"scheduler_power": 2.0,
|
65 |
+
"flow_epsilon": 0.001,
|
66 |
+
"fm_time_embed_dim": 256,
|
67 |
+
"fm_min_period": 0.004,
|
68 |
+
"fm_max_period": 4.0,
|
69 |
+
"cross_attention_dim": 512,
|
70 |
+
"phase1_lr": 0.0005,
|
71 |
+
"phase1_weight_decay": 1e-06,
|
72 |
+
"phase2_lr": 0.0001,
|
73 |
+
"phase2_weight_decay": 1e-06,
|
74 |
+
"do_mask_loss_for_padding": true
|
75 |
+
}
|
model.safetensors
ADDED
@@ -0,0 +1,3 @@
|
|
|
|
|
|
|
|
|
1 |
+
version https://git-lfs.github.com/spec/v1
|
2 |
+
oid sha256:384adf1668e181eba3c397b6603fefc72972ec1e40ec149b2bd2d0ef3a5b9391
|
3 |
+
size 342236588
|
train_config.json
ADDED
@@ -0,0 +1,181 @@
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
1 |
+
{
|
2 |
+
"dataset": {
|
3 |
+
"repo_id": "kelvinzhaozg/digit_third_arm_mujoco_dataset_walking",
|
4 |
+
"root": null,
|
5 |
+
"episodes": null,
|
6 |
+
"image_transforms": {
|
7 |
+
"enable": false,
|
8 |
+
"max_num_transforms": 3,
|
9 |
+
"random_order": false,
|
10 |
+
"tfs": {
|
11 |
+
"brightness": {
|
12 |
+
"weight": 1.0,
|
13 |
+
"type": "ColorJitter",
|
14 |
+
"kwargs": {
|
15 |
+
"brightness": [
|
16 |
+
0.8,
|
17 |
+
1.2
|
18 |
+
]
|
19 |
+
}
|
20 |
+
},
|
21 |
+
"contrast": {
|
22 |
+
"weight": 1.0,
|
23 |
+
"type": "ColorJitter",
|
24 |
+
"kwargs": {
|
25 |
+
"contrast": [
|
26 |
+
0.8,
|
27 |
+
1.2
|
28 |
+
]
|
29 |
+
}
|
30 |
+
},
|
31 |
+
"saturation": {
|
32 |
+
"weight": 1.0,
|
33 |
+
"type": "ColorJitter",
|
34 |
+
"kwargs": {
|
35 |
+
"saturation": [
|
36 |
+
0.5,
|
37 |
+
1.5
|
38 |
+
]
|
39 |
+
}
|
40 |
+
},
|
41 |
+
"hue": {
|
42 |
+
"weight": 1.0,
|
43 |
+
"type": "ColorJitter",
|
44 |
+
"kwargs": {
|
45 |
+
"hue": [
|
46 |
+
-0.05,
|
47 |
+
0.05
|
48 |
+
]
|
49 |
+
}
|
50 |
+
},
|
51 |
+
"sharpness": {
|
52 |
+
"weight": 1.0,
|
53 |
+
"type": "SharpnessJitter",
|
54 |
+
"kwargs": {
|
55 |
+
"sharpness": [
|
56 |
+
0.5,
|
57 |
+
1.5
|
58 |
+
]
|
59 |
+
}
|
60 |
+
}
|
61 |
+
}
|
62 |
+
},
|
63 |
+
"revision": null,
|
64 |
+
"use_imagenet_stats": true,
|
65 |
+
"video_backend": "pyav"
|
66 |
+
},
|
67 |
+
"env": null,
|
68 |
+
"policy": {
|
69 |
+
"type": "vq_flow_transformer",
|
70 |
+
"n_obs_steps": 1,
|
71 |
+
"normalization_mapping": {},
|
72 |
+
"input_features": {
|
73 |
+
"observation.images.rgb": {
|
74 |
+
"type": "VISUAL",
|
75 |
+
"shape": [
|
76 |
+
3,
|
77 |
+
240,
|
78 |
+
424
|
79 |
+
]
|
80 |
+
},
|
81 |
+
"observation.state": {
|
82 |
+
"type": "STATE",
|
83 |
+
"shape": [
|
84 |
+
24
|
85 |
+
]
|
86 |
+
}
|
87 |
+
},
|
88 |
+
"output_features": {
|
89 |
+
"action": {
|
90 |
+
"type": "ACTION",
|
91 |
+
"shape": [
|
92 |
+
21
|
93 |
+
]
|
94 |
+
}
|
95 |
+
},
|
96 |
+
"device": "cuda",
|
97 |
+
"use_amp": false,
|
98 |
+
"push_to_hub": true,
|
99 |
+
"repo_id": "kelvinzhaozg/vq_flow_transformer_digit_third_arm_mujoco_walking",
|
100 |
+
"private": null,
|
101 |
+
"tags": null,
|
102 |
+
"license": null,
|
103 |
+
"chunk_size": 100,
|
104 |
+
"n_action_steps": 32,
|
105 |
+
"horizon": 64,
|
106 |
+
"action_chunk_size": 8,
|
107 |
+
"vision_backbone": "resnet18",
|
108 |
+
"pretrained_backbone_weights": null,
|
109 |
+
"use_group_norm": true,
|
110 |
+
"spatial_softmax_num_keypoints": 32,
|
111 |
+
"crop_shape": [
|
112 |
+
224,
|
113 |
+
224
|
114 |
+
],
|
115 |
+
"crop_is_random": true,
|
116 |
+
"use_separate_rgb_encoder_per_camera": true,
|
117 |
+
"vqvae_n_embed": 32,
|
118 |
+
"vqvae_embedding_dim": 256,
|
119 |
+
"vqvae_num_layers": 2,
|
120 |
+
"vqvae_enc_hidden_dim": 128,
|
121 |
+
"n_vqvae_training_steps": 100000,
|
122 |
+
"vqvae_commitment_beta": 0.25,
|
123 |
+
"attention_embed_dim": 768,
|
124 |
+
"n_attention_heads": 12,
|
125 |
+
"n_decoder_layers": 8,
|
126 |
+
"attention_dropout": 0.1,
|
127 |
+
"embedding_dropout": 0.1,
|
128 |
+
"use_causal_attention": true,
|
129 |
+
"flow_matching_type": "discrete",
|
130 |
+
"num_integration_steps": 50,
|
131 |
+
"scheduler_power": 2.0,
|
132 |
+
"flow_epsilon": 0.001,
|
133 |
+
"fm_time_embed_dim": 256,
|
134 |
+
"fm_min_period": 0.004,
|
135 |
+
"fm_max_period": 4.0,
|
136 |
+
"cross_attention_dim": 512,
|
137 |
+
"phase1_lr": 0.0005,
|
138 |
+
"phase1_weight_decay": 1e-06,
|
139 |
+
"phase2_lr": 0.0001,
|
140 |
+
"phase2_weight_decay": 1e-06,
|
141 |
+
"do_mask_loss_for_padding": true
|
142 |
+
},
|
143 |
+
"output_dir": "outputs/train/2025-09-16/13-14-18_vq_flow_transformer",
|
144 |
+
"job_name": "vq_flow_transformer",
|
145 |
+
"resume": false,
|
146 |
+
"seed": 1000,
|
147 |
+
"num_workers": 4,
|
148 |
+
"batch_size": 8,
|
149 |
+
"steps": 300000,
|
150 |
+
"eval_freq": 20000,
|
151 |
+
"log_freq": 200,
|
152 |
+
"save_checkpoint": true,
|
153 |
+
"save_freq": 20000,
|
154 |
+
"use_policy_training_preset": true,
|
155 |
+
"optimizer": {
|
156 |
+
"type": "adamw",
|
157 |
+
"lr": 0.0005,
|
158 |
+
"weight_decay": 1e-06,
|
159 |
+
"grad_clip_norm": 10.0,
|
160 |
+
"betas": [
|
161 |
+
0.9,
|
162 |
+
0.999
|
163 |
+
],
|
164 |
+
"eps": 1e-08
|
165 |
+
},
|
166 |
+
"scheduler": null,
|
167 |
+
"eval": {
|
168 |
+
"n_episodes": 50,
|
169 |
+
"batch_size": 50,
|
170 |
+
"use_async_envs": false
|
171 |
+
},
|
172 |
+
"wandb": {
|
173 |
+
"enable": true,
|
174 |
+
"disable_artifact": false,
|
175 |
+
"project": "lerobot",
|
176 |
+
"entity": null,
|
177 |
+
"notes": null,
|
178 |
+
"run_id": "hcrsp85e",
|
179 |
+
"mode": null
|
180 |
+
}
|
181 |
+
}
|