Profile
Back to NewsBack
GitHub Trending 5 min
Reader Mode
Vottivott/microduck-playground: Reproducible Microduck RL experiments, policies, simulation assets, and hardware add-ons

Vottivott/microduck-playground: Reproducible Microduck RL experiments, policies, simulation assets, and hardware add-ons

Microduck Playground

CI</a>

Watercolor illustration of Microduck pumping on its swing

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 video.

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
Blind basketball balance Microduck balancing and moving on a basketball LSTM policy with no ball-state input: 97.01% survival over 60 seconds in 3,072 simulation trials. Experimental hardware-test candidate; hardware untested.
Full video · Experiment and training · ONNX and checkpoint · LSTM runtime PR
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
Climbing Cream Microduck climbing a modular ladder onto a desk and standing up Climb, land, recover.
Experiment and training · Ladder and mounts · Models
Chimney climbing Animated preview of Microduck entering a narrow corridor, climbing to a platform, exiting and standing up Braced climbing through a 12.5 cm gap to a 3 m platform. Selected simulation rollout; hardware untested.
Full video · Experiment and training · Climb, enter and exit policies
Raised-platform long jumpRaised-platform long jump in simulationSimulation only; not yet validated on hardware.
Details and reproduction · Policy and training checkpoint
Raised-platform backflipRaised-platform backflip in simulationExperimental simulation policy; hardware unvalidated. ⚠️ Landings may break the robot.
Details and reproduction · Policy and training checkpoint
Self-charging dock Animated preview of Microduck turning around and backing into a printed dock until the magnetic tip in its USB-C port meets the charging adapter Backs into a fully printed dock that connects a magnetic charger to its own USB-C port: 30/30 docked in simulation with the official walking policy. Not yet tried on hardware.
Full video · Hardware and simulation · Bambu P1S project (3 plates) (how to print)
MicroDock v2 Animated preview of Microduck turning around, sitting down and scooting back on its seat into the seated dock until the magnetic tip in its USB-C port meets the charging adapter, dozing off, then scooting out, standing up and walking off Sits down to charge: it scoots back into the dock on its seat, then scoots out and walks off when charged. 30/30 docked and undocked in simulation. Not yet tried on hardware.
Full video · Hardware and simulation · Bambu P1S project (3 plates) · Scoot policies and training
MicroDock v3 Animated preview of Microduck turning around, sitting down and scooting back into the egg dock until the magnetic tip in its USB-C port meets the adapter in the floating hood, then scooting out, standing up and walking off The egg dock: the hood floats on printed springs hidden inside the egg. 90/90 docked and undocked in simulation with v2's scoot policies; printed and tried by hand.
Full video · Hardware and simulation · Bambu P1S project (7 plates) · Assembly manual

Previews illustrate simulation behaviors. The jump/backflip excerpts are selected research footage; see their documented fresh-checkpoint verification and original footage provenance limits. 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

The modular climbing ladder has pin-free stacking joints, a central spine, a matching floor base and printed tightening screws for the table mounts. Printable models, generators, assembly instructions and the full gallery are under hardware/ladder.

Stackable ladder modules and friction-fit joints
Stacking joints
Modular ladder floor base
Floor base
Top module with threaded table mounts
Table mounts

The MicroDock v3 charging dock is fully printed: no screws or glue. Microduck sits down and scoots back on its seat until the magnetic tip in its own USB-C port meets a magnetic adapter in the hood, which floats on a spring stage printed in PLA and hidden inside an egg. When it is charged, it scoots out, stands up and walks off. The generator, printable meshes, docking and undocking simulation, renders and assembly manual are under hardware/microdock-v3, with a ready-to-print Bambu Studio project for a Bambu Lab P1S in hardware/microdock-v3/print. The MicroDock v2, whose hood slides on pegs in a flat board, has the scoot policies and their training; the original MicroDock is the one the duck backs into standing.

MicroDock v3 assembled: base plate, egg with AprilTag and floating hood
Assembled
MicroDock v3 printed parts pulled apart: base, front plate, tag, hood, spring stage and dome
Printed parts
Microduck docked sitting down at the egg dock, with the hood resting on its back
Docked

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/
  parkour/               raised-platform long jump and backflip
  basketball/            blind LSTM policy, evaluation, continuation guide
  running/               clean policy preview and result summary
  stilts/                policy index, executed curriculum, continuation guide
  swing/                 selected checkpoints, evaluation, media, methodology
hardware/
  microdock/             printable charging dock, docking simulation, renders
  microdock-v2/          the seated dock: new board, scoot policies and training, simulation
  microdock-v3/          the egg dock: printed spring stage, simulation, assembly manual
  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.

Chat with me