Connecting to sources…

How to build LeRobot Humanoid biped platform (Hugging Face's open low-cost humanoid): the whole process

114 steps to build LeRobot Humanoid biped platform (Hugging Face's open low-cost humanoid), from buying parts, printing and assembly to software, calibration and trainin…

No assembled robot or kit is sold. The hardware README's cost estimate (biped platform, 2026-04-30, US dollars, indicative and vendor-dependent): $2,579.84 of bought parts plus about 3.5 kg of PLA+ filament at $56.00, about $2,635.84 in all; shipping, import duties and local taxes are excluded, EUR prices are converted at 1 EUR = 1.1691 USD (2026-05-05) and fasteners use bulk-piece prices. The 12 motors dominate: RobStride O3 at $225 each ($900), O5 at $110 ($440), O2 at $145 ($290) and O0 at $125 ($250); the Raspberry Pi 5 is $130, the IMU $64, the CAN-FD adapter $59 and the 8 ball-joint rod ends $167.44. The release post puts it at around $2,500 in parts, depending on sourcing, shipping and taxes. The 3D printer and tools are not included (only a 2.5 mm hex key is listed)

Bill of materials · Torso

PartQty
torso/torso_can_holder.stl1
torso/torso_imu_holder.stl1
torso/torso_torso13.stl1
torso/torso_torso23.stl1
torso/torso_torso33.stl1
torso/torso_upper_torso_22.stl1
torso/torso_upper_torso_12.stl1
RobStride O0 · actuator · 22
M2 screw · M2 x 5 cyl head · 44
M2.5 screw · M2.5 x 20 cyl head · 99
M3 screw · M3 x 8 cyl head · 1212
M4 screw · M4 x 20 cyl head · 1616
M5 screw · M5 x 10 cyl head · 55
M3 screw · M3 x 35 cyl head · 44
Bearing · 35x72x17 · 22

Bill of materials · Hips

PartQty
left_leg/hipz/hip_z_hipz12_sym.stl1
left_leg/hipz/hip_z_hipz22_sym.stl1
right_leg/hipz/hip_z_hipz12.stl1
right_leg/hipz/hip_z_hipz22.stl1
left_leg/hipx/hipx_2_hipxy_sym.stl1
right_leg/hipx/hipx_2_hipxy.stl1

Buy parts

  • Source the male inter-cable connector

    The visual catalog identifies this as the male inter-cable connector. XH-2A / XH-2Y are the commercial references for inter-cable connection.

  • Source the female inter-cable connector

    The visual catalog identifies this as the female inter-cable connector. XH-2A / XH-2Y are the commercial references for inter-cable connection.

  • Source the RobStride O3 connector

    Source the connector shown for the O3 side of a RobStride motor connector. This catalog identifies the O3-side connector separately from other RobStride models.

  • Source the other RobStride connector

    Source the RobStride connector used with the other RobStride models on this robot. The catalog distinguishes it from the O3-side connector.

  • Source the XT30 power connector

    XT30 is used to connect to the power source. Its yellow power connector body is visible in the connector photos above.

  • Select the bipedal hardware target

    The bipedal platform is the current version used for bring-up, calibration, data collection, identification, and early locomotion experiments.

  • Consult the hardware bill of materials

    The lerobot-humanoid-hardware repository contains the bill of materials for the robot.

Print and make

  • Choose the Bambu Lab H2D printer

    Use the Bambu Lab H2D as the printer baseline for all robot printed parts.

  • Use PLA+ print material

    Use PLA+ as the material baseline for all robot printed parts.

  • Set the print parameters

    Set 30% infill, 4 wall lines, 0.15 mm layer height, gyroid infill pattern, and a 0.2 mm nozzle.

  • Orient structural parts for loading

    Orient structural prints so the layer lines do not carry the main tensile load.

  • Inspect orientation reference photos

    Inspect layer-line direction and final part pose in thigh_detail.jpg, knee_detail.jpg, and the three knee_mechanism_view photos.

  • Review the H2D profile mapping

    Use docs/manufacturing/h2d_profiles/README.md for a quick mapping of the H2D reference project files.

  • Print the shin tibia part

    Use shin_tibias_example.3mf as the H2D reference project file for the shin tibia part and inspect shin_tibias_print_example.png for the print result.

  • Print the thigh femur part

    Use thigh_femur_example.3mf as the H2D reference project file for the thigh femur part and inspect thigh_print_example.png for the print result.

  • Print the hip part

    Use hip_example.3mf as the H2D reference project file for the hip part and inspect hip_print_example.png for the print result.

  • Print other parts and verify orientation

    Other parts usually have one obvious safe print orientation; if not, verify it with Onshape and mounted assembly photos.

  • Print the torso

    Print the torso subassembly.

  • Print hipz

    Print the hipz subassembly using 100% infill. Reference project files are `docs/manufacturing/h2d_profiles/hip_example.3mf` and `docs/manufacturing/h2d_profiles/hip_print_example.png`.

  • Print hipx

    Print the hipx subassembly using 100% infill.

  • Print the thigh

    Print the thigh subassembly. For the large thigh part, print it on its side, not on its front face. Reference project files are `docs/manufacturing/h2d_profiles/thigh_femur_example.3mf` and `docs/manufacturing/h2d_profiles/thigh_print_example.png`.

  • Print the knee mechanism

    Print the knee_mechanism subassembly.

  • Print the shin

    Print the shin subassembly. Reference project files are `docs/manufacturing/h2d_profiles/shin_tibias_example.3mf` and `docs/manufacturing/h2d_profiles/shin_tibias_print_example.png`.

  • Print the ankle mechanism

    Print the ankle_mechanism subassembly.

  • Print the ankle

    Print the ankle subassembly.

  • Print the foot

    Print the foot subassembly.

  • Find the printable parts

    The lerobot-humanoid-hardware repository contains the robot's printable parts.

  • Check Spacer Print Coverage

    Check the spacer STL lists in each relevant subassembly section. Spacer subassemblies are `shin`, `ankle_mechanism`, `ankle`, and `foot`; non-spacer subassemblies are `torso`, `hipx`, `hipz`, `thigh`, and `knee_mechanism`.

Assemble

  • Prepare Three Leg Sub-Cables

    Prepare shin, thigh, and hip pass-through sub-cables using `hardware/electronics/cabling/README.md`.

  • Install the Shin Sub-Cable

    Install the shin sub-cable during `shin` assembly, before final closure.

  • Install the Thigh Sub-Cable

    Install the thigh sub-cable during `thigh` assembly, before final tightening.

  • Route the Hip Pass-Through Sub-Cable

    Route the hip pass-through sub-cable during `hipz` integration.

  • Join Leg Cables to Torso Harness

    Join the leg cables to the torso harness during final leg-to-torso integration.

  • Confirm Torso Motor Support Direction

    Align the ports on both motors toward the inside of the robot, with one inner screw hole aligned with the slot in torso13.

  • Install the Torso RobStride Motors

    Place the two RobStride O0 motors into torso_torso23 and torso_torso33. Secure each support with six M3x8 screws.

  • Insert the Torso Bearings

    Insert two 35x72x17 bearings into the slots on torso_13.stl.

  • Assemble the Lower Torso Supports

    Place each motor-support subassembly on the bearing stack and secure them with eight M4x20 screws. Keep the motor cables facing inward.

  • Attach the CAN Bus Holder

    Attach the CAN bus holder to the bottom of the assembly without screws. The part extending from the base fits into the lower assembly's groove.

  • Secure the Torso CAN Bus

    Place the CAN bus on the holder and secure it with torso_can_holder_2.stl and four M3x35 screws.

  • Connect upper torso pieces

    Use five M5x10 screws to connect torso_upper_torso_22 with torso_upper_torso_12. Loosely insert the two end screws because they will be tightened in the next step.

  • Join upper and lower torso

    Place the upper assembly onto the lower assembly, then tighten the screws at the end of the upper assembly.

  • Attach Raspberry Pi and IMU

    Attach the Raspberry Pi with its IMU holder to the top of the upper assembly using four M2.5x20 screws. Do not overtighten, because there is no extra space under the Raspberry Pi and the board can be damaged.

  • Secure the IMU

    Attach the IMU to the top of the IMU holder using four M2x5 screws. Solder the IMU pins so that they protrude from the front of the board.

  • Install hip-z bearings

    Insert the 35x72x17 bearings into hip_z_hipz22 and hip_z_hipz22_sym.

  • Insert hip-z motors

    Insert the RobStride O2 motors into hip_z_hipz12 and hip_z_hipz12_sym. Double-check which hip piece receives each motor before insertion.

  • Fasten motors to hip pieces

    Use nine M3x10 screws to attach the RobStride O2 motor to hipz12 and hipz12_sym, respectively.

  • Align hip pieces with motors

    Use three M3x10 screws and three pins to attach hip_z_hipz12 and hip_z_hipz12_sym to motors 1 and 7, respectively. Confirm hole alignment before insertion because the motor is difficult to rotate or remove afterward; a 13 cm hex key was used successfully.

  • Route hip pass-through cable

    Route the hip pass-through sub-cable through hipz according to `hardware/electronics/cabling/README.md`.

  • Complete paired hip-z joints

    Attach hipz22 and hipz22_sym to hipz12 and hipz12_sym. Secure them with four M4x45 screws on the lower side and six M4x40 screws on the top side.

  • Install hip-x components

    Insert hipx_2_hipxy and hipx_2_hipxy_sym into their respective points on the completed hip-z assemblies. Mount each to a RobStride O2 motor using six M4x12 screws.

  • Insert the hip bearing

    Press one 15x21x4 bearing into the joint hole on `hipxy`. WD-40 may be applied to the bearing slot, followed by gentle tapping with the flat side of a hammer.

  • Insert femur_22

    Insert `femur_22` into the bearing and `hipxy`.

  • Attach the femur joint hat

    Use three M2.5 x 6 screws to attach `femur_hat_small_1` to `femur_22` over the bearing, holding the piece in place.

  • Adjust the motor rear screws

    Adjust the rear screws on every RobStride O3 motor used in this subassembly: remove two screws beside one data/power port and place them in the blank spaces on the opposite side of the motor.

  • Mount the upper femur motor

    Push RobStride O3 ID 3 into `femur_12`; use ID 9 on the left leg. Align the holes without screws with the openings in `femur_12` and secure the motor with four M4 x 10 screws.

  • Join the femur to the hip

    Attach `femur_12` to `hip_xy` using six M4 x 20 screws. Align `femur_22` with `femur_12` so that they fit flush together.

  • Install and route the thigh cable

    Install and route the thigh sub-cable before final closing, following `hardware/electronics/cabling/README.md`.

  • Join the two femur sections

    Attach `femur_12` to `femur_22` using four M4 x 30 screws near the top motor and two M4 x 16 screws at the lower portion. If the lower holes are loose, two M4 threaded heat inserts may be added to both legs.

  • Mount the second femur motor

    Insert the second RobStride O3 motor, ID 4 or 10, into the femur and secure it with eight M4 x 10 screws, four on both sides. Adjust the motor screws now if this was not done earlier.

  • Repeat for Both Feet

    Follow all Foot and Ankle assembly steps for both feet.

  • Install Front Spherical Joints

    Attach two spherical joints between the notches at the front of each foot. Place a 5x6x3 spacer on both sides of each spherical joint, secure with two 5x20 shoulder screws, and secure each shoulder screw with an M4 nut.

  • Seat Rear Bearings

    Place two 5x16x5 bearings into the grooves at the back of each foot and apply firm, even pressure to seat them.

  • Build the Ankle Joint

    Place the u-joint between the rear bearings with a u-joint spacer on both sides. Secure it with a 5x40 shoulder screw and M4 nut, then attach foot_hat_small over the rear bearing and secure it with three M2.5x8 screws.

  • Add Knee Actuator Bearings

    Place a 15x21x4 bearing on either side of the knee actuator.

  • Attach and Align Knee Rods

    Attach knee_rod12 and knee_rod22 to the knee actuator, align them, and secure them with three M3x18 screws. Confirm the orientation so the mechanism moves the tibia from the femur without colliding with other robot parts.

  • Set Aside Knee Subassembly

    Set the completed knee subassembly aside; it will be used at the end of the next step.

  • Install Tibia Bearings and Pins

    Insert two 15x21x4 bearings into each tibia and place one pin at the top and one at the bottom. The fit is very tight; apply WD-40 and gently tap them in, and repair cracked slots with a soldering iron if necessary.

  • Attach the Tibia Motors

    Attach the RobStride o5 motors so their cables exit the front of the tibia, the side without the top bearing. Check that the rear openings of both tibia halves align, then secure them with eight M3x10 screws.

Software

  • Open the main repository overview

    Start with the main lerobot-humanoid repository to obtain an overview of the full stack.

  • Open the runtime repository

    Use lerobot-humanoid-runtime when working on robot control and deployment.

Calibrate and test

  • Power Controller Logic Rails Only

    Power only the controller logic rails for the first test.

  • Set Current Limit to 2 A

    Set the bench supply current limit to `2 A`; no motion capability is expected in this phase.

  • Confirm Maximum Idle Current

    Confirm that the expected idle current is around `1 A` maximum.

  • Stop if Current Exceeds Limit

    If current rises above `2 A`, stop immediately and re-check the wiring before continuing.

  • Confirm All Node Communications

    Confirm communication with every controller node.

  • Verify Watchdog and Heartbeat

    Verify the watchdog and heartbeat behavior.

  • Set Low Current and Torque Limits

    Set low current and torque limits before the actuator power test.

  • Enable One Actuator at a Time

    Enable one actuator at a time.

  • Verify Direction and Encoder Consistency

    Verify the sign or direction and the consistency of the encoder readings.

  • Disable Immediately on Unexpected Motion

    Disable the actuator immediately if unexpected motion occurs.

  • Execute Tiny Motions Around Neutral

    Execute tiny motion commands around the neutral position.

  • Confirm Software Limits Are Enforced

    Confirm that the software limits are enforced.

  • Stop on Heating, Smell, Noise, or Oscillation

    Stop if unexpected heating, smell, noise, or oscillation occurs.

  • Stop on Load Communication Instability

    Stop if communication becomes unstable under load.

  • Stop on Any Limit or Safety Mismatch

    Stop if any limit or safety mismatch is found.

  • Calibrate the robot before controller deployment

    Complete calibration before deploying learned controllers on the real robot.

  • Run robot safety checks

    Run safety checks before deploying learned controllers on the real robot.

  • Test with low controller gain

    Perform low-gain testing before deploying learned controllers on the real robot.

  • Ensure a reliable power cutoff

    Have a reliable power cutoff ready before deploying learned controllers.

  • Use the runtime robot tools

    The runtime provides tools for calibration, state reading, command sending, and safety checks.

  • Check Torso Motor Rotation

    Verify that both torso motor outputs rotate freely after tightening.

  • Check hip free motion

    Verify that the hips move freely. Slight clicking may occur between the long piece extending from hipz12 or hipz12_sym and the notch at the bottom of the lower torso. The upper assembly of the leg robot is complete at this point.

  • Check Ankle Movement

    After tightening, verify that the ankle moves freely.

Data and training

  • Run a learned policy on the real robot

    An early sim-to-real standing policy is shown running on the bipedal platform.

  • Replay datasets and fit simulator parameters

    The lerobot-humanoid-identification repository provides tools to replay real datasets in simulation and fit simulator parameters.

  • Train policies in MJLab environments

    The lerobot-legged-zoo provides MJLab training environments for LeRobot Humanoid and other legged robots.

  • Log Offsets and Runtime Notes

    Log the observed offsets and runtime notes for later integration in `lerobot_humanoid_runtime`.

Parts

  • 12 RobStride joint motors: 2 O0 in the torso, 2 O2 at hip z, 4 O3 in the thighs, 4 O5 in the shins
  • Raspberry Pi 5, a BNO055 or BNO085 IMU, and a SAVVYCANFD two-channel USB CAN-FD adapter (the README says it is the only adapter proven so far with the RobStride CAN protocol)
  • Bearings: 4 × 35×72×17, 14 × 15×21×4 and 8 × 5×16×5; 8 Norelem 27628 ball-joint rod ends (for the ankle linkages) and 12 Norelem 07534 shoulder screws
  • 75 printed parts from about 3.5 kg of PLA+ (target 3–4 kg); the hip z and hip x parts use 100% infill
  • 5 m red and black power cables and two colours of communication cable, an XT30 main power connector and XH inter-cable connectors; a few hundred M2–M5 screws, M4 nuts, M3 heat-set inserts and dowel pins

Tools

  • A 3D printer: the baseline is a Bambu Lab H2D with a 0.2 mm nozzle, PLA+, 30% gyroid infill, 4 walls and 0.15 mm layers
  • A 2.5 mm hex key (in the BOM), a press or gentle hammer for the bearings, and a metal drill bit for reaming tight fits at low speed
  • A current-limited bench supply (2 A limit for first power-on) and a physical power cutoff within reach
  • Training policies needs a CUDA-capable GPU (lerobot-legged-zoo README)

Skills

  • Commissioning every motor before assembly with the commission_motor.py wizard: detect protocol and ID, switch to the MIT protocol, assign the ID and run a motion check
  • Making the shin, thigh and hip sub-cables for each leg, then wiring checks and staged power-on
  • Fitting motors and bearings in the Onshape assembly orientation, with about 5 N·m on plastic threads
  • Linux, Python and uv; zeroing and IMU calibration, MuJoCo simulation and reinforcement-learning training with MJLab

Software

  • lerobot-humanoid-runtime: MuJoCo simulation and real-robot control (CAN MIT protocol with safety checks), ONNX/Torch policy runner, IMU backends, gamepad commands, LeRobot integration and calibration tools (Apache-2.0)
  • lerobot-humanoid-identification: replays real-robot data in MJWarp and fits simulator parameters with CMA-ES (Apache-2.0)
  • lerobot-humanoid-model (MJCF/URDF models) and lerobot-humanoid-design (URDF and optimal-control co-design), both Apache-2.0
  • lerobot-legged-zoo: MJLab training environments with no pretrained policies (no declared licence)

Documents