How to build Open Duck Mini v2 (mini BDX biped): the whole process
122 steps to build Open Duck Mini v2 (mini BDX biped), from buying parts, printing and assembly to software, calibration and training, with the bill of materials, shop l…
The creator's BOM sheet totals €398.10 (lowest estimate €331.10, €432.34 with the expression package) and the README says the full BOM should be under $400; a creator's estimate without a 3D printer, tools or shipping, with PLA counted at €20. The complete Tnkr kit is $600 (2026‑11‑01, shipping extra, duties and VAT paid by the buyer)
Buy parts
- Gather tools and supplies
Prepare a soldering iron, basic electronics tools and skills, X M3 screws, some wire, and Loctite Threadlocker blue 243.
- Obtain the bill of materials
Open the Google Sheets BOM to obtain the project's bill of materials. The document also provides a Chinese version of the BOM through Feishu.
Print and make
- Locate the STL files
Find the `.stl` files in the `print/` directory at the repository root.
- Set printing material and infill
Print every part except `foot_bottom_tpu.stl` in standard PLA with 15% infill.
- Print two foot tops
Print `foot_top.stl` twice in standard PLA with 15% infill.
- Print two foot sides
Print `foot_side.stl` twice in standard PLA with 15% infill.
- Print two PLA foot bottoms
Print `foot_bottom_pla.stl` twice in standard PLA with 15% infill.
- Print two TPU foot bottoms
Print `foot_bottom_tpu.stl` twice in TPU with 40% infill.
- Print left knee-to-ankle sheets
Print `knee_to_ankle_left_sheet.stl` four times in standard PLA with 15% infill.
- Print right knee-to-ankle sheets
Print `knee_to_ankle_right_sheet.stl` four times in standard PLA with 15% infill.
- Print four leg spacers
Print `leg_spacer.stl` four times in standard PLA with 15% infill.
- Print left roll-to-pitch part
Print `left_roll_to_pitch.stl` once in standard PLA with 15% infill.
- Print right roll-to-pitch part
Print `right_roll_to_pitch.stl` once in standard PLA with 15% infill.
- Print two roll motor bottoms
Print `roll_motor_bottom.stl` twice in standard PLA with 15% infill.
- Print two roll motor tops
Print `roll_motor_top.stl` twice in standard PLA with 15% infill.
- Print trunk bottom
Print `trunk_bottom.stl` once in standard PLA with 15% infill.
- Print trunk top
Print `trunk_top.stl` once in standard PLA with 15% infill.
- Print left neck sheet
Print `neck_left_sheet.stl` once in standard PLA with 15% infill.
- Print right neck sheet
Print `neck_right_sheet.stl` once in standard PLA with 15% infill.
- Print head pitch-to-yaw part
Print `head_pitch_to_yaw.stl` once in standard PLA with 15% infill.
- Print head yaw-to-roll part
Print `head_yaw_to_roll.stl` once in standard PLA with 15% infill.
- Print head roll mount
Print `head_roll_mount.stl` once in standard PLA with 15% infill.
- Print head
Print `head.stl` once in standard PLA with 15% infill.
- Print head bottom sheet
Print `head_bot_sheet.stl` once in standard PLA with 15% infill.
- Print left antenna holder
Print `left_antenna_holder.stl` once in standard PLA with 15% infill.
- Print right antenna holder
Print `right_antenna_holder.stl` once in standard PLA with 15% infill.
- Print left cache
Print `left_cache.stl` once in standard PLA with 15% infill.
- Print right cache
Print `right_cache.stl` once in standard PLA with 15% infill.
- Print body front
Print `body_front.stl` once in standard PLA with 15% infill.
- Print body middle bottom
Print `body_middle_bottom.stl` once in standard PLA with 15% infill.
- Print body middle top
Print `body_middle_top.stl` once in standard PLA with 15% infill.
- Print body back
Print `body_back.stl` once in standard PLA with 15% infill.
- Print battery pack lid
Print `battery_pack_lid.stl` once in standard PLA with 15% infill.
- Print bulb
Print `bulb.stl` once in standard PLA with 15% infill.
- Print flash light module
Print `flash_light_module.stl` once in standard PLA with 15% infill.
- Print flash reflector interface
Print `flash_reflector_interface.stl` once in standard PLA with 15% infill.
- Print left eye
Print `left_eye.stl` once in standard PLA with 15% infill.
- Print right eye
Print `right_eye.stl` once in standard PLA with 15% infill.
- Print speaker interface
Print `speaker_interface.stl` once in standard PLA with 15% infill.
- Print speaker stand
Print `speaker_stand.stl` once in standard PLA with 15% infill.
- Open the Onshape CAD design
Open the project's Onshape CAD document. The linked prepare_robot document also describes going from an Onshape design to a simulated robot in MuJoCo, but it is outdated and has not been updated for some time.
- Follow the print guide
Open docs/print_guide.md and follow the print instructions it contains.
Assemble
- Apply threadlocker correctly
Use a little threadlocker whenever screws pass through metal motor parts; do not use it on plastic screws.
- Install bearings and inserts
Place the bearings in `trunk_bottom` and insert M3 inserts into the indicated holes.
- Install the bottom inserts
Insert four more M3 inserts into the bottom of this part for mounting body parts later.
- Join the trunk halves
Assemble `trunk_bottom` and `trunk_top`, then join them through the indicated holes with two `M3x10` screws.
- Mount the middle motor
Mount the middle motor as shown and secure it with the plastic screws supplied with the motors.
- Insert the motor bottom bracket
Insert `roll_motor_bottom` as shown.
- Assemble the lower foot parts
First combine `foot_bottom_tpu` with `foot_bottom_pla` and insert M3 inserts into the indicated holes.
- Screw the lower foot parts together
Secure the two lower foot parts together with two `M3x6` screws.
- Insert the foot-top inserts
Insert M3 inserts into the indicated holes in `foot_top`.
- Complete the foot assembly
Assemble all the parts as shown, ensuring the drive side of the motor faces the `foot_top` side.
- Add the foot switches
The foot switches can also be press-fitted in place so that the switches activate when the foot touches the ground.
- Insert M3 Inserts Into the Shin Spacers
Insert M3 inserts into the holes on both sides of `leg_spacer`; insert 4 in total.
- Route the Motor Cable Through the Right Sheet
First plug the motor cable into the foot's motor, then route it through `right_sheet`.
- Assemble the Shin
Assemble the shin as shown in the image.
- Assemble the Thigh and Mount hip_pitch
The thigh is assembled in much the same way, except the `hip_pitch` motor must be mounted as shown because its orientation is important for the zero position.
- Mount the Right Roll-to-Pitch Part
Mount `left_roll_to_pitch` or `right_roll_to_pitch`; because the parts are symmetrical, use the right one.
- Mount roll_motor_top to the Hip Yaw Servo
Attach `roll_motor_top` to the `hip_yaw` servo with the screw from the bottom. Do not mount the servo to the trunk yet.
- Mount the Hip Roll Part
Mount `hip_roll` as shown in the image.
- Insert the Hip Subassembly
Insert the subassembly as shown in the image.
- Screw Together the Assembly
Use the plastic screws provided with the servos to screw together everything possible.
- Mount the Leg to the Hip
The leg can now be mounted to the hip as shown in the image.
- Drill the Neck
Drill the neck as shown in the image.
- Mount head_pitch_to_yaw
First mount `head_pitch_to_yaw` as shown in the image.
- Mount the Head Yaw and Roll Parts
Independently mount `head_yaw_to_roll` and `head_roll_mount` to `head_roll dof`.
- Insert the Head Bottom and Body Plates
You can also insert `head_bot_plate` and `body_middle_top` now to avoid having to disassemble the head later.
- Check the Finished Duck
The duck should now have the assembled appearance shown in the image.
- Mount the servo driver board
Mount the servo driver board on the robot.
- Mount the IMU
It is better to mount the IMU in its correct natural orientation, flipped along the X axis compared with the pictures below. The pictured IMU is upside down, but its mounting orientation can be configured later.
- View the global electronics schematic
Use the global electronics schematic as a wiring reference.
- Wire the feet
Wire the feet following the feet wiring diagram.
- Check the Pi Zero pin mapping
Use the Pi Zero header pin-mapping table when wiring.
- Prepare the battery pack
For safety, make sure all cells are charged to the same voltage before placing them in the holder.
- Insert the head M3 inserts
First, insert M3 inserts into all the holes shown.
- Install the internal head components
Then insert the bearing and mount the ear motors and the Raspberry Pi Zero 2W.
- Assemble the neck and head
Assemble the neck with the head as shown.
- Attach body_middle_bottom
First, screw on `body_middle_bottom`.
- Insert the body M3 inserts
Then insert M3 inserts into every hole of `body_middle_bottom` and `body_middle_top` where the battery pack and `body_front` will be mounted.
- Mount the remaining body and battery
Then mount `body_middle_top`, `body_front`, and the battery pack.
- Complete the duck assembly
The duck is now fully assembled.
- Use the Open Duck Mini build guide
Use the linked Tnkr Open Duck Mini v2 build guide. The document also provides a Chinese build guide.
Software
- Use the Open Duck Playground framework
The document uses the authors' own framework, Open Duck Playground, which is based on mujoco playground.
- Tune rewards and parameters in the joystick env
In the joystick environment you can enable/disable different rewards, write your own, and play with the weights, noise, randomization and similar settings.
- Use MuJoCo Playground
The project is switching to MuJoCo Playground. Use the linked Open_Duck_Playground repository.
- Obtain the onboard runtime
Use the code in the Open_Duck_Mini_Runtime repository to run the policies on the onboard Raspberry Pi Zero 2 W computer.
- Set up Raspberry Pi and runtime
After fully assembling the duck, set up the Raspberry Pi and runtime software using the linked repository.
- Install the runtime repository
Clone the Open_Duck_Mini_Runtime repository on the `v2` branch and install it with `pip install -e .`. Install it on your own computer or on the Raspberry Pi.
Calibrate and test
- Configure left hip yaw
Before building the duck, configure each motor independently. Configure `left_hip_yaw` with ID 20; the motor moves to its zero position, then install the horn and align it as well as possible using the photo as a reference.
- Configure left hip roll
Before building the duck, configure each motor independently. Configure `left_hip_roll` with ID 21; the motor moves to its zero position, then install the horn and align it as well as possible using the photo as a reference.
- Configure left hip pitch
Before building the duck, configure each motor independently. Configure `left_hip_pitch` with ID 22; the motor moves to its zero position, then install the horn and align it as well as possible using the photo as a reference.
- Configure left knee
Before building the duck, configure each motor independently. Configure `left_knee` with ID 23; the motor moves to its zero position, then install the horn and align it as well as possible using the photo as a reference.
- Configure left ankle
Before building the duck, configure each motor independently. Configure `left_ankle` with ID 24; the motor moves to its zero position, then install the horn and align it as well as possible using the photo as a reference.
- Configure neck pitch
Before building the duck, configure each motor independently. Configure `neck_pitch` with ID 30; the motor moves to its zero position, then install the horn and align it as well as possible using the photo as a reference.
- Configure head pitch
Before building the duck, configure each motor independently. Configure `head_pitch` with ID 31; the motor moves to its zero position, then install the horn and align it as well as possible using the photo as a reference.
- Configure head yaw
Before building the duck, configure each motor independently. Configure `head_yaw` with ID 32; the motor moves to its zero position, then install the horn and align it as well as possible using the photo as a reference.
- Configure head roll
Before building the duck, configure each motor independently. Configure `head_roll` with ID 33; the motor moves to its zero position, then install the horn and align it as well as possible using the photo as a reference.
- Configure right hip yaw
Before building the duck, configure each motor independently. Configure `right_hip_yaw` with ID 10; the motor moves to its zero position, then install the horn and align it as well as possible using the photo as a reference.
- Configure right hip roll
Before building the duck, configure each motor independently. Configure `right_hip_roll` with ID 11; the motor moves to its zero position, then install the horn and align it as well as possible using the photo as a reference.
- Configure right hip pitch
Before building the duck, configure each motor independently. Configure `right_hip_pitch` with ID 12; the motor moves to its zero position, then install the horn and align it as well as possible using the photo as a reference.
- Configure right knee
Before building the duck, configure each motor independently. Configure `right_knee` with ID 13; the motor moves to its zero position, then install the horn and align it as well as possible using the photo as a reference.
- Configure right ankle
Before building the duck, configure each motor independently. Configure `right_ankle` with ID 14; the motor moves to its zero position, then install the horn and align it as well as possible using the photo as a reference.
- Model motor behavior with BAM
Use BAM to model motor behavior and use the provided identification results instead of repeating the identification process.
- Export identified parameters to MuJoCo units
Use bam.to_mujoco to export the main identified parameters to MuJoCo units.
- Set actuator and joint properties
Set the exported values as actuator and joint properties in the MJCF model: damping, kp, frictionloss, armature, and forcerange.
- Complete the checklist before running
Before running the real-robot script, make sure all steps in the runtime repo's checklist.md are completed.
- Configure the motors first
Configure the motors according to the linked instructions before assembling the duck.
- Identify actuator parameters
The project uses Rhoban's BAM for actuator identification. Use the linked BAM repository.
Data and training
- Review each part's material
Open the linked Onshape document and review the material specified for each robot part.
- Override masses with slicer estimates
Because the parts are printed with infill, override each part's mass with the slicer's fairly accurate estimate.
- Export URDF and MJCF descriptions
Use onshape-to-robot to export the robot's URDF/MJCF descriptions.
- Create lightweight MJX model
Create a lightweight robot model for MJX using the linked config.json.
- Set full-robot mass and inertia
Set the masses and moments of inertia of the full robot in the resulting MJCF description.
- Implement Disney's imitation reward
The authors got good results by implementing the imitation reward described by Disney in their BDX paper, as implemented in the playground's joystick.py.
- Generate reference motion data
Use the Open_Duck_reference_motion_generator repo, which generates such motion with a parametric walk engine. Following its instructions produces a polynomial_coefficients.pkl file containing the reference motions.
- Use the ready-made file in data/
Such a file already exists in the playground repo under the data/ directory, so it can be used directly.
- Train the policy
Train the policy in Open Duck Playground; the trained policy is then used on the real robot.
- Run a trained walking policy
Use BEST_WALK_ONNX.onnx or BEST_WALK_ONNX_2.onnx and run the example policy with v2_rl_walk_mujoco.py.
- Generate imitation-learning reference motion
Use the Open_Duck_reference_motion_generator repository to generate reference motion for imitation learning.
Use it
- Run the trained policy on the real robot
Run the trained policy on the real robot using the v2_rl_walk_mujoco.py script from the runtime repo.
Common problems
- Printed parts have misaligned or conflicting servo mounting features. #7 #17
- Assembly instructions and BOM omit or misidentify required hardware. #1 #3 #9 #14
- Directly driving one-watt LEDs overloads the Raspberry Pi GPIO pins. #34
- Required Python modules are missing, preventing scripts from running. #12 #39
- The required Duck.iso setup image cannot be located. #57
- Adapted motor characteristics require retuning to stop foot trembling. #21
- Servo-bus CRC errors prevent the robot from walking. #49
- The handle cannot support lifting the robot. #30
Parts
- 14 × Feetech STS3215 serial servos (the 7.4V, 19 kg·cm version): hip yaw/roll/pitch, knee and ankle on each leg, plus 4 in the neck and head
- 2 × 9g servos and a Waveshare bus servo adapter
- Raspberry Pi Zero 2W with an SD card; BNO055 IMU; 4 × SS-10 foot contact switches
- 2 × 18650 cells (the creator uses 3000 mAh, 30A discharge), 2S BMS, 5V regulator, switch, USB‑C charger
- M3 heat-set inserts, 3 bearings, cable sheath and USB cables; PLA prints (15% infill) and TPU soles (40% infill)
- Optional expression package: speaker and amplifier, eye LEDs and diffusers, projector reflector, microphone, Raspberry Pi camera
Tools
- 3D printer (PLA and TPU)
- Soldering iron and basic electronics tools
- M3 screws and Loctite 243 blue threadlocker (for every metal-on-metal servo screw)
Skills
- Soldering and wiring
- Setting each servo's ID and zero position with a Python script before assembly
- Raspberry Pi Linux, SSH and Python virtual environments
- Advanced: training policies in MuJoCo Playground and identifying servo parameters with BAM
Software
- Open_Duck_Mini_Runtime: runs ONNX gait policies on the Raspberry Pi with Xbox controller driving (V2 Classic release, 2025‑08)
- Open_Duck_Playground: MuJoCo Playground RL environments with the MJCF model and imitation reward
- Open_Duck_reference_motion_generator: reference motions from a parametric walk engine
- STS3215 parameters identified with Rhoban's BAM; URDF/MJCF exported with onshape-to-robot