ACT sim-warm-start best (step 5000) for real SO-101 pick-orange

.gitattributes

@@ -33,3 +33,5 @@ saved_model/**/* filter=lfs diff=lfs merge=lfs -text
 *.zip filter=lfs diff=lfs merge=lfs -text
 *.zst filter=lfs diff=lfs merge=lfs -text
 *tfevents* filter=lfs diff=lfs merge=lfs -text
+ACT-Real-PickOrange.mp4 filter=lfs diff=lfs merge=lfs -text
+Top-Cam.jpeg filter=lfs diff=lfs merge=lfs -text

ACT-Real-PickOrange.mp4

@@ -0,0 +1,3 @@
+version https://git-lfs.github.com/spec/v1
+oid sha256:723aa5774ae380b498f9216a1ab6e373ae2c0434a389ac834dba5e6c77b26dec
+size 13863635

README.md

@@ -0,0 +1,65 @@
+---
+license: apache-2.0
+pipeline_tag: robotics
+library_name: lerobot
+tags:
+- act
+- so101
+- real-robot
+- manipulation
+- pick-and-place
+- lerobot
+datasets:
+- wsagi/leisaac-real-pick-orange
+base_model: []
+---
+
+# ACT-Real-PickOrange — SO-101 真机抓橙子(sim-warm-start,ACT 真机 best)
+
+真机 SO-101 pick-orange 的 **ACT 策略 best checkpoint**:先在仿真(Isaac Lab `LeIsaac-SO101-PickOrange-v0`)训到 sim leaderboard best,再用 [wsagi/leisaac-real-pick-orange](https://huggingface.co/datasets/wsagi/leisaac-real-pick-orange)(30 集真机遥操演示)**warm-start 续训 5000 步(1.6 epoch)**。
+
+ACT policy for real-world SO-101 pick-and-place: warm-started from our sim-best ACT checkpoint, then fine-tuned for 5000 steps (1.6 epochs) on 30 real teleoperation episodes. **Sim-warm-start is confirmed effective on the real arm** — nearly 2× the from-scratch baseline.
+
+<video src="https://huggingface.co/wsagi/ACT-Real-PickOrange/resolve/main/ACT-Real-PickOrange.mp4" controls muted loop></video>
+
+## 真机结果 / Real-arm results(2026-07-12)
+
+每轮场景放 3 只橙子,记每轮**放入盘中的橙子数**。Each round has 3 oranges on the table; we count oranges placed on the plate per round.
+
+| 策略 / Policy | 轮次成绩 / Per-round | 均值 / Mean |
+|---|---|---|
+| **本模型(simwarm 5000)/ this model** | 2, 1, 1, 3, 2, 1, 0, 1, 2, 2(10 轮) | **1.5 只/轮** |
+| 从零 ACT 6000 / from-scratch baseline | 2, 0, 1, 1, 0(5 轮) | 0.8 只/轮 |
+
+- simwarm 放入 ≥1 只的轮 9/10,含一轮 3 只满放;从零版仅 3/5。
+- **结论:基于仿真 best 续训(sim-warm-start)有效** — 开环 MSE 低 ~40% 的增益在真机变现,均值近 2 倍。同数据的 FlowDP / GR00T-N1.7 头只能抓不能稳放,判别头(ACT)最强。
+
+## 场景 / Scene
+
+顶部相机视角(真机布置)/ top-camera view of the real setup:
+
+![Top-Cam](Top-Cam.jpeg)
+
+## 配方 / Recipe
+
+| 项 | 值 |
+|---|---|
+| 架构 / Arch | ACT(lerobot,chunk_size=100,n_action_steps=100) |
+| init | sim-best ACT(Isaac Lab 仿真 leaderboard best,20k 步) |
+| 数据 / Data | [wsagi/leisaac-real-pick-orange](https://huggingface.co/datasets/wsagi/leisaac-real-pick-orange) 30 集 / 25,091 帧 @30fps |
+| 续训 / Fine-tune | 5000 步(1.6 ep),lr 1e-5,batch 8,MEAN_STD + ImageNet norm |
+| 归一化 / Norm stats | lerobot 0.5.2 warm-start 自动按真机数据集重建(sim stats 不残留) |
+| 观测 / Obs | `front` + `wrist` 相机 640×480 + 6 维关节位置 |
+
+## 用法 / Usage
+
+```python
+from lerobot.policies.act.modeling_act import ACTPolicy
+
+policy = ACTPolicy.from_pretrained("wsagi/ACT-Real-PickOrange")
+```
+
+## 相关项目 / Related projects
+
+- <https://github.com/vitorcen/isaaclab-experience> — 伞仓:多 VLA 基线训练/评测全记录
+- <https://github.com/vitorcen/LeIsaac-Training> — LeIsaac:SO-101 PickOrange 训练 / benchmark / 真机脚手架

config.json

@@ -0,0 +1,71 @@
+{
+    "type": "act",
+    "n_obs_steps": 1,
+    "input_features": {
+        "observation.state": {
+            "type": "STATE",
+            "shape": [
+                6
+            ]
+        },
+        "observation.images.front": {
+            "type": "VISUAL",
+            "shape": [
+                3,
+                480,
+                640
+            ]
+        },
+        "observation.images.wrist": {
+            "type": "VISUAL",
+            "shape": [
+                3,
+                480,
+                640
+            ]
+        }
+    },
+    "output_features": {
+        "action": {
+            "type": "ACTION",
+            "shape": [
+                6
+            ]
+        }
+    },
+    "device": "cuda",
+    "use_amp": false,
+    "use_peft": false,
+    "push_to_hub": false,
+    "repo_id": null,
+    "private": null,
+    "tags": null,
+    "license": null,
+    "pretrained_path": "/home/david/work/isaaclab-experience/LeIsaac/outputs/act-v040-baseline/checkpoints/020000/pretrained_model",
+    "chunk_size": 100,
+    "n_action_steps": 100,
+    "normalization_mapping": {
+        "VISUAL": "MEAN_STD",
+        "STATE": "MEAN_STD",
+        "ACTION": "MEAN_STD"
+    },
+    "vision_backbone": "resnet18",
+    "pretrained_backbone_weights": "ResNet18_Weights.IMAGENET1K_V1",
+    "replace_final_stride_with_dilation": 0,
+    "pre_norm": false,
+    "dim_model": 512,
+    "n_heads": 8,
+    "dim_feedforward": 3200,
+    "feedforward_activation": "relu",
+    "n_encoder_layers": 4,
+    "n_decoder_layers": 1,
+    "use_vae": true,
+    "latent_dim": 32,
+    "n_vae_encoder_layers": 4,
+    "temporal_ensemble_coeff": null,
+    "dropout": 0.1,
+    "kl_weight": 10.0,
+    "optimizer_lr": 1e-05,
+    "optimizer_weight_decay": 0.0001,
+    "optimizer_lr_backbone": 1e-05
+}

model.safetensors

@@ -0,0 +1,3 @@
+version https://git-lfs.github.com/spec/v1
+oid sha256:40a3617e2ec78f35e26a4d375c8c940bf6bc75679ce2431b383d143b253b90a5
+size 206699736

policy_postprocessor.json

@@ -0,0 +1,32 @@
+{
+  "name": "policy_postprocessor",
+  "steps": [
+    {
+      "registry_name": "unnormalizer_processor",
+      "config": {
+        "eps": 1e-08,
+        "features": {
+          "action": {
+            "type": "ACTION",
+            "shape": [
+              6
+            ]
+          }
+        },
+        "norm_map": {
+          "VISUAL": "MEAN_STD",
+          "STATE": "MEAN_STD",
+          "ACTION": "MEAN_STD"
+        }
+      },
+      "state_file": "policy_postprocessor_step_0_unnormalizer_processor.safetensors"
+    },
+    {
+      "registry_name": "device_processor",
+      "config": {
+        "device": "cpu",
+        "float_dtype": null
+      }
+    }
+  ]
+}

policy_postprocessor_step_0_unnormalizer_processor.safetensors

@@ -0,0 +1,3 @@
+version https://git-lfs.github.com/spec/v1
+oid sha256:dfe83860cbc719e7206286401e70bca6b2a1283211ff71e8876037f7ffd0cbd3
+size 7552

policy_preprocessor.json

@@ -0,0 +1,64 @@
+{
+  "name": "policy_preprocessor",
+  "steps": [
+    {
+      "registry_name": "rename_observations_processor",
+      "config": {
+        "rename_map": {}
+      }
+    },
+    {
+      "registry_name": "to_batch_processor",
+      "config": {}
+    },
+    {
+      "registry_name": "device_processor",
+      "config": {
+        "device": "cuda",
+        "float_dtype": null
+      }
+    },
+    {
+      "registry_name": "normalizer_processor",
+      "config": {
+        "eps": 1e-08,
+        "features": {
+          "observation.state": {
+            "type": "STATE",
+            "shape": [
+              6
+            ]
+          },
+          "observation.images.front": {
+            "type": "VISUAL",
+            "shape": [
+              3,
+              480,
+              640
+            ]
+          },
+          "observation.images.wrist": {
+            "type": "VISUAL",
+            "shape": [
+              3,
+              480,
+              640
+            ]
+          },
+          "action": {
+            "type": "ACTION",
+            "shape": [
+              6
+            ]
+          }
+        },
+        "norm_map": {
+          "VISUAL": "MEAN_STD",
+          "STATE": "MEAN_STD",
+          "ACTION": "MEAN_STD"
+        }
+      },
+      "state_file": "policy_preprocessor_step_3_normalizer_processor.safetensors"
+    }
+  ]
+}

policy_preprocessor_step_3_normalizer_processor.safetensors

@@ -0,0 +1,3 @@
+version https://git-lfs.github.com/spec/v1
+oid sha256:70132c4a058d539143efe68c26e73458af6b11934a1e95d05b5cfde680567626
+size 7560

train_config.json

@@ -0,0 +1,203 @@
+{
+    "dataset": {
+        "repo_id": "local/so101-real-pickorange",
+        "root": "/home/david/work/isaaclab-experience/LeIsaac/datasets/raw/so101-real-pickorange",
+        "episodes": null,
+        "image_transforms": {
+            "enable": false,
+            "max_num_transforms": 3,
+            "random_order": false,
+            "tfs": {
+                "brightness": {
+                    "weight": 1.0,
+                    "type": "ColorJitter",
+                    "kwargs": {
+                        "brightness": [
+                            0.8,
+                            1.2
+                        ]
+                    }
+                },
+                "contrast": {
+                    "weight": 1.0,
+                    "type": "ColorJitter",
+                    "kwargs": {
+                        "contrast": [
+                            0.8,
+                            1.2
+                        ]
+                    }
+                },
+                "saturation": {
+                    "weight": 1.0,
+                    "type": "ColorJitter",
+                    "kwargs": {
+                        "saturation": [
+                            0.5,
+                            1.5
+                        ]
+                    }
+                },
+                "hue": {
+                    "weight": 1.0,
+                    "type": "ColorJitter",
+                    "kwargs": {
+                        "hue": [
+                            -0.05,
+                            0.05
+                        ]
+                    }
+                },
+                "sharpness": {
+                    "weight": 1.0,
+                    "type": "SharpnessJitter",
+                    "kwargs": {
+                        "sharpness": [
+                            0.5,
+                            1.5
+                        ]
+                    }
+                },
+                "affine": {
+                    "weight": 1.0,
+                    "type": "RandomAffine",
+                    "kwargs": {
+                        "degrees": [
+                            -5.0,
+                            5.0
+                        ],
+                        "translate": [
+                            0.05,
+                            0.05
+                        ]
+                    }
+                }
+            }
+        },
+        "revision": null,
+        "use_imagenet_stats": true,
+        "video_backend": "torchcodec",
+        "return_uint8": false,
+        "streaming": false
+    },
+    "env": null,
+    "policy": {
+        "type": "act",
+        "n_obs_steps": 1,
+        "input_features": {
+            "observation.state": {
+                "type": "STATE",
+                "shape": [
+                    6
+                ]
+            },
+            "observation.images.front": {
+                "type": "VISUAL",
+                "shape": [
+                    3,
+                    480,
+                    640
+                ]
+            },
+            "observation.images.wrist": {
+                "type": "VISUAL",
+                "shape": [
+                    3,
+                    480,
+                    640
+                ]
+            }
+        },
+        "output_features": {
+            "action": {
+                "type": "ACTION",
+                "shape": [
+                    6
+                ]
+            }
+        },
+        "device": "cuda",
+        "use_amp": false,
+        "use_peft": false,
+        "push_to_hub": false,
+        "repo_id": null,
+        "private": null,
+        "tags": null,
+        "license": null,
+        "pretrained_path": "/home/david/work/isaaclab-experience/LeIsaac/outputs/act-v040-baseline/checkpoints/020000/pretrained_model",
+        "chunk_size": 100,
+        "n_action_steps": 100,
+        "normalization_mapping": {
+            "VISUAL": "MEAN_STD",
+            "STATE": "MEAN_STD",
+            "ACTION": "MEAN_STD"
+        },
+        "vision_backbone": "resnet18",
+        "pretrained_backbone_weights": "ResNet18_Weights.IMAGENET1K_V1",
+        "replace_final_stride_with_dilation": 0,
+        "pre_norm": false,
+        "dim_model": 512,
+        "n_heads": 8,
+        "dim_feedforward": 3200,
+        "feedforward_activation": "relu",
+        "n_encoder_layers": 4,
+        "n_decoder_layers": 1,
+        "use_vae": true,
+        "latent_dim": 32,
+        "n_vae_encoder_layers": 4,
+        "temporal_ensemble_coeff": null,
+        "dropout": 0.1,
+        "kl_weight": 10.0,
+        "optimizer_lr": 1e-05,
+        "optimizer_weight_decay": 0.0001,
+        "optimizer_lr_backbone": 1e-05
+    },
+    "reward_model": null,
+    "output_dir": "/home/david/work/isaaclab-experience/LeIsaac/outputs/act-so101-real-pickorange-simwarm",
+    "job_name": "act",
+    "resume": false,
+    "seed": 1000,
+    "cudnn_deterministic": false,
+    "num_workers": 4,
+    "batch_size": 8,
+    "prefetch_factor": 4,
+    "persistent_workers": true,
+    "steps": 12000,
+    "eval_freq": 20000,
+    "log_freq": 200,
+    "tolerance_s": 0.0001,
+    "save_checkpoint": true,
+    "save_freq": 1000,
+    "use_policy_training_preset": true,
+    "optimizer": {
+        "type": "adamw",
+        "lr": 1e-05,
+        "weight_decay": 0.0001,
+        "grad_clip_norm": 10.0,
+        "betas": [
+            0.9,
+            0.999
+        ],
+        "eps": 1e-08
+    },
+    "scheduler": null,
+    "eval": {
+        "n_episodes": 50,
+        "batch_size": 22,
+        "use_async_envs": true
+    },
+    "wandb": {
+        "enable": false,
+        "disable_artifact": false,
+        "project": "lerobot",
+        "entity": null,
+        "notes": null,
+        "run_id": null,
+        "mode": null,
+        "add_tags": true
+    },
+    "peft": null,
+    "sample_weighting": null,
+    "rename_map": {},
+    "checkpoint_path": null
+}