Skip to content

Repository files navigation

MicroDuck Playground

CI

Reproducible reinforcement-learning experiments, policy demonstrations, and printable hardware add-ons for Pollen Robotics' MicroDuck.

This is an independent experimental continuation of pollen-robotics/microduck_rl, not an official Pollen Robotics release. For the initial public release, all playground-specific work is consolidated into one commit on top of upstream commit d424a0c, preserving the original project history and attribution. Development after the release uses ordinary commits. The upstream project can be added as a Git remote when preparing focused contributions.

Experiments

Animated previews play directly in the table. Click one—or use its explicit full-video link—to open the complete silent MP4.

Experiment Preview Result and artifacts
Self-pumped swing Animated preview of MicroDuck pumping itself on a swing Starts still and reaches a 173.20° strict full span.
Full video · Experiment · Runtime adapter · ONNX on Hugging Face
Fast running Animated preview of MicroDuck running on flat ground Robustified iteration-12,195 simulation candidate: 1.651 m/s nominal, and 1.612 m/s under backlash plus disturbance stress.
Full video · Experiment · ONNX on Hugging Face
Stilt walking Animated preview of MicroDuck walking on green 10 cm stilts Blend-0.50 policies for 10, 15, 20, 25, and 50 cm, plus 1.0, 1.4, and 2.0 m simulation stilts (10 cm shown).
Full video · Experiment · Hardware · Policies and videos

Each preview is a direct simulation demonstration of the policy linked in its row. Compact machine-readable evaluation records live beside each experiment.

Hardware galleries

The retained swing seat keeps the battery centered without occupying the head-and-leg pumping corridors. It includes compliant locating pads, a padded strap, and a removable buckle. The source generators, printable millimetre meshes, MuJoCo collision hulls, and clearance reports are under hardware/swing-seat.

Retained swing seat, front view
Front
Retained swing seat, three-quarter view
Three-quarter
Retained swing seat, side view
Side

The stilt system replaces the removable soles and preserves explicit tip contact geometry. The gallery uses the demonstrated green 10 cm blend-0.50 configuration. Parametric generators and printable meshes are under hardware/stilts.

MicroDuck green stilts, front view
Front
MicroDuck green stilts, three-quarter view
Three-quarter
MicroDuck green stilts, side view
Side
Green 3D-printed MicroDuck replacement sole and stilt prototype
3D-printed prototype

Quick start

A CUDA GPU and uv are recommended. Training uses MuJoCo Warp through mjlab.

git clone https://github.com/Vottivott/microduck-playground
cd microduck-playground
uv sync

# Cheap configuration/training smoke test first.
uv run train Mjlab-SwingPump-MicroDuck \
  --env.scene.num-envs 64 \
  --agent.max-iterations 5

# Full swing training configuration.
uv run train Mjlab-SwingPump-MicroDuck \
  --env.scene.num-envs 4096

Repository layout

experiments/
  running/               clean policy preview and result summary
  stilts/                policy index, executed curriculum, continuation guide
  swing/                 selected checkpoints, evaluation, media, methodology
hardware/
  stilts/                parametric stilt generator and printable meshes
  swing-seat/            retained-seat generator, meshes, clearance reports
src/mjlab_microduck/     tasks, robot models, actuator model, rewards
scripts/                 evaluation, export, rendering, and selection tools
integrations/            policy-specific deployment adapters
tests/                   CPU configuration and invariant tests
docs/                    supporting research and training notes

Scope and safety

These are simulation experiments, not hardware safety certifications. The swing model simulates two elastic tension-only cords and randomized actuator and sensor dynamics, but real cord knots, frame flex, textile contact, servo temperature, and assembly tolerances remain. Extreme-height stilts require an engineered load path and fall protection. Use a safety tether, current limits, an emergency stop, a clear exclusion zone, and conservative incremental tests.

Upstream and contributions

To compare against or prepare a focused pull request for Pollen's project:

git remote add upstream https://github.com/pollen-robotics/microduck_rl.git
git fetch upstream

License

Software is licensed under Apache-2.0; see LICENSE. As in the upstream project, 3D hardware design files are licensed under Creative Commons Attribution-NonCommercial-ShareAlike 4.0 International; see LICENSE-HARDWARE. Third-party MicroDuck assets retain their original attribution and terms. See NOTICE and the hardware-specific READMEs.

About

Reproducible MicroDuck RL experiments, policies, simulation assets, and hardware add-ons

Topics

Resources

Stars

7 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages