Release L-hole III and Hexagon III checkpoints
Browse files
InsertAnything-HexagonHole-III-Direct-v0.pth
ADDED
|
@@ -0,0 +1,3 @@
|
|
|
|
|
|
|
|
|
|
|
|
|
| 1 |
+
version https://git-lfs.github.com/spec/v1
|
| 2 |
+
oid sha256:d11d9a4849238dbdec4602efb86df6d260118fb7ca59e0f159a05546d2b14c08
|
| 3 |
+
size 213716895
|
InsertAnything-LHole-III-Direct-v0.pth
ADDED
|
@@ -0,0 +1,3 @@
|
|
|
|
|
|
|
|
|
|
|
|
|
| 1 |
+
version https://git-lfs.github.com/spec/v1
|
| 2 |
+
oid sha256:fc158b0d72afdab0d860ceb379f8e3ec2b0b693d49c9b24629608a5bea4b58ac
|
| 3 |
+
size 213716895
|
README.md
CHANGED
|
@@ -1,3 +1,91 @@
|
|
| 1 |
---
|
| 2 |
-
license:
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
| 3 |
---
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
| 1 |
---
|
| 2 |
+
license: bsd-3-clause
|
| 3 |
+
library_name: rl-games
|
| 4 |
+
tags:
|
| 5 |
+
- isaac-lab
|
| 6 |
+
- reinforcement-learning
|
| 7 |
+
- robotics
|
| 8 |
+
- peg-in-hole
|
| 9 |
+
- contact-rich-manipulation
|
| 10 |
+
- tactile-sensing
|
| 11 |
+
- sim-to-real
|
| 12 |
+
- insertanything
|
| 13 |
---
|
| 14 |
+
|
| 15 |
+
# InsertAnything Checkpoints
|
| 16 |
+
|
| 17 |
+
Pretrained RL-Games policies for the single-hole precision-insertion environments released with **InsertAnything: Generalizable Contact-Rich Precision Insertion from Simulation to Reality**.
|
| 18 |
+
|
| 19 |
+
The policies were trained entirely in Isaac Lab. They use deployable robot observations together with a compact three-axis fingertip force signal for contact-aware motion correction. The files are intended for evaluation, visualization, and reproducibility checks with the accompanying InsertAnything codebase.
|
| 20 |
+
|
| 21 |
+
## Released files
|
| 22 |
+
|
| 23 |
+
| Checkpoint | Isaac Lab task | Observation dim | Configuration | SHA256 |
|
| 24 |
+
| --- | --- | ---: | --- | --- |
|
| 25 |
+
| `InsertAnything-LHole-III-Direct-v0.pth` | `InsertAnything-LHole-III-Direct-v0` | 26 | L-shape, Tol. III, fingertip force observation, state-independent policy standard deviation | `FC158B0D72AFDAB0D860CEB379F8E3EC2B0B693D49C9B24629608A5BEA4B58AC` |
|
| 26 |
+
| `InsertAnything-HexagonHole-III-Direct-v0.pth` | `InsertAnything-HexagonHole-III-Direct-v0` | 26 | Hexagon, Tol. III, fingertip force observation, state-independent policy standard deviation | `D11D9A4849238DBDEC4602EFB86DF6D260118FB7CA59E0F159A05546D2B14C08` |
|
| 27 |
+
|
| 28 |
+
The checkpoint and task names must match because geometry, observation construction, symmetry handling, and control settings are defined by the registered Isaac Lab task.
|
| 29 |
+
|
| 30 |
+
## Download
|
| 31 |
+
|
| 32 |
+
Install the Hugging Face CLI and download the files from the root of the InsertAnything repository:
|
| 33 |
+
|
| 34 |
+
```powershell
|
| 35 |
+
python -m pip install -U huggingface_hub
|
| 36 |
+
|
| 37 |
+
hf download tOMRmA/InsertAnything-checkpoints InsertAnything-LHole-III-Direct-v0.pth `
|
| 38 |
+
--repo-type model `
|
| 39 |
+
--local-dir source/InsertAnything/InsertAnything/tasks/direct/insertanything/checkpoints
|
| 40 |
+
|
| 41 |
+
hf download tOMRmA/InsertAnything-checkpoints InsertAnything-HexagonHole-III-Direct-v0.pth `
|
| 42 |
+
--repo-type model `
|
| 43 |
+
--local-dir source/InsertAnything/InsertAnything/tasks/direct/insertanything/checkpoints
|
| 44 |
+
```
|
| 45 |
+
|
| 46 |
+
## Evaluation
|
| 47 |
+
|
| 48 |
+
Install the InsertAnything extension and its Isaac Lab dependencies before running these commands.
|
| 49 |
+
|
| 50 |
+
### L-shape Tol. III
|
| 51 |
+
|
| 52 |
+
```powershell
|
| 53 |
+
python scripts/rl_games/play.py `
|
| 54 |
+
--task InsertAnything-LHole-III-Direct-v0 `
|
| 55 |
+
--num_envs 128 `
|
| 56 |
+
--headless `
|
| 57 |
+
--checkpoint source/InsertAnything/InsertAnything/tasks/direct/insertanything/checkpoints/InsertAnything-LHole-III-Direct-v0.pth
|
| 58 |
+
```
|
| 59 |
+
|
| 60 |
+
With Isaac Sim 5.0 and 128 environments, the release validation produced episode success rates of 97.66%, 96.88%, and 94.53%. Results can vary with the simulator version, hardware, and random seed.
|
| 61 |
+
|
| 62 |
+
### Hexagon Tol. III
|
| 63 |
+
|
| 64 |
+
```powershell
|
| 65 |
+
python scripts/rl_games/play.py `
|
| 66 |
+
--task InsertAnything-HexagonHole-III-Direct-v0 `
|
| 67 |
+
--num_envs 128 `
|
| 68 |
+
--headless `
|
| 69 |
+
--checkpoint source/InsertAnything/InsertAnything/tasks/direct/insertanything/checkpoints/InsertAnything-HexagonHole-III-Direct-v0.pth
|
| 70 |
+
```
|
| 71 |
+
|
| 72 |
+
## Integrity check
|
| 73 |
+
|
| 74 |
+
```powershell
|
| 75 |
+
Get-FileHash `
|
| 76 |
+
source/InsertAnything/InsertAnything/tasks/direct/insertanything/checkpoints/*.pth `
|
| 77 |
+
-Algorithm SHA256
|
| 78 |
+
```
|
| 79 |
+
|
| 80 |
+
Compare the returned hashes with the table above before evaluation.
|
| 81 |
+
|
| 82 |
+
## Intended use and limitations
|
| 83 |
+
|
| 84 |
+
- These checkpoints are provided for the corresponding InsertAnything simulation tasks and research use.
|
| 85 |
+
- They are not standalone models: task configuration, assets, observation construction, and controller code are required from the InsertAnything repository.
|
| 86 |
+
- Real-robot deployment additionally requires calibration, compatible robot and tactile-sensor interfaces, safety limits, and operator supervision.
|
| 87 |
+
- Performance on modified assets, simulator settings, observation schemas, or physical systems is not guaranteed by the released simulation validation.
|
| 88 |
+
|
| 89 |
+
## License
|
| 90 |
+
|
| 91 |
+
The checkpoints are released under the BSD 3-Clause license.
|