docs: HF model card for OpenRAL/rskill-3d_diffuser_actor-franka_panda-rlbench-fp32 v0.1.0
Browse files
README.md
CHANGED
|
@@ -21,13 +21,13 @@ inference: false
|
|
| 21 |
|
| 22 |
<!--
|
| 23 |
rSkill README — 3D Diffuser Actor (RLBench PerAct setup).
|
| 24 |
-
Discovery + provenance card; mirrors rskill.yaml.
|
| 25 |
-->
|
| 26 |
|
| 27 |
-
# rskill-
|
| 28 |
|
| 29 |
3D Diffuser Actor — a diffusion policy over end-effector **keyposes** for RLBench,
|
| 30 |
-
running on the CoppeliaSim/PyRep RLBench benchmark backend
|
| 31 |
|
| 32 |
## What this skill does
|
| 33 |
|
|
@@ -98,7 +98,7 @@ supervision).
|
|
| 98 |
|
| 99 |
| Field | Value |
|
| 100 |
|---|---|
|
| 101 |
-
| `name` | `OpenRAL/rskill-
|
| 102 |
| `version` | `0.1.0` |
|
| 103 |
| `license` | `mit` |
|
| 104 |
| `role` | `s1` |
|
|
@@ -113,7 +113,7 @@ supervision).
|
|
| 113 |
|
| 114 |
```bash
|
| 115 |
# One-time: provision CoppeliaSim 4.1.0 + PyRep + RLBench@peract + the checkpoint
|
| 116 |
-
# in the py3.10 sidecar venv
|
| 117 |
openral benchmark scene \
|
| 118 |
--config scenes/benchmark/rlbench_open_drawer.yaml \
|
| 119 |
--rskill rskills/3d-diffuser-actor-rlbench
|
|
@@ -121,13 +121,13 @@ openral benchmark scene \
|
|
| 121 |
|
| 122 |
Inference VRAM peaks ~0.43 GB; runs comfortably on an 8 GB GPU. CoppeliaSim is
|
| 123 |
proprietary (free EDU license) and is **never** vendored — it is an
|
| 124 |
-
externally-provisioned dependency (CLAUDE.md §1.9
|
| 125 |
|
| 126 |
## Evaluation
|
| 127 |
|
| 128 |
[`eval/rlbench.json`](eval/rlbench.json) is the **full official protocol**
|
| 129 |
result (`reproduced_locally: true`), produced by the canonical
|
| 130 |
-
`openral benchmark run`
|
| 131 |
**25 episodes per task**, seeds 0–24, max 25 macro-keyposes:
|
| 132 |
|
| 133 |
| Task | Success rate |
|
|
@@ -147,7 +147,7 @@ openral benchmark run --suite rlbench --rskill rskills/3d-diffuser-actor-rlbench
|
|
| 147 |
> **Note on variance.** RLBench's sampling-based `EndEffectorPoseViaPlanning`
|
| 148 |
> mover is non-deterministic, so per-task rates vary run-to-run; 3 of the 75
|
| 149 |
> episodes hit a planner path-failure and are counted as failed episodes (the
|
| 150 |
-
> sidecar handles them gracefully rather than aborting the run
|
| 151 |
> Per-task paper baselines (Ke et al., 2402.10885, Table 1) are intentionally
|
| 152 |
> not transcribed into the artifact to avoid mis-citation.
|
| 153 |
|
|
@@ -164,4 +164,3 @@ uses `license: mit` for the consumer-visible weight/runtime posture.
|
|
| 164 |
- `scenes/benchmark/rlbench_meat_off_grill.yaml`
|
| 165 |
- `scenes/benchmark/rlbench_close_jar.yaml`
|
| 166 |
- `benchmarks/rlbench.yaml`
|
| 167 |
-
- `docs/adr/0062-rlbench-benchmark-backend.md`
|
|
|
|
| 21 |
|
| 22 |
<!--
|
| 23 |
rSkill README — 3D Diffuser Actor (RLBench PerAct setup).
|
| 24 |
+
Discovery + provenance card; mirrors rskill.yaml.
|
| 25 |
-->
|
| 26 |
|
| 27 |
+
# rskill-3d_diffuser_actor-franka_panda-rlbench-fp32
|
| 28 |
|
| 29 |
3D Diffuser Actor — a diffusion policy over end-effector **keyposes** for RLBench,
|
| 30 |
+
running on the CoppeliaSim/PyRep RLBench benchmark backend.
|
| 31 |
|
| 32 |
## What this skill does
|
| 33 |
|
|
|
|
| 98 |
|
| 99 |
| Field | Value |
|
| 100 |
|---|---|
|
| 101 |
+
| `name` | `OpenRAL/rskill-3d_diffuser_actor-franka_panda-rlbench-fp32` |
|
| 102 |
| `version` | `0.1.0` |
|
| 103 |
| `license` | `mit` |
|
| 104 |
| `role` | `s1` |
|
|
|
|
| 113 |
|
| 114 |
```bash
|
| 115 |
# One-time: provision CoppeliaSim 4.1.0 + PyRep + RLBench@peract + the checkpoint
|
| 116 |
+
# in the py3.10 sidecar venv.
|
| 117 |
openral benchmark scene \
|
| 118 |
--config scenes/benchmark/rlbench_open_drawer.yaml \
|
| 119 |
--rskill rskills/3d-diffuser-actor-rlbench
|
|
|
|
| 121 |
|
| 122 |
Inference VRAM peaks ~0.43 GB; runs comfortably on an 8 GB GPU. CoppeliaSim is
|
| 123 |
proprietary (free EDU license) and is **never** vendored — it is an
|
| 124 |
+
externally-provisioned dependency (CLAUDE.md §1.9).
|
| 125 |
|
| 126 |
## Evaluation
|
| 127 |
|
| 128 |
[`eval/rlbench.json`](eval/rlbench.json) is the **full official protocol**
|
| 129 |
result (`reproduced_locally: true`), produced by the canonical
|
| 130 |
+
`openral benchmark run` on an 8 GB Ada host (2026-06-20) —
|
| 131 |
**25 episodes per task**, seeds 0–24, max 25 macro-keyposes:
|
| 132 |
|
| 133 |
| Task | Success rate |
|
|
|
|
| 147 |
> **Note on variance.** RLBench's sampling-based `EndEffectorPoseViaPlanning`
|
| 148 |
> mover is non-deterministic, so per-task rates vary run-to-run; 3 of the 75
|
| 149 |
> episodes hit a planner path-failure and are counted as failed episodes (the
|
| 150 |
+
> sidecar handles them gracefully rather than aborting the run).
|
| 151 |
> Per-task paper baselines (Ke et al., 2402.10885, Table 1) are intentionally
|
| 152 |
> not transcribed into the artifact to avoid mis-citation.
|
| 153 |
|
|
|
|
| 164 |
- `scenes/benchmark/rlbench_meat_off_grill.yaml`
|
| 165 |
- `scenes/benchmark/rlbench_close_jar.yaml`
|
| 166 |
- `benchmarks/rlbench.yaml`
|
|
|