How to build Unitree Qmini (3D-printable open-source biped)
63 steps to build Unitree Qmini (3D-printable open-source biped), with the source documents.
Unitree sells no robot or kit and gives no total BOM cost. The official Unitree store lists the GO-M8010-6 motor at $369.00 each (the BOM needs 11 8010 motors) and the USB-to-4-channel 485 module at $30.00 (2026‑11‑01, store shown in USD, tax and shipping not read); the Go1 battery, Raspberry Pi and filament prices were not read
Buy parts
- Acquire all required components
Use the complete bill of materials and open-source resources to acquire all required components.
Print and make
- Print the top main frame
Print in PLA with 4 wall layers, 4 top shell layers, 4 bottom shell layers, 20% sparse infill, and a honeycomb pattern. Tree supports and an outer skirt are enabled by default; insert M5 and M4 heat-set inserts vertically, with the insert face flush with the top surface.
- Print the front fan mount
Print in PLA with 5 wall layers, 5 top shell layers, 5 bottom shell layers, 20% sparse infill, and a honeycomb pattern. Tree supports and an outer skirt are enabled by default; insert three M3 heat-set inserts vertically, with their faces flush with the top surface.
- Print the battery bottom support
Print in PLA with 3 wall layers, 3 top shell layers, 3 bottom shell layers, 15% sparse infill, and a grid/honeycomb pattern. All printing uses tree supports and an outer skirt by default.
- Print the leg yaw-axis limit blocks
Print in PLA with 5 wall layers, 5 top shell layers, 5 bottom shell layers, 20% sparse infill, and a honeycomb pattern. All printing uses tree supports and an outer skirt by default.
- Print the top yaw motor mount
Print in PLA with 4 wall layers, 4 top shell layers, 4 bottom shell layers, 20% sparse infill, and a honeycomb pattern. All printing uses tree supports and an outer skirt by default.
- Print the top gyroscope mount
Print in PLA with 3 wall layers, 3 top shell layers, 3 bottom shell layers, 15% sparse infill, and a grid/honeycomb pattern. Tree supports and an outer skirt are enabled by default; insert one M3 heat-set insert vertically, with its face flush with the top surface.
- Print the Raspberry Pi mount
Print in PLA with 3 wall layers, 3 top shell layers, 3 bottom shell layers, 15% sparse infill, and a grid/honeycomb pattern. All printing uses tree supports and an outer skirt by default.
- Print the hip motor mount
Print in PLA with 5 wall layers, 5 top shell layers, 5 bottom shell layers, 20% sparse infill, and a honeycomb pattern. Tree supports and an outer skirt are enabled by default; press in a stainless-steel bushing and insert one M4 heat-set insert.
- Print the hip motor clamp
Print in PLA with 5 wall layers, 5 top shell layers, 5 bottom shell layers, 20% sparse infill, and a honeycomb pattern. Tree supports and an outer skirt are enabled by default; insert one M5 heat-set insert.
- Print the side-swing drive gear
Print in PLA with 5 wall layers, 5 top shell layers, 5 bottom shell layers, 20% sparse infill, and a honeycomb pattern. All printing uses tree supports and an outer skirt by default.
- Print the ankle motor side cover
Print in PLA with 2 wall layers, 3 top shell layers, 3 bottom shell layers, 15% sparse infill, and a grid/honeycomb pattern. All printing uses tree supports and an outer skirt by default.
- Print the leg front fan mount
Print in PLA with 5 wall layers, 5 top shell layers, 5 bottom shell layers, 20% sparse infill, and a honeycomb pattern. Tree supports and an outer skirt are enabled by default; insert an M3 heat-set insert.
- 3D-print the mechanical structure
Download the STEP files for all mechanical components and print the entire mechanical structure; virtually no custom machining is required.
Assemble
- Install the top-frame motors
Place two M8010 motors into the corresponding slots of the top main frame, assigning them to motor 0 and motor 1, namely upper-body motors 0 and 1.
- Install the leg yaw-axis limit blocks
Flip the assembly over, fit the leg yaw-axis limit blocks, and install six M3.5×16 bolts, five M3.5×8 bolts, and five M3.5×8 bolts.
- Install the hip motor mounts
Assemble the left and right hip motor mounts onto the leg yaw motors; install four M4×14 bolts on the left and four M4×14 bolts on the right.
- Install clamps and side-swing gears
Assemble the left and right hip motor clamps and install the left and right side-swing drive gears. The left and right leg parts are mirrored and must not be confused or exchanged. Install twenty M4×14 bolts.
- Disassemble the Go1 charger
Disassemble the Go1 battery charger and remove its internal PCB.
- Install the battery contact base
Install the removed battery contact base at the bottom of the printed battery compartment and secure it with the charger's four M3 countersunk bolts.
- Install and wire the boat switch
Press the boat switch fully into the battery bottom support and solder its contacts to the battery contact base's BAT− and BAT+ terminals.
- Mount the front axial fans
Mount two 4010 axial fans on the front fan bracket with their labeled orientation facing downward, then secure them with four M3×14 button-head bolts.
- Install the main-frame bearings
Press two 19 mm OD, 6 mm ID bearings into the main-frame bearing holes, tapping them with a rubber mallet if needed until fully seated.
- Join the main frame and battery compartment
Align the main-frame and battery-compartment mounting holes and secure them with four M4×20 button-head bolts.
- Secure the battery bottom support
Connect the battery bottom support to the main frame and battery compartment, then tighten four M4×16 button-head bolts.
- Install the front fan bracket
Mount the front fan bracket on the robot body using two M4×20 button-head bolts.
- Secure the upper and lower body
Align the upper body with the main frame, pass the fasteners through the upper frame, and secure the assembly with two ⌀6*M5*16 shoulder screws, nine M4×25 button-head bolts, and one M4×16 button-head bolt.
- Install the top motor and gyroscope
Place the M8010 motor in the top yaw motor mount, then install the top yaw motor and gyroscope on the body using the specified M3.5×8, M3×6, and M4×16 button-head bolts.
- Mount the Raspberry Pi
Place the Raspberry Pi in its holder and secure it with four M2.5×8 button-head bolts; the interface diagram shows the Type-A port connected to the 485 module.
- Install communication and power modules
Solder the power wires before installing the USB-4X485 module and DCDC, and secure the modules with cable ties; the DCDC input is 5.5–60 V and requires 24 V, with a 5 V output.
- Secure the hardware assembly
Mount the assembled Raspberry Pi, USB-4X485, DCDC, and related hardware on the robot body and secure it with four M3×10 button-head bolts.
- Connect battery and system power
Route two positive and two negative battery-board leads through separate boat-switch contacts and the frame's lower cable holes; connect one group to the DCDC input and the other to upper motor 2, then connect the DCDC 5 V output to the Raspberry Pi power input.
- Connect the motor power wiring
Use upper motor 2 as the power input, connect it to hip motor 1 and then hip motor 0, and form a T-junction at hip motor 0 to power upper motors 0 and 1.
- Connect the UART4 motor bus
Connect the Raspberry Pi USB3.0 port to the USB-4X485 module through Type-A-to-Type-C; route the UART4 485A/B twisted pair to upper motor 2, then upper motor 1 and upper motor 0.
- Connect the UART3 hip-joint bus
Route the USB-4X485 module's UART3 485A/B twisted pair to hip motor 0 and then hip motor 1 to form the UART3 communication bus.
- Route Development Board Fan Power
Output 5 V from GPIO2 (5 V positive) and pin 14 (GND) to power the development board cooling fan.
- Complete Body Assembly
Confirm that the body components are fully assembled; cables are not shown and should follow the electrical connection section.
- Install Left Thigh Motors and Fans
Install two M8010 motors and two 3010 centrifugal fans in the left thigh as motors 0 and 1, connect the fan and motor wiring, and check the airflow direction; secure each motor with eight M3.5×8 socket-head bolts. The 3010 fan is 30×30×10 mm, 0.1 A, DC 24 V, 8000 RPM, with red positive and black negative connected to XT30U(2+2)-F.
- Install Left Thigh Side Cover
Connect the motor signal wires as illustrated, then fit the left thigh side cover. Ensure the protective wiring corrugated tube aligns without offset in the cover slots, and secure the cover with four M3.5×8 socket-head bolts.
- Install Left Calf Motor
Install one M8010 motor in the left calf body as left-leg motor 2, and secure it with five M3.5×8 socket-head bolts.
- Join Left Calf and Thigh
Mount the left calf assembly on the left thigh assembly and connect the left ankle motor power and signal wires according to the electrical connection section.
- Install Left Ankle Motor Cover
Fit the left ankle motor side cover, ensuring the protective wiring corrugated tube aligns without offset in the cover slots, and secure it with three M3.5×12 socket-head bolts.
- Assemble Left Foot Parts
Assemble the left foot outer section, sole, and inner section, and secure them with three M3×10 socket-head bolts.
- Install Robot Left Foot
Install the assembled left foot onto the left leg and secure it with six M4×16 socket-head bolts.
- Install Side-Swing Bearing
Install a bearing with a 6 mm inner diameter, 22 mm outer diameter, and 7 mm thickness into the bearing hole of the left side-swing connector.
- Join Side-Swing to Thigh Motor
Mount the left side-swing connector on the left thigh motor and secure it with four M4×16 socket-head bolts.
- Mount Left Leg Assembly
Mount the left leg assembly on the body using paired M5 locknuts, M5 washers, and Ø6×M5×55 shoulder screws. Place one set of flat needle bearings between the side-swing connector and the hip-joint motor fixing part.
- Mirror-Install Right Leg
Mirror-install the right leg in the opposite orientation to the left leg.
- Connect Right Leg Motor Power
Using the reserved cable route, connect upper-body motor 0 successively to right-leg motors 0, 1, and 2.
- Connect Left Leg Motor Power
Using the reserved cable route, connect upper-body motor 1 successively to left-leg motors 0, 1, and 2.
- Connect Raspberry Pi to 485 Adapter
Connect the Raspberry Pi USB 3.0 port to the 485 adapter using a Type-A to Type-C cable.
- Connect Left Leg UART2 Bus
Route the 485A/B twisted pair from adapter UART2 through left-leg motors 0, 1, and 2 to form USB bus UART2.
- Connect Right Leg UART1 Bus
Route the 485A/B twisted pair from adapter UART1 through right-leg motors 0, 1, and 2 to form USB bus UART1.
- Connect Leg Fan Power
Connect the leg cooling fan power to the leg motor XT30 2+2 power connection.
Calibrate and test
- Place Robot in Home Position
After the robot reaches the illustrated zero position, try placing it on a tabletop.
- Mark the motor zero positions
Position the robot as shown, turn each joint to its mechanical limit, and hold that position with an external force such as a person or tool, then record the motor zero positions.
Common problems
Parts
- 11 × Unitree 8010 motors: 10 drive the legs (5 per leg) and 1 in the neck is reserved for expansions (sold by Unitree)
- Raspberry Pi 4B 8GB (the default reference; other boards work) and a USB-to-4×RS‑485 module (sold by Unitree)
- Unitree Go1 battery and adapter assembly, TPS5450 5V buck module, KCD1 rocker switch, 22 × XT30U(2+2) connectors
- GY-91 attitude module (MPU9250 + BMP280)
- 4 × 3010 24V blower fans, 2 × 4010 5V fans
- 4 thrust needle bearings and 4 × 636ZZ deep-groove bearings, 2 stainless bushings, M3/M4/M5 heat-set nuts and M2.5–M5 socket screws
- Prints: mostly PLA for the body and thighs, PLA‑CF/PETG‑CF for the side links, ABS or PLA‑CF/PETG‑CF for the shanks, TPU for the soles
Tools
- 3D printer able to print carbon-filled filament and TPU (tree supports on)
- Soldering iron for the heat-set nuts, switch and power leads
- Hex drivers; the Go1 battery charging dock is taken apart so its contact board can go into the printed battery bay
Skills
- Wiring 4 RS‑485 buses and XT30 power from the motor system diagram
- Zero calibration: turn each joint to its mechanical limit and record the motor zero
- RL training: RoboTamer4Qmini (Isaac Gym and PPO, needing Ubuntu 18.04/20.04 and an NVIDIA GPU with at least 8 GB)
- C++ deployment: RoboTamerSdk4Qmini (ONNX Runtime, built on unitree_sdk2 and unitree_actuator_sdk)
Software
- RoboTamer4Qmini v1.0: PPO training in Isaac Gym with domain randomisation and random pushes, exporting ONNX (MIT, no longer maintained)
- RoboTamerSdk4Qmini v1.0: C++ real-robot deployment with ONNX Runtime inference (MIT, no longer maintained)
- Qmini repo: URDF model and STEP files (v1.0 and v2.0)