Instructions to use xiaofengzi/microduck-walking-onnx with libraries, inference providers, notebooks, and local apps. Follow these links to get started.
- Libraries
- Microduck
How to use xiaofengzi/microduck-walking-onnx with Microduck:
# Replace SLOT with the slot specified in the model card (walk, stand, sitstand, ground_pick, kick_left, kick_right, roulade). sudo robotctl policy load SLOT xiaofengzi/microduck-walking-onnx
- Notebooks
- Google Colab
- Kaggle
Add official MicroDuck walking ONNX with source and local validation
Browse files- BEST_alpha_walking.json +7 -0
- BEST_alpha_walking.onnx +3 -0
- README.md +56 -0
- validation_report.json +44 -0
BEST_alpha_walking.json
ADDED
|
@@ -0,0 +1,7 @@
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
| 1 |
+
{
|
| 2 |
+
"source": "Official Pollen Robotics pretrained walking policy; downloaded, not trained locally",
|
| 3 |
+
"source_url": "https://huggingface.co/spaces/pollen-robotics/microduck-simulator/resolve/183f99a40bd7308da3e848de961ed32bb02624a5/app/public/policies/BEST_alpha_walking.onnx",
|
| 4 |
+
"upstream_revision": "183f99a40bd7308da3e848de961ed32bb02624a5",
|
| 5 |
+
"tags": ["official", "walk"],
|
| 6 |
+
"note": "Local CPU inference test only. See validation_report.json. No source checkpoint parity, physics rollout, or hardware test performed."
|
| 7 |
+
}
|
BEST_alpha_walking.onnx
ADDED
|
@@ -0,0 +1,3 @@
|
|
|
|
|
|
|
|
|
|
|
|
|
| 1 |
+
version https://git-lfs.github.com/spec/v1
|
| 2 |
+
oid sha256:e36332d383997d51401897734cd3e79cf5038406feddb18b4d57ecfb141daa6c
|
| 3 |
+
size 793705
|
README.md
ADDED
|
@@ -0,0 +1,56 @@
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
| 1 |
+
---
|
| 2 |
+
tags:
|
| 3 |
+
- onnx
|
| 4 |
+
- robotics
|
| 5 |
+
- reinforcement-learning
|
| 6 |
+
- microduck
|
| 7 |
+
---
|
| 8 |
+
|
| 9 |
+
# MicroDuck walking policy (official pretrained copy)
|
| 10 |
+
|
| 11 |
+
This repository contains `BEST_alpha_walking.onnx`, an unchanged copy of the
|
| 12 |
+
pretrained walking policy distributed by **Pollen Robotics**. It was downloaded
|
| 13 |
+
and smoke-tested locally; it was **not trained or fine-tuned by this uploader**.
|
| 14 |
+
|
| 15 |
+
## Source
|
| 16 |
+
|
| 17 |
+
- Original project: [pollen-robotics/microduck-simulator](https://huggingface.co/spaces/pollen-robotics/microduck-simulator)
|
| 18 |
+
- Pinned revision: `183f99a40bd7308da3e848de961ed32bb02624a5`
|
| 19 |
+
- [Original model file](https://huggingface.co/spaces/pollen-robotics/microduck-simulator/blob/183f99a40bd7308da3e848de961ed32bb02624a5/app/public/policies/BEST_alpha_walking.onnx)
|
| 20 |
+
- SHA-256: `e36332d383997d51401897734cd3e79cf5038406feddb18b4d57ecfb141daa6c`
|
| 21 |
+
|
| 22 |
+
No new license is granted by this copy. Consult the original project and its
|
| 23 |
+
authors for applicable model usage and redistribution terms.
|
| 24 |
+
|
| 25 |
+
## Interface and local validation
|
| 26 |
+
|
| 27 |
+
- Input: `obs`, float32, shape `[1, 61]`.
|
| 28 |
+
- Output: `actions`, float32, shape `[1, 14]`.
|
| 29 |
+
- Observation normalization is included in the graph.
|
| 30 |
+
- ONNX graph checker passed.
|
| 31 |
+
- All 512 wide-distribution random input samples produced finite outputs.
|
| 32 |
+
- Local CPU inference averaged approximately 0.027 ms per call over 1000 calls.
|
| 33 |
+
Timing is specific to the test machine.
|
| 34 |
+
|
| 35 |
+
See `validation_report.json` for recorded results. No source-checkpoint numerical
|
| 36 |
+
parity comparison, physics rollout, or real-hardware test was performed.
|
| 37 |
+
|
| 38 |
+
## Minimal inference example
|
| 39 |
+
|
| 40 |
+
Install `numpy` and `onnxruntime`, download the ONNX file, then run:
|
| 41 |
+
|
| 42 |
+
```python
|
| 43 |
+
import numpy as np
|
| 44 |
+
import onnxruntime as ort
|
| 45 |
+
|
| 46 |
+
session = ort.InferenceSession(
|
| 47 |
+
"BEST_alpha_walking.onnx", providers=["CPUExecutionProvider"]
|
| 48 |
+
)
|
| 49 |
+
obs = np.zeros((1, 61), dtype=np.float32)
|
| 50 |
+
actions = session.run(["actions"], {"obs": obs})[0]
|
| 51 |
+
print(actions.shape) # (1, 14)
|
| 52 |
+
```
|
| 53 |
+
|
| 54 |
+
Zero observations here are synthetic smoke-test data. A robot rollout needs the
|
| 55 |
+
upstream observation layout, control loop, and action processing; these raw
|
| 56 |
+
outputs are not direct hardware commands.
|
validation_report.json
ADDED
|
@@ -0,0 +1,44 @@
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
| 1 |
+
{
|
| 2 |
+
"tested_at": "2026-09-21T09:00:51.513512+00:00",
|
| 3 |
+
"model": "BEST_alpha_walking.onnx",
|
| 4 |
+
"size_bytes": 793705,
|
| 5 |
+
"sha256": "e36332d383997d51401897734cd3e79cf5038406feddb18b4d57ecfb141daa6c",
|
| 6 |
+
"onnx_version": "1.16.0",
|
| 7 |
+
"onnxruntime_version": "1.17.1",
|
| 8 |
+
"providers": [
|
| 9 |
+
"CPUExecutionProvider"
|
| 10 |
+
],
|
| 11 |
+
"input_shape": [
|
| 12 |
+
1,
|
| 13 |
+
61
|
| 14 |
+
],
|
| 15 |
+
"output_shape": [
|
| 16 |
+
1,
|
| 17 |
+
14
|
| 18 |
+
],
|
| 19 |
+
"onnx_checker": "passed",
|
| 20 |
+
"wide_random_samples": 512,
|
| 21 |
+
"wide_random_test": "passed",
|
| 22 |
+
"zero_observation_actions": [
|
| 23 |
+
[
|
| 24 |
+
-0.27203676104545593,
|
| 25 |
+
0.33868545293807983,
|
| 26 |
+
0.29769596457481384,
|
| 27 |
+
-0.11047147959470749,
|
| 28 |
+
0.07768982648849487,
|
| 29 |
+
0.07041269540786743,
|
| 30 |
+
0.016396326944231987,
|
| 31 |
+
-0.5535610318183899,
|
| 32 |
+
0.26069194078445435,
|
| 33 |
+
-0.07948483526706696,
|
| 34 |
+
0.05550389364361763,
|
| 35 |
+
0.26101064682006836,
|
| 36 |
+
-0.20797322690486908,
|
| 37 |
+
-0.1478530466556549
|
| 38 |
+
]
|
| 39 |
+
],
|
| 40 |
+
"mean_inference_ms_1000_calls": 0.026622299919836223,
|
| 41 |
+
"checkpoint_parity": "not tested: source checkpoint unavailable",
|
| 42 |
+
"physics_rollout": "not tested",
|
| 43 |
+
"hardware_test": "not tested"
|
| 44 |
+
}
|