mrkeyoor.com_
Tue 01 Sept 17:44 UTC
Dev Toolsevaluationupdated 29 Aug 2026

Open_Duck_Mini review

Open Duck Mini is an open hardware project for building a 42-centimeter biped inspired by Disney's BDX droid. The repository collects printable parts, CAD, wiring, assembly notes, simulation files, and pretrained walking policies, while the onboard runtime and current training environment live in separate repositories.

+218 / 3dstars / 7d
Verdict

Our Open Duck Mini checkout installed 36 packages and built in 6 seconds, but it offered no test target and did not validate a physical robot. Build it if the mechanical work and sim-to-real tuning are the point of the project. Choose a kit or better-documented platform if you need a dependable first robot, a fixed parts budget, or one repository that takes you from print bed to stable walking.

We ran it

Lab card: what happened when we ran Open_Duck_MiniScreenshot of Open_Duck_Mini (github.com/apirrone/Open_Duck_Mini)
Install✓ · 29s36 packages · 37 MB
Build✓ · 6s
Testsn/ano test script
Known vulns0(pip-audit)
Repo410 files~10,698 lines of source · 182.8 MB · 0 CI workflows

Answers from our run

Does Open_Duck_Mini build from source?

Dependencies installed in 29 seconds (36 packages), and the build succeeded in 6 seconds. We cloned commit b23317a into a clean Debian container with 3 CPUs and no project-specific setup.

Does Open_Duck_Mini have tests you can run?

Not through a standard command: the project exposes no test script or target that our harness could run.

Does Open_Duck_Mini have known vulnerabilities in its dependencies?

pip-audit found none in the dependency tree at the time of our run.

Who should not use Open_Duck_Mini?

First-time builders expecting a finished manual: the assembly guide still says the exact M3 screw count is a TODO and leaves the servo-driver photo and expression features unfinished.

What are the alternatives to Open_Duck_Mini?

Reachy Mini, OpenCat, Mini Pupper. Our Open Duck Mini checkout installed 36 packages and built in 6 seconds, but it offered no test target and did not validate a physical robot.

Setup2/5Code builds quickly; the physical build spans parts and repositories
Docs2/5Useful photos and wiring, with explicit TODOs and outdated pages
Community3/53,620 stars and recent builder questions despite older code activity
Maturity2/5Walking demos exist, but build and training handoffs remain incomplete

Who it’s for

Robotics builders comfortable with 3D printing, soldering, servo setup, and Raspberry Pi administration.
Students who want a physical sim-to-real project instead of a simulator-only exercise.
Researchers who want to modify a small biped's MuJoCo model, rewards, or reference motion.
Makers willing to use Discord, Onshape, external guides, and several repositories to fill documentation gaps.

Who it’s NOT for

First-time builders expecting a finished manual: the assembly guide still says the exact M3 screw count is a TODO and leaves the servo-driver photo and expression features unfinished.
Buyers treating the stated $400 ceiling as a quote: the README calls it a target, the BOM is external, and issue 48 asks which STS3215 motor variant the gait requires.
Teams that need a reproducible training handoff: the sim-to-real guide says it is not finalized, and issue 43 asks for training observations and action initialization details for a supplied policy.
Anyone who wants one supported software package: motor configuration and onboard execution use Open_Duck_Mini_Runtime, while current policy training moved to Open_Duck_Playground.

Setup reality

Our sandbox install succeeded in 29 seconds, adding 36 packages and using 37 MB. The Python build passed in 6 seconds. The repository exposes no test script or target, so tests were skipped. Pip-audit found 0 known vulnerabilities.

Building the robot needs printed PLA and TPU parts, servos, electronics, a battery pack, tools, soldering skill, and a Raspberry Pi Zero 2 W. CAD is hosted in Onshape, the BOM is a Google Sheet, and the finished assembly points to a separate runtime repository.

This checkout is 182.8 MB because it includes CAD, mesh, simulation, and ONNX assets. Current reinforcement-learning work lives in Open_Duck_Playground. The assembly guide is incomplete, and several experimental scripts are explicitly described as old and undocumented.

The 42-centimeter duck is a build project, not a kit

Open Duck Mini v2 is a small biped modeled after Disney's BDX droid. The README says it stands about 42 centimeters tall and sets a goal of keeping the bill of materials below $400. Printable parts, an Onshape CAD model, MuJoCo files, wiring diagrams, motor notes, and 2 ONNX walking policies are available. That is enough material to study the design before buying parts.

It is still a working repository. The maintainers say undocumented scripts remain, and the experiments folder warns that some files are old and should not be run. Onboard code lives in Open_Duck_Mini_Runtime. Training has moved to Open_Duck_Playground, while reference motion has its own repository. A builder has to keep several projects aligned.

Printing needs 2 materials and assembly needs electronics skill

The print guide lists PLA parts at 15% infill and a TPU foot bottom at 40% infill. The build uses heat-set M3 inserts, bearings, servo screws, threadlocker, wiring, and symmetric pieces that must be oriented correctly. Before assembly, each motor receives a specific ID and moves to its zero position so the horn can be fitted. Mistakes here become gait or range problems later.

The guide maps Raspberry Pi pins for eye LEDs, antenna servos, foot switches, a BNO055 sensor, and a MAX98357A amplifier. It warns builders to charge battery cells to the same voltage before installation. The runtime computer is a Raspberry Pi Zero 2 W. Anyone without safe battery, soldering, and multimeter habits should work with an experienced builder.

What happened when we ran it

Our sandbox installed commit b23317a in 29 seconds. It added 36 Python packages and used 37 MB on disk. Building the Python distribution succeeded in 6 seconds, and pip-audit found 0 known vulnerabilities. The repository was 182.8 MB, with 410 files and about 10,698 lines of source, plus robot meshes, CAD exports, simulation assets, and ONNX files.

There was no test script or target, so our lab skipped tests. The checkout also had no tests directory, Dockerfile, or CI workflow files. A passing package build confirms that Python packaging completed. It does not check servo IDs, printed tolerances, wiring, battery behavior, simulation fidelity, policy stability, or whether the physical duck can walk.

The assembly guide still has missing measurements and photos

The assembly page has step photos for the trunk, feet, shins, hips, neck, head, wiring, and body. It also says X m3 screws with a TODO for the exact quantity. The servo-driver-board step asks for a photo, and the head section needs instructions for the camera, antennas, eye LEDs, projector, and speaker. Issue 19 asks for TODO cleanup, updated pictures, and a FAQ.

The README points to a newer Tnkr guide, a Chinese guide, a Google Sheets BOM, Discord, and Onshape. These resources may answer questions the repository does not, but revision matching is harder. No GitHub release freezes one combination of CAD, parts, runtime, and policy. Save the exact documents and branches used before ordering servos or printing the shell.

A walking policy is supplied, while training context is incomplete

Two pretrained ONNX policies can run in simulation through the documented command. The sim-to-real guide explains the route: export from Onshape, tune the MuJoCo mass and motor model, train in Open Duck Playground, generate reference motion, then use the hardware runtime. It labels itself Not finalized yet and sends readers elsewhere for current files.

Issue 43 shows why that matters. A user running BEST_WALK_ONNX_2.onnx reported that the simulated duck fell when commanded forward and asked for training data and advice on initializing 3 prior-action inputs. Issue 52 reports changed 12V knee motors and poor right-foot clearance. A policy file alone does not supply the mechanical and observation context needed for stable motion.

Motor selection can decide whether the gait is reachable

Issue 48 asks whether the BOM meant the STS3215 C046 or C044 rather than the slower C001 variant. The reporter measured a required target speed above the C001's stated limit and could not maintain the gait. The issue had 4 comments when fetched. Confirm the exact submodel and gear ratio before a bulk motor order.

The project's TODO list calls for a new battery-management system, a stronger neck part, complete screw information, updated head files, and possible 12V motors with a retrained policy. Those are proposed tasks, not shipped improvements. Changing voltage, torque, or gearing also changes the physical system the supplied policy expects.

Code paused in January, while builders stayed active in August

GitHub recorded the last repository push on January 31, 2026. The project had 3,620 stars and 24 open issues and pull requests when fetched, with new builder questions through August 20. There is no latest GitHub release. User activity has continued around a code and documentation snapshot that has not moved at the same pace.

Open Duck Mini exposes the difficult gap between a simulated gait and a real machine. Our 6-second package build removes little of that work. The right buyer wants to print, wire, calibrate, debug, and perhaps retrain the robot. Anyone who mainly wants the finished character should choose a supported kit.

Alternatives

ProjectWhat it isPick it when
Reachy MiniAn SDK and ecosystem for a compact expressive desktop robot.pick this instead when interaction and application development matter more than training a walking biped.
OpenCatAn open framework for programmable quadruped robot pets and kits.pick this instead when four-legged stability and a kit-oriented path are preferable to a custom biped.
Mini PupperA small open quadruped platform with ROS-oriented software and hardware resources.pick this instead when ROS integration and a quadruped base fit the project better than BDX-style motion.

What people are saying

  1. [github-trending] apirrone/Open_Duck_Mini

Sources

  1. Open Duck Mini README
  2. Open Duck Mini assembly guide
  3. Open Duck Mini print guide
  4. Open Duck Mini sim-to-real guide
  5. Open Duck Mini project TODO
  6. STS3215 motor specification question
  7. Walking policy training-data question

More dev tools reviews

workmux · v2rayNG · SecLists · hashcat · eslint · fastfetch · the whole board →