Connecting to sources…

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

Documents