Connecting to sources…

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

  • No response after wiring; battery shows no voltage #9
  • IMU model conflicts with documented serial and I²C interfaces #3
  • README links to STEP files using an incorrect path #6
  • Body-part fabrication files are missing #8

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)

Documents