Open Source RoboticsRobots, software & learning

Upkie

Robot / hardware build

Wheeled biped with four leg servos, two driven wheels and a Raspberry Pi control stack; the reviewed build guide needs revision matching. [1]

Build & first use →Official websiteUpstream build guide

For
Robotics researchers and builders comfortable with actuator setup and printed mechanical assemblies [1]
Cost
No current cost or bill of materials established yet.
Source rights
Some licenses are unresolved. Review licenses
Unknowns
operating system not fully established. Review gaps

Source researched · Not tested by us
Sources checked · Research details

Upstream photograph of an Upkie wheeled biped build.
Upstream photograph of an Upkie wheeled biped build. Stéphane Caron and Upkie contributors · Apache-2.0. Original image unchanged; displayed responsively.
Licenses & related hardware
Ecosystem
Raspberry Pi
License
Apache-2.0 · license not fully assessed for electronics · Details by part

Requirements · Research details and dates

On this page

Overview

Upkie is a wheeled biped: four leg servos change its posture while two driven wheels balance and move it. The v12.0.0 software offers Python and C++ development, with a Raspberry Pi on the robot and PyBullet examples for a first simulation trial. The reviewed BOM specifies four qdd100 servos, two moteus wheel-actuator kits and a Raspberry Pi 4 with pi3hat. [1] [2] [5]

Is this for you?

Known limitations
  • The 12.0.0 printing guide links an older parts layout; latest parts are not an established drop-in replacement
  • Assembly text gives opposing USB-side orientations for the head plate
  • Electronics guide names bus 3 for the right leg but its command maps that leg to bus 2
  • Full current delivered build price and physical reproduction are unverified

Direct source comparison; no replacement wiring or orientation is asserted.

[6] [7] [8] [13] · Editorial assessment

3D preview

Upkie wheeled-biped simulation assembly. The source wheeled-biped description at zero joint positions, without the optional camera variant. Mesh attribution and upstream adaptations are retained; physical fit and control behavior are not verified.

The 3D preview loads after the page.

Drag to orbit · Scroll or pinch to zoom · Right-drag to pan. Use the view buttons for front, side and top views. The tree shows names supplied by the source; unnamed bodies remain labeled as such.

Download original URDF source bundle (ZIP) · File checksums and provenance

Separate bodies can be inspected in the model tree. Explode is a viewing aid, not an assembly sequence.

Source, license and scale

Source: Upkie contributors; mjbots; wheel tire adapted from bramesh501, revision 94735fbe6137276a41de0ff4cc04d2e533fa9e33. Original and preview: Apache-2.0 / CC-BY-4.0. Preview conversion by Open Source Robotics; source files unchanged inside the downloadable bundle. Preview coordinates are centered and rounded to six decimal places. URDF visual origins, mesh scales and joint transforms applied at zero joint positions, then metres converted to millimetres. No physical part tested.

Viewer: three-cad-viewer 5.0.7 (MIT license). Confirm scale and manufacturing settings before printing.

What you need

Host computer

Onboard Raspberry Pi 4; separate development computer for building and uploading the control software.

[5] [9]

Tools
  • FDM printer
  • Screwdrivers and hex tools
  • Soldering and heat-set insert equipment
  • Cable crimping and heat-shrink tools

Tool needs derived from the documented printing, connector and insert steps.

[5] [6] [7] · Editorial assessment

Hardware & parts

Hardware configuration

Upkie software v12.0.0 with its 12.0.0 build documentation and linked legacy parts commit 8e539b825affe10ad872741564bdc1c19f4df965; not the newer parts v2.0.0 layout.

[1] [2] [6] [11] [13]

Actuators
  • Four mjbots qdd100 servos (beta 2+) for hip/knee joints
  • Two moteus developer kits (r4.11+) for wheel actuation

[5] [7]

Controller

Raspberry Pi 4 Model B with mjbots pi3hat r4.4b+ and power distribution r4.3b+.

[5]

Power

RYOBI 18 V compatible battery, battery-contact springs and XT90-S connection in the reviewed BOM.

[5]

Assembly & first use

Open the upstream getting-started guide [1] · Project documentation [6] [8]

  • Start with the release’s PyBullet joystick or balancing example
  • Choose the parts revision matching the 12.0.0 print guide
  • Configure the Raspberry Pi and test actuator communications on the bench
  • Resolve the guide’s bus/orientation inconsistencies before physical assembly and calibration
  • Build/upload the control spine and keep the documented gamepad stop available for a hardware trial

Editorial order based on documented workflow and unresolved source discrepancies.

[1] [6] [7] [8] [9] [10] · Editorial assessment

Assembly

Print and fit the selected legacy parts, assemble torso and leg mechanisms, route separate power/CAN chains, then reconcile head-plate orientation and bus mapping before applying the hardware setup instructions.

[6] [7] [8]

Calibration

Guide describes actuator IDs 1–6, servo limits, straight-leg hard zeroing and later soft rezero. These routines have not been reproduced here.

[7] [8] [9]

Cost

No current, complete configuration-specific build cost has been established for this profile.

Project notes

Start with simulation, then choose the physical build

The release README documents a joystick example through Pixi or uv, plus Gymnasium environments for balancing. That is a useful first step before buying the actuator set. The hardware route adds printed parts, an 18 V compatible battery, power distribution, CAN/power cables, RC wheels and a gamepad. No complete current delivered cost is established by this review. [1] [5]

The 12.0.0 printing guide links parts commit 8e539b8, which we preserved with its license. It describes a torso assembled from separate plates and covers, and leg pieces including femur, tibia, knee and ankle. The newer parts repository instead documents a case, lower/upper legs and a different wheel-hub layout. Treat these as different source configurations; do not assume the newest files match the older assembly instructions. [6] [11] [12] [13]

Resolve two guide inconsistencies before assembling

The assembly page says the Raspberry Pi USB side faces the robot's right during the head-plate step, then says left in the later head-assembly step. The same page explains that orientation affects the IMU frame and cable fit. We have not resolved which instruction matches the selected physical configuration. [8]

The electronics page describes the right leg on bus 3, yet its example command maps that leg to bus 2. Its terminator paragraph also repeats CAN_H for both connector positions. These are reasons to reconcile the guide with the selected board documentation and configuration before wiring, rather than copying the command or connector text as a verified procedure. [7]

The documented calibration sequence assigns servo IDs, configures limits, performs straight-leg hard zeroing and later uses soft rezero. Printing also involves PETG, heat-set inserts and wheel-hub fitting; the guide notes that a tight hub fit may require iterations. None of this has been physically reproduced here. [5] [6] [7] [8] [9]

What the preserved sources cover

Both the reviewed Upkie software and linked legacy parts repository carry Apache-2.0 licenses. Purchased mjbots boards/actuators, their exact firmware and externally linked assembly files need separate revision and license checks before treating the collection as a complete manufacturing pack. This profile provides a source map and identifies build blockers; it is not a tested build guide. [3] [5] [11] [12]

What we checked

Source research only; no installation, physical build or performance test performed. No affiliate links added.

Not yet established

  • Requirements: operating system

Updates

Upstream last updated
Jul 12, 2026 [2]
Latest release
Jul 12, 2026 [2]
Profile updated
Oct 25, 2026
Sources last checked
Sep 30, 2026
Next review
Oct 30, 2026
Reviewed revision
3f6980f8a1ba7399a6c739113123bafe4cbc39e9 (release v12.0.0) · combined hardware and software repository

Source files and licenses

Available project sources support research coverage; complete build and commercial qualification remain separate.

LayerAvailability / license
mechanical designavailable · Apache-2.0
Exact legacy repository linked by the 12.0.0 printing guide; root license inspected. External assembly downloads and purchased actuators have separate scope. [11] [12]
electronicsavailable · License not fully assessed
System wiring/testing instructions and purchased-board BOM; not a complete board-manufacturing artifact or a resolved license for all electronics. [5] [7]
firmwarenot found · License not fully assessed
mjbots actuator firmware is external; no exact installed firmware revision and artifact-license match established for this profile. [1] [5] [7]
softwareavailable · Apache-2.0
Upkie repository license; independent dependencies retain their own terms. [1] [3]
documentationavailable · Apache-2.0
Repository documentation license. Linked website guide is separately captured for evidence; no media reused. [1] [3]

This profile selects the documented balancing/control route, not a trained policy or training dataset.

References

Each source links to the exact revision we read. “Used for” shows where this page relies on it.

Project sources

Videos

  • S014 Upkie wheeled bipeds (YouTube channel)
    The project’s own YouTube channel, linked from the project’s own documentation. Not reviewed by us for accuracy.
    Revision, date & where cited

    YouTube channel Upkie wheeled bipeds · youtube.com · Accessed Oct 4, 2026

  • S015 Reinforcement learning for Upkie wheeled bipeds (YouTube video)
    Video from the project’s own channel (Upkie wheeled bipeds), linked from the project’s own documentation. Not reviewed by us for accuracy.
    Revision, date & where cited

    YouTube video Upkie wheeled bipeds · youtube.com · Accessed Oct 4, 2026

Correction guidance · Discussion is not enabled · Profile format 0.5.0-draft.1

Change history

2026-10-04 — Added 2 YouTube reference(s) (S014, S015): official channel or videos linked from the pinned upstream sources. Existing claims, source-check dates and evidence are unchanged.

2026-10-25 — Added an attributed upstream image with linked reuse terms; technical evidence dates unchanged.