How to build Microduck: the whole process
93 steps to build Microduck, from buying parts, printing and assembly to software, calibration and training, with the bill of materials, shop links and the official sour…
Feetech HD-1910 community replica, about CN¥2,443: the BOM's own total is CN¥2,426.88 (printed parts CN¥139 as a set, 15 servos CN¥1,425, Radxa Zero 3W CN¥309) plus a CN¥16 sole pad the total leaves out; shipping excluded. Official robot $399 pre-order before tax and shipping
Bill of materials · II. Purchased parts (23 items)
| Part | Qty | CN |
|---|---|---|
| Radxa Zero 3W mainboard | 1 | CNY 309 |
| 64GB TF card | 1 | CNY 60 |
| Raspberry Pi robot HAT circuit board | 1 | CNY 120 |
| imu_to_dxl circuit board | 1 | CNY 80 |
| Feetech HD1901M servo | 15 | CNY 95 |
| Feetech servo URT2 debugger board | 1 | CNY 45 |
| NP-F550 battery | 1 | CNY 17 |
| AMP2.0 double-ended adapter wire microduck servo cable | 1 | CNY 2 |
| 2.5mm Banana Plug PCB Gold-Plated | 2 | CNY 1.6 |
| banana PCB | 1 | CNY 20 |
| IMX219 camera module | 1 | CNY 46.8 |
| VL53L8CX ToF module | 1 | CNY 49.5 |
| Speaker | 1 | CNY 3.8 |
| Bearing 10×15×3 | 3 | CNY 2.8 |
| Bearing 16×22×4 | 11 | CNY 3.5 |
| Bearing 6×12×3 | 4 | CNY 0.88 |
| M2×5 Flat-Head Self-Tapping Screw | 1 pack | CNY 3.05 |
| M2×6 Flat-Head Self-Tapping Screw | 1 pack | CNY 4.05 |
| M2×8 Flat-Head Self-Tapping Screw | 1 pack | CNY 4.05 |
| M2.5×6 Flat-Head Self-Tapping Screw | 1 pack | CNY 3.93 |
| M2.5×8 Flat-Head Self-Tapping Screw | 1 pack | CNY 2.08 |
| Loctite 243 threadlocker | 1 | CNY 9 |
| Sole anti-slip pad | 1 | CNY 16 |
Bill of materials · I. Printed Parts (33 Items)
| Part | Qty |
|---|---|
| Top Head Shell · top_head_shell_top_head_shell.stp · PLA | 1 |
| Bottom Head Shell · bottom_head_shell_bottom_head_shell.stp · PLA | 1 |
| Face Part · face_part_face_part.stp · PLA | 1 |
| Jaw · jaw_jaw.stp · PLA | 1 |
| Soft chin · jaw_soft_soft_chin.stp · PLA | 1 |
| Soft mouth top · soft_mouth_top_soft_mouth_top.stp · PLA | 1 |
| Eyes · noenoeil_eyes.stp · PLA | 1 |
| Neck · neck_neck.stp · PLA | 2 |
| Neck pitch · neck_pitch_neck_pitch.stp · PLA | 1 |
| Trunk base · trunk_base_trunk_base.stp · PLA | 1 |
| Left shell · left_shell_left_shell.stp · PLA | 1 |
| Right shell · right_shell_right_shell.stp · PLA | 1 |
| Left hip · hip_l_left_hip.stp · PLA | 2 |
| Yaw-to-roll · yaw2roll_yaw-to-roll.stp · PLA | 1 |
| Yaw-roll motion · yaw_roll_motion_yaw-roll_motion.stp · PLA | 1 |
| Leg · leg_leg.stp · PLA | 2 |
| Left upper leg · left_upper_leg_left_upper_leg.stp · PLA | 1 |
| Right upper leg · right_upper_leg_right_upper_leg.stp · PLA | 1 |
| Upper leg reinforcement plate · upper_leg_rigidity_plate_upper_leg_reinforcement_plate.stp · PLA | 2 |
| Left foot · foot_left_left_foot.stp · PLA | 1 |
| Right foot · foot_right_right_foot.stp · PLA | 1 |
| Left sole · sole_left_left_sole.stp · PLA | 1 |
| Right sole · sole_right_right_sole.stp · PLA | 1 |
| Left ankle · ankle_left_left_ankle.stp · PLA | 1 |
| Right ankle · ankle_right_right_ankle.stp · PLA | 1 |
| Left ankle (V1 alternative) · ankle_l_v1_left_ankle_V1.stp · PLA | 1 |
| Right ankle (V1 alternative) · ankle_r_v1_right_ankle_V1.stp · PLA | 1 |
| Combined tire · combined_tire.stp · PLA | 4 |
| Roller blade · roller_blade_roller_blade.stp · PLA | 2 |
| Motor bracket · motor_support_motor_bracket.stp · PLA | 1 |
| Power supply bracket · power_support_power_supply_bracket.stp · PLA | 1 |
| Banana-shaped PCB latch · banana_pcb_locker_banana-shaped_PCB_latch.stp · PLA | 1 |
| Bearing roller · bearing_roll_bearing_roller.stp · PLA | 2 |
Buy parts
- Confirm the HD-1910 procurement version
This list applies to the Feite HD-1910 version and includes Feite servos and a URT2 debugging board.
- Download the complete BOM
Download the complete Excel file and check the quantities, materials, notes, prices, and purchase links for 33 printed parts and 23 purchased parts.
- Purchase the complete printed set
The complete printed-part set is listed for 139 yuan in merged range I3:I35 and can be purchased through the link in the list.
- Purchase all externally sourced parts
- Check the total and flagged items
- Review and download the BOM
Open the online latest BOM or the matching main-repository list to check each entry, quantity, material, note, original price, and purchase link. Download the complete Excel workbook when needed.
- Choose the matching CAD version
Select the CAD version matching either the Feite or XL330 servo scheme. Do not mix servo-horn mating parts between versions, and separately verify the XL330 servos and associated electronics.
- Buy the controller electronics
Compare the controller configuration with the main repository’s electronics procurement list. Purchase the 15 servos, HAT board, and IMU board through the GitHub project group purchase or independently from platforms such as JLC and Taobao.
- Check and purchase required materials
Check the servo version and required parts and materials, then purchase consumables, screws, and heat-set inserts using the main repository's mechanical procurement list.
- Check Feetech HD-1910 duck hardware
Use the assembled Feetech HD-1910 version duck with 15 servo IDs configured and the HAT plugged in. Do not use this image with the original XL330 duck; testing was done on a Radxa Zero 3W (no eMMC) with a 32 GB microSD card and C1 revision HAT.
- Choose torso IMU module
Pick either a stand-alone IMU module (BNO085 or LSM6DSV16X) with four wires going to the board, or a small IMU board (ID 200) on the servo bus that the main program searches for when no module is found.
- Prepare microSD card, reader, PC and phone
You need a microSD card of 8 GB or more (32 GB recommended), a card reader, a computer for flashing the card, and a phone for network setup.
Print and make
- Prepare the 33 printed parts
Prepare the 33 printed parts listed for the Feite version from the selected CAD set. The BOM also lists 24 externally purchased items.
- Print the combined tire in TPU
Print the combined tire from the Feite v2.1 CAD set using TPU, even though the original BOM material column still says PLA. The combined tire, roller blade, and wheel-slide bearing are for the wheel-skating variant.
- Open the Bambu Studio project
- Inspect plates and slice
Inspect the arranged plates shown in the project before slicing.
- Use TPU for flexible parts
Slice the soft chin, soft mouth top, and tires with TPU according to the BOM; do not print these flexible parts with the default PLA.
- Configure another printer
When using another printer, confirm that the slicing software can import the 3MF and reset the print parameters for that printer.
- Select the matching servo CAD
Open the CAD repository, select the print models for the servo version being used, and check the material requirements in that version’s printing instructions.
Assemble
- Follow the assembly order
First secure the torso as the reference component, then assemble the left leg, neck and head, and finally the right leg. The sequence is Left Hip → Left Hip Roll → Left Thigh → Left Calf → Left Ankle & Foot; Neck Base → Neck Pitch → Head Yaw/Roll → Head Assembly; Right Hip → Right Hip Roll → Right Thigh → Right Calf → Right Ankle & Foot.
- Prepare and secure the torso
Lay the torso flat on the workbench and inspect its mounting holes, cable outlets, and servo positions. Check for burrs, debris, and damaged threads, then fix it as the assembly reference without striking it forcefully; route cables through the reserved holes without pinching them and confirm hole orientation.
- Install the left hip
Confirm the left-hip orientation because it mirrors the right hip, and power and center the servo before installation. Seat the servo in its mounting slot with its output shaft aligned to the rotation axis, pre-tighten the screws diagonally, tighten them evenly, and verify smooth movement without binding.
- Install the left hip roll
Mount the Left Hip Roll coaxially or adjacently to the hip joint and confirm the Roll-axis direction. After securing it, test the lateral roll range, check that its limit positions do not interfere with the torso, and retain suitable clearance to prevent friction, heating, or binding.
- Install the left thigh
Connect the thigh’s upper end to the hip-joint output and its lower end to the calf. Align and lock the shaft holes at both ends, maintain the thigh-to-calf orientation, and secure wiring along the outside of the leg with extra length for joint movement.
- Install the left calf
Connect the calf’s upper end to the thigh and its lower end to the ankle joint. Confirm the rotation direction and range, lock the connecting screws with moderate force to avoid cracking the plastic, and check that the thigh connection can move without reaching a jammed limit.
- Install the left ankle and foot
Connect the ankle assembly’s upper end to the lower calf, with the foot serving as the end support. Confirm the ankle’s center position before locking it, calibrate that center position, and check that the soles are level and the left and right feet are symmetric for stable standing.
- Install the neck base
Fix the Neck Base at the mounting position on top of the torso and confirm that it is perpendicular. Route the neck cables through the reserved holes before locking it, and provide enough cable length that raising or lowering the head does not pull on the wiring.
- Install the neck pitch joint
Connect the Neck Pitch joint’s upper end to the head joint and its lower end to the Neck Base. Confirm the pitch-axis direction before locking it, check the pitch range for interference with the torso or head, and calibrate the pitch center to establish the correct initial head posture.
- Connect the Head Yaw/Roll Joints
Connect the neck pitch joint to the head assembly. Confirm that the Yaw and Roll axes run in the correct directions, then tighten the fasteners.
- Assemble the Complete Head
Assemble the internal head structure in the order shown in the exploded view, align the shell with the internal bracket, and install the ribbon cable and sensors. Close the shell, tighten its screws, and orient the sensor or camera window forward while leaving cable slack.
- Install the Right Hip
Confirm that the right hip is a mirrored installation of the left hip, then install the hip servo with its output shaft aligned to the rotation axis. Center the servo before tightening and tighten diagonally in stages.
- Install the Right Hip Roll
Install the right hip Roll joint coaxially or adjacent to the right hip, and confirm its rotation-axis direction. Secure it, then rotate it to test the roll range and check for interference with the body.
- Install the Right Thigh
Connect the upper end of the right thigh to the right hip output and the lower end to the right calf. Align the upper and lower axle holes, tighten the fasteners, and secure the wiring along the outside of the thigh.
- Install the Right Calf
Connect the top of the right calf to the right thigh and the bottom to the right ankle joint. Confirm the rotation direction, then tighten the screws with moderate force while keeping the calf mirrored to the left.
- Install the Right Ankle and Foot
Connect the top of the right ankle and foot to the lower end of the right calf, with the foot serving as the end support. Set the ankle joint to its center position before tightening and confirm that both feet rest evenly.
- Check Parts Before Assembly
Before assembly, compare the parts with the BOM to verify their quantities, specifications, and the availability of M2 and M2.5 screws and fasteners.
- Center Servo Joints Before Locking
Power and center servo-driven joints before fastening them to avoid offset motion limits. Lock the joint only after the servo reaches its center position.
- Tighten Screws Gradually
Tighten screws diagonally in stages so force is not applied to only one side, which can deform parts. Do not overtighten screws in plastic components.
- Keep Mirrored Parts Correct
Distinguish the left and right versions of the hips, thighs, calves, and ankle-and-foot assemblies. Install each mirrored component on its correct side without reversing it.
- Secure Cables with Slack
Secure cables consistently and leave extra length for joint movement. Do not pinch, trap, or twist the cables.
- Test Every Moving Joint
After completing each moving joint, rotate it once to test its movement. Check for interference, sticking, or unusual noises.
- Apply Thread Locker Where Required
Apply an appropriate amount of thread locker to connections that require resistance to loosening, following the BOM requirements.
- Check Electrical Connections Before Powering
Before applying power for the first time, check all electrical connections, insulation, and polarity. Power the robot only after confirming that everything is correct.
- Prepare the Recommended Tools
Prepare Phillips and hex screwdrivers with the specifications listed in the BOM, tweezers for small screws, ribbon cables, and clips, and thread locker for fasteners that require locking.
- Wire IMU to HAT J5 or pins 27/28
Connect the four wires to the HAT's J5 or pins 27/28 of the 40-pin header. With the D1 HAT's built-in LSM6DSV16X at address 0x6A, the torso module must be set to 0x6B; mount the LSM6DSV16X with x-axis down and z-axis toward the duck's front, which lets you skip the IMU orientation step.
- Connect IMU before first power-on
The IMU must be connected before the very first power-on, because the duck recognizes it itself at first boot.
Software
- Download image and checksum file
Download microduck-replica-date.img.xz and the matching .sha256 file from GitHub Releases or the netdisk share.
- Verify image checksum
On Windows run Get-FileHash on the .img.xz in the download folder and compare with the string inside the .sha256 file (case does not matter). On Mac or Linux run shasum -a 256 -c on the .sha256 file; this check can be skipped but should be the first thing to check if odd problems appear.
- Flash SD card with balenaEtcher
Use balenaEtcher: select the image file without decompressing the .img.xz, then select the SD card and click Flash. Raspberry Pi Imager also works, using the bottom 'Use custom image' option under Operating System.
- Cancel Windows format prompt
If Windows pops up a prompt saying the card needs formatting after flashing, click cancel and do not format the card.
- Connect to the Duck Hotspot
When the duck cannot connect to any WiFi, it creates the hotspot `Microduck-` followed by the same four characters, such as `Microduck-c51b`, with password `microduck`.
- Join the Duck Hotspot
Find `Microduck-xxxx` in the phone’s WiFi list and connect using password `microduck`. If the phone says that the network cannot access the internet, choose to keep the connection.
- Open Microduck Studio
Open `http://10.42.0.1:8000/` in the phone browser to see Microduck Studio. If it does not open, turn off mobile data and try again.
- Choose the Home WiFi
- Enter the WiFi Password
Enter the home WiFi password every time, including for a saved network.
- Wait for the Network Switch
The duck turns off its hotspot and connects to the home WiFi, so the phone disconnects from the hotspot; this is normal.
- Open the Duck by Device
After the phone or computer joins the home WiFi, open `http://duck-xxxx:8000/` on Windows, `http://duck-xxxx.local:8000/` on an iPhone, iPad, or Mac, or the duck’s IP address on a router’s device list from Android or when neither hostname works.
- Save the Duck Address
- Retry After a Failed Connection
If the password is wrong or the duck cannot connect, the hotspot returns, generally immediately and within about 2 minutes at the latest. Reconnect to `Microduck-xxxx`; the card shows in red why the previous attempt failed so the settings can be corrected and retried.
- Configure the Game Controller
Open the controller page and follow its guide to pair a Bluetooth controller, or use the webpage controller first. For a Thunder G50 Pro controller that switches platforms, move the rear selector to X (Xbox); the 20261021b image connects in X mode.
Calibrate and test
- Insert the SD Card and Power On
Insert the SD card into the main board, then power on the duck with the servo power connected.
- Wait for First-Boot Setup
Wait about 3 minutes while the system expands the remaining SD-card space, gives the duck a `duck-` name with four characters, and recognizes the IMU module. Later startups take less time.
- Follow the Startup Checklist
- Calibrate the Servo Zero Positions
- Perform Coarse IMU Calibration
In the IMU page, hold the duck with both hands, straighten it, keep it still, and lower the front as directed by the page. After the page calculates the direction, straighten the duck and lower the front 15–30° within 20 seconds for verification by the main program.
- Calibrate the IMU Standing
- Use Default IMU Orientation
If IMU calibration was completed earlier or is skipped, the main program uses the default orientation for the official bus-IMU installation, the fork’s BNO085 default, or the replica recommendation for LSM6DSV16X with module x-axis down and z-axis forward. If the installation differs, perform standing calibration again.
- Write Calibration to the Main Program
- Use the Xbox Mode
A G50 Pro in S mode for Switch Pro can pair successfully, but the main program receives no button input and the controller turns itself off after a while; the cause is still under investigation.
- Test the Emergency Stop
Short-press the controller’s Select once and confirm that the duck immediately releases its servos. Holding Select for 2 seconds is the sit, unload, and power-off command, so do not hold it during the emergency-stop test.
Data and training
- Create Backlash Training Tasks
Insert `-Backlash` before `MicroDuck` in each main task ID and train with a model having ±1° gear play. Each of the 14 servo joints has 1° of play in series, for 2° total.
- Configure Backlash Joint Model
Use the implementation in `src/mjlab_microduck/tasks/backlash.py` to give each servo an unactuated `passive_<joint>_backlash` hinge. The encoder emulation and `joint_pos`/`joint_vel` observations read through the backlash, leaving observation and action dimensions unchanged.
- Select BAM M6 Actuator Model
Use the BAM M6 actuator model for the Dynamixel XL330 in all tasks. It includes a voltage control law, back-EMF, Coulomb friction, Stribeck friction, and load-dependent friction.
- Configure Actuator Domain Randomization
Use `FrictionDRBamActuator` from `src/mjlab_microduck/actuator/`. Randomize battery voltage, voltage sag under load, command delay, and friction magnitude per environment.
- Select a MicroDuck MJCF Model
Select the required MJCF robot model from `src/mjlab_microduck/robot/microduck/`. This directory contains the robot's model variants.
- Export Onshape MJCF Configuration
Export the MJCF models from Onshape with `onshape-to-robot`. Provide one corresponding `config_mjcf_*.json` configuration file for each model.
- View Scenes and Run Policy Inference
Use the `scene*.xml` files to load the robot, floor, and STAND, SIT, and FOLD keyframes for quick model viewing. These scene files can also be used with `infer_policy.py` to run a policy.
- Preview the policy upload
Use `--dry-run` to see what would be uploaded without touching the Hub.
- Add and run the episodic bow
Add the `polite-bow` policy on the robot, then run it.
- Add the held flamingo pose
Add the held `flamingo` pose and specify a five-second duration with `--hold 5`.
- Load the walk gait
Load the policy into the `walk` slot as a walking gait.
- Configure an episodic policy
An episodic policy runs for the duration set by `--duration-s` and returns itself to a standing pose. Add `--chain` if holding the button should repeat it.
- Configure a perpetual gait
A perpetual gait runs until told otherwise. Add `--slot walk` or `--slot stand` and nothing else; the owner installs it with `robotctl policy load walk <repo>`.
- Configure a perpetual held pose
Give the perpetual held pose `--unwind-s`, the time the daemon drives the idle twist before handing back to the gait. `--idle` defaults to zeros, and the owner runs the policy as a one-shot with `policy add ... --hold <seconds>`.
- Validate the policy before publishing
Before upload, `publish` checks that the graph is `[1,61] -> [1,14]`, refuses a 51-D legacy policy, runs it on plausible inputs, and refuses NaNs or a constant output.
- Fill in the policy training metadata
`publish` fills the `training` block from git and wandb with the task, commit, branch, dirty flag, run, and checkpoint.
- Set repository publication options
Repositories are created private by default; use `--no-private` for a public repository and `--tag v1` to tag the revision.
- Control overwriting an existing ONNX file
If the repository already contains an `.onnx`, publishing refuses to overwrite it without `--force`.
- Use the official phase-driven policies
Only constant-command policies can be published this way. Phase-driven moves such as the ground pick and the sit↔stand posture flag are driven by the daemon and live in the official set, `pollen-robotics/microduck-policies`.
Use it
- Keep Using the Hotspot
Connecting to the home WiFi is optional; Studio can remain connected to the duck’s hotspot with all functions available.
- Set a Studio Login Password
- Stand Up and Walk
- Release the Duck Immediately
Common problems
- Component sourcing faces long lead times and international shipping barriers #9 #21 #49
- Schematic and PCB files contain errors #17 #56
- Custom trained models are rejected by deployment contracts #60
- Structural inspection is inconvenient in the online viewer #22
- Full groups and expired QR codes block community access #14 #20 #24 #26 #45 #48
Datasets
Parts
- 15 Feetech HD-1910 servos (CN¥95 each in the BOM; group buys through the replica project)
- Radxa Zero 3W, 64 GB microSD card, Pollen's open RPI Robot HAT, bus IMU board
- IMX219 camera, VL53L8CX ToF sensor, speaker, NP-F550 battery
- Bearings, M2 / M2.5 self-tapping screws, Loctite 243
- 33 printed parts (PLA; TPU suggested for the soft jaw and mouth)
Tools
- 3D printer (the author used a Bambu Lab P2S, 0.4 mm nozzle, 0.2 mm layers, 5 plates)
- Phillips and hex screwdrivers, tweezers, threadlocker
- Feetech URT2 board (servo IDs and centring)
- Computer, card reader and phone (flashing and web setup)
Skills
- 3D printing and small mechanical assembly
- Flashing a system image, web setup and calibration
- Optional: RL training (CUDA GPU or Hugging Face Jobs)
Software
- Replica image and the Microduck Studio web console (community)
- microduck_rl: MuJoCo training and ONNX export (official)