RightAiknow commited on
Commit
61bb8b0
·
verified ·
1 Parent(s): 0513502

Upload folder using huggingface_hub

Browse files
README.md ADDED
@@ -0,0 +1,58 @@
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
1
+ ---
2
+ license: apache-2.0
3
+ library_name: lerobot
4
+ pipeline_tag: robotics
5
+ tags:
6
+ - act-policy
7
+ - pytorch_model_hub_mixin
8
+ - robotics
9
+ - IB-Robot
10
+ - LeRobot
11
+ - so-101
12
+ - banana-pick
13
+ - knowledge-distillation
14
+ ---
15
+
16
+ # Model Card for ACT/BananaPick (Distilled)
17
+
18
+ Action Chunking Transformer Policy (as per [Learning Fine-Grained Bimanual Manipulation with Low-Cost Hardware](https://arxiv.org/abs/2304.13705)) trained for banana pick-and-place on a 1-arm SO-101 robot. This checkpoint is a **distilled** model obtained via knowledge distillation.
19
+
20
+ ## How to Get Started with the Model
21
+
22
+ See the [IB-Robot project](https://gitcode.com/openeuler/IB_Robot) (particularly the [inference_service](https://gitcode.com/openeuler/IB_Robot/tree/main/src/inference_service)) for instructions on how to load and deploy this model with ROS 2.
23
+
24
+ To load the model directly in Python:
25
+
26
+ ```python
27
+ from lerobot.common.policies.act.modeling_act import ACTPolicy
28
+
29
+ policy = ACTPolicy.from_pretrained("RightAiknow/act_1arm_2cam_banana_pick_v1_distill")
30
+ ```
31
+
32
+ ## Training Details
33
+
34
+ This model was trained via **knowledge distillation** (`kd: true`) within the IB-Robot framework.
35
+
36
+ - **Policy:** ACT (Action Chunking with Transformers)
37
+ - **Training method:** Knowledge distillation
38
+ - **Robot:** 1-arm SO-101
39
+ - **Cameras:** top, wrist (480x640)
40
+ - **Action dim:** 6
41
+ - **Training steps:** 500,000 (configured)
42
+ - **Checkpoint:** step_160000
43
+ - **Chunk size:** 100
44
+ - **Batch size:** 32
45
+ - **Vision backbone:** ResNet18
46
+ - **Optimizer:** AdamW (lr=1e-5, weight_decay=1e-4)
47
+ - **Latent dim (VAE):** 32
48
+ - **Dim model:** 1024
49
+
50
+ ## Citation
51
+
52
+ ```bibtex
53
+ @software{ib_robot,
54
+ title = {IB-Robot: Intelligence Boom Robot},
55
+ url = {https://gitcode.com/openeuler/IB_Robot},
56
+ license = {Apache-2.0}
57
+ }
58
+ ```
config.json ADDED
@@ -0,0 +1,74 @@
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
1
+ {
2
+ "type": "act",
3
+ "n_obs_steps": 1,
4
+ "input_features": {
5
+ "observation.state": {
6
+ "type": "STATE",
7
+ "shape": [
8
+ 6
9
+ ]
10
+ },
11
+ "observation.images.top": {
12
+ "type": "VISUAL",
13
+ "shape": [
14
+ 3,
15
+ 480,
16
+ 640
17
+ ]
18
+ },
19
+ "observation.images.wrist": {
20
+ "type": "VISUAL",
21
+ "shape": [
22
+ 3,
23
+ 480,
24
+ 640
25
+ ]
26
+ }
27
+ },
28
+ "output_features": {
29
+ "action": {
30
+ "type": "ACTION",
31
+ "shape": [
32
+ 6
33
+ ]
34
+ }
35
+ },
36
+ "device": "cuda",
37
+ "use_amp": false,
38
+ "use_peft": false,
39
+ "push_to_hub": true,
40
+ "repo_id": "my_awesome_follower_arm",
41
+ "private": null,
42
+ "tags": null,
43
+ "license": null,
44
+ "pretrained_path": null,
45
+ "chunk_size": 100,
46
+ "n_action_steps": 100,
47
+ "normalization_mapping": {
48
+ "VISUAL": "MEAN_STD",
49
+ "STATE": "MEAN_STD",
50
+ "ACTION": "MEAN_STD"
51
+ },
52
+ "vision_backbone": "resnet18",
53
+ "pretrained_backbone_weights": "ResNet18_Weights.IMAGENET1K_V1",
54
+ "replace_final_stride_with_dilation": false,
55
+ "pre_norm": false,
56
+ "dim_model": 1024,
57
+ "n_heads": 8,
58
+ "dim_feedforward": 1200,
59
+ "feedforward_activation": "relu",
60
+ "n_encoder_layers": 4,
61
+ "n_decoder_layers": 2,
62
+ "use_vae": true,
63
+ "latent_dim": 32,
64
+ "n_vae_encoder_layers": 4,
65
+ "kd": true,
66
+ "teacher_train_config": "/home/wzl/sx/upload/used_models/1arm_2cam_banana_pick_v1_20260514/ACT_1arm_2cam_banana_pick_v1_step_196000_20260515/pretrained_model/train_config.json",
67
+ "decoder_out_dim": 2048,
68
+ "temporal_ensemble_coeff": null,
69
+ "dropout": 0.1,
70
+ "kl_weight": 10.0,
71
+ "optimizer_lr": 1e-05,
72
+ "optimizer_weight_decay": 0.0001,
73
+ "optimizer_lr_backbone": 1e-05
74
+ }
model.safetensors ADDED
@@ -0,0 +1,3 @@
 
 
 
 
1
+ version https://git-lfs.github.com/spec/v1
2
+ oid sha256:1ac2afec5e3f8e6ab8bc4582f02c29c9106e0d9fe2d7f6b21a060bb1e447b8f6
3
+ size 356747176
policy_postprocessor.json ADDED
@@ -0,0 +1,32 @@
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
1
+ {
2
+ "name": "policy_postprocessor",
3
+ "steps": [
4
+ {
5
+ "registry_name": "unnormalizer_processor",
6
+ "config": {
7
+ "eps": 1e-08,
8
+ "features": {
9
+ "action": {
10
+ "type": "ACTION",
11
+ "shape": [
12
+ 6
13
+ ]
14
+ }
15
+ },
16
+ "norm_map": {
17
+ "VISUAL": "MEAN_STD",
18
+ "STATE": "MEAN_STD",
19
+ "ACTION": "MEAN_STD"
20
+ }
21
+ },
22
+ "state_file": "policy_postprocessor_step_0_unnormalizer_processor.safetensors"
23
+ },
24
+ {
25
+ "registry_name": "device_processor",
26
+ "config": {
27
+ "device": "cpu",
28
+ "float_dtype": null
29
+ }
30
+ }
31
+ ]
32
+ }
policy_postprocessor_step_0_unnormalizer_processor.safetensors ADDED
@@ -0,0 +1,3 @@
 
 
 
 
1
+ version https://git-lfs.github.com/spec/v1
2
+ oid sha256:dec51b26fb6c8f3153cfce30be83e1b25eaee2b51cdac243f00a2b893b82ea19
3
+ size 7536
policy_preprocessor.json ADDED
@@ -0,0 +1,64 @@
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
1
+ {
2
+ "name": "policy_preprocessor",
3
+ "steps": [
4
+ {
5
+ "registry_name": "rename_observations_processor",
6
+ "config": {
7
+ "rename_map": {}
8
+ }
9
+ },
10
+ {
11
+ "registry_name": "to_batch_processor",
12
+ "config": {}
13
+ },
14
+ {
15
+ "registry_name": "device_processor",
16
+ "config": {
17
+ "device": "cuda",
18
+ "float_dtype": null
19
+ }
20
+ },
21
+ {
22
+ "registry_name": "normalizer_processor",
23
+ "config": {
24
+ "eps": 1e-08,
25
+ "features": {
26
+ "observation.state": {
27
+ "type": "STATE",
28
+ "shape": [
29
+ 6
30
+ ]
31
+ },
32
+ "observation.images.top": {
33
+ "type": "VISUAL",
34
+ "shape": [
35
+ 3,
36
+ 480,
37
+ 640
38
+ ]
39
+ },
40
+ "observation.images.wrist": {
41
+ "type": "VISUAL",
42
+ "shape": [
43
+ 3,
44
+ 480,
45
+ 640
46
+ ]
47
+ },
48
+ "action": {
49
+ "type": "ACTION",
50
+ "shape": [
51
+ 6
52
+ ]
53
+ }
54
+ },
55
+ "norm_map": {
56
+ "VISUAL": "MEAN_STD",
57
+ "STATE": "MEAN_STD",
58
+ "ACTION": "MEAN_STD"
59
+ }
60
+ },
61
+ "state_file": "policy_preprocessor_step_3_normalizer_processor.safetensors"
62
+ }
63
+ ]
64
+ }
policy_preprocessor_step_3_normalizer_processor.safetensors ADDED
@@ -0,0 +1,3 @@
 
 
 
 
1
+ version https://git-lfs.github.com/spec/v1
2
+ oid sha256:dec51b26fb6c8f3153cfce30be83e1b25eaee2b51cdac243f00a2b893b82ea19
3
+ size 7536
train_config.json ADDED
@@ -0,0 +1,209 @@
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
1
+ {
2
+ "dataset": {
3
+ "repo_id": "/home/wzl/sx/upload/dataset/1arm_2cam_banana_pick_v1_20260514",
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
+ "affine": {
62
+ "weight": 1.0,
63
+ "type": "RandomAffine",
64
+ "kwargs": {
65
+ "degrees": [
66
+ -5.0,
67
+ 5.0
68
+ ],
69
+ "translate": [
70
+ 0.05,
71
+ 0.05
72
+ ]
73
+ }
74
+ }
75
+ }
76
+ },
77
+ "revision": null,
78
+ "use_imagenet_stats": true,
79
+ "video_backend": "torchcodec",
80
+ "streaming": false
81
+ },
82
+ "env": null,
83
+ "policy": {
84
+ "type": "act",
85
+ "n_obs_steps": 1,
86
+ "input_features": {
87
+ "observation.state": {
88
+ "type": "STATE",
89
+ "shape": [
90
+ 6
91
+ ]
92
+ },
93
+ "observation.images.top": {
94
+ "type": "VISUAL",
95
+ "shape": [
96
+ 3,
97
+ 480,
98
+ 640
99
+ ]
100
+ },
101
+ "observation.images.wrist": {
102
+ "type": "VISUAL",
103
+ "shape": [
104
+ 3,
105
+ 480,
106
+ 640
107
+ ]
108
+ }
109
+ },
110
+ "output_features": {
111
+ "action": {
112
+ "type": "ACTION",
113
+ "shape": [
114
+ 6
115
+ ]
116
+ }
117
+ },
118
+ "device": "cuda",
119
+ "use_amp": false,
120
+ "use_peft": false,
121
+ "push_to_hub": true,
122
+ "repo_id": "my_awesome_follower_arm",
123
+ "private": null,
124
+ "tags": null,
125
+ "license": null,
126
+ "pretrained_path": null,
127
+ "chunk_size": 100,
128
+ "n_action_steps": 100,
129
+ "normalization_mapping": {
130
+ "VISUAL": "MEAN_STD",
131
+ "STATE": "MEAN_STD",
132
+ "ACTION": "MEAN_STD"
133
+ },
134
+ "vision_backbone": "resnet18",
135
+ "pretrained_backbone_weights": "ResNet18_Weights.IMAGENET1K_V1",
136
+ "replace_final_stride_with_dilation": false,
137
+ "pre_norm": false,
138
+ "dim_model": 1024,
139
+ "n_heads": 8,
140
+ "dim_feedforward": 1200,
141
+ "feedforward_activation": "relu",
142
+ "n_encoder_layers": 4,
143
+ "n_decoder_layers": 2,
144
+ "use_vae": true,
145
+ "latent_dim": 32,
146
+ "n_vae_encoder_layers": 4,
147
+ "kd": true,
148
+ "teacher_train_config": "/home/wzl/sx/upload/used_models/1arm_2cam_banana_pick_v1_20260514/ACT_1arm_2cam_banana_pick_v1_step_196000_20260515/pretrained_model/train_config.json",
149
+ "decoder_out_dim": 2048,
150
+ "temporal_ensemble_coeff": null,
151
+ "dropout": 0.1,
152
+ "kl_weight": 10.0,
153
+ "optimizer_lr": 1e-05,
154
+ "optimizer_weight_decay": 0.0001,
155
+ "optimizer_lr_backbone": 1e-05
156
+ },
157
+ "output_dir": "/home/wzl/sx/upload/train_models/1arm_2cam_banana_pick_v1_20260514_训练20260515_distill",
158
+ "job_name": "act_train_banana_distill",
159
+ "resume": false,
160
+ "seed": 1000,
161
+ "ada_weight": true,
162
+ "ada_weight_freq": 200,
163
+ "damping_coefficient": 0.7,
164
+ "cudnn_deterministic": false,
165
+ "num_workers": 10,
166
+ "batch_size": 32,
167
+ "steps": 500000,
168
+ "eval_freq": 2000,
169
+ "log_freq": 200,
170
+ "tolerance_s": 0.0001,
171
+ "save_checkpoint": true,
172
+ "save_freq": 20000,
173
+ "use_policy_training_preset": true,
174
+ "optimizer": {
175
+ "type": "adamw",
176
+ "lr": 1e-05,
177
+ "weight_decay": 0.0001,
178
+ "grad_clip_norm": 10.0,
179
+ "betas": [
180
+ 0.9,
181
+ 0.999
182
+ ],
183
+ "eps": 1e-08
184
+ },
185
+ "scheduler": null,
186
+ "eval": {
187
+ "n_episodes": 50,
188
+ "batch_size": 50,
189
+ "use_async_envs": false
190
+ },
191
+ "wandb": {
192
+ "enable": false,
193
+ "disable_artifact": false,
194
+ "project": "lerobot",
195
+ "entity": null,
196
+ "notes": null,
197
+ "run_id": null,
198
+ "mode": null,
199
+ "add_tags": true
200
+ },
201
+ "peft": null,
202
+ "use_rabc": false,
203
+ "rabc_progress_path": null,
204
+ "rabc_kappa": 0.01,
205
+ "rabc_epsilon": 1e-06,
206
+ "rabc_head_mode": "sparse",
207
+ "rename_map": {},
208
+ "checkpoint_path": null
209
+ }