Open Source RoboticsRobots, software & learning

Kayra

Robot / hardware build

Printable humanoid with FreeCAD sources, a Servo 2040 control route and MuJoCo examples; power selection and several servo mappings remain unresolved. [1]

Build & first use →Official website

For
Builders comfortable with servo calibration, printed mechanisms and Python/MicroPython [1]
Cost
No current cost or bill of materials established yet.
Source rights
Some licenses are unresolved. Review licenses
Unknowns
tools, operating system not fully established. Review gaps

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

Licenses & related hardware
License
BSD-3-Clause · license not fully assessed for electronics · Details by part

Requirements · Research details and dates

On this page

Overview

Kayra is a printable humanoid project with FreeCAD design files, STL parts, Python host tools, controller scripts and MuJoCo examples. The root README mixes project goals with descriptions of available work. This profile covers the documented Servo 2040 body-control route; it does not treat toddler-speed walking or easy assembly as validated outcomes. [1] [4] [5] [6]

Is this for you?

Known limitations
  • Exact servo model, voltage and battery are not finalized in the wiring document
  • Arm and pelvis mappings are flagged unverified; limits are derived from poses rather than measured
  • Controller runs without enforcing servo limits if servoMap.json is absent
  • Simulation examples do not establish physical walking performance

Source qualifications and distinction between model and physical testing.

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

3D preview

Kayra lower-body simulation model. The official Kayra lower-body MuJoCo model at its supplied reference pose, including the source body tree and closed-loop leg placement. Arms, head, electronics and the scene are absent. The physical scale of the simulation has not been independently verified, and this is not manufacturing CAD or a tested build.

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 MJCF 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: Ramin Assadollahi / Kayra contributors, revision 100f3b7b447109989253179a5547fc84471deaa4. Original and preview: BSD-3-Clause. Preview conversion by Open Source Robotics; source files unchanged inside the downloadable bundle. Preview coordinates are centered and rounded to six decimal places. Source visual shapes and body transforms evaluated at the reference pose by MuJoCo, 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

Linux host running Python pose/animation tools; MicroPython body-controller software.

[1] [6]

Dependencies
  • Host Python environment and serial access
  • Pimoroni Servo 2040 firmware environment
  • Optional MuJoCo with model XML and relative STL paths

[6] [7]

Hardware & parts

Hardware configuration

3D-printable humanoid with articulated servo-driven limbs.

[1]

Actuators
  • ServoCluster supports an 18-channel command vector; channels 14/15 are unused in the documented map

Channel capacity is not a verified count of independent mechanical degrees of freedom. Exact selected servo model remains unspecified.

[5] [6]

Controller

Pimoroni Servo 2040 for the selected body-control route, communicating with host Python over USB serial.

[5] [6]

Sensors
  • BNO055 IMU connected through I2C in the documented body setup

[5]

Power

Wiring document assumes a Servo 2040 whose USB/external-power linking trace has already been cut, with separate servo and 5 V logic supplies; exact servos, voltage and battery remain unspecified in the wiring document.

[5]

Assembly & first use

Project documentation [1]

  • Select a matched printed mechanism and servo/controller configuration
  • Inspect servoConfig.json, servoControl.json and servoMap.json together
  • Use the documented host environment and serial connection
  • Resolve power-board modification and servo limits for the actual build
  • Explore MuJoCo models separately from physical calibration

Editorial sequence; not performed on hardware.

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

Calibration

servoMap.json maps channels, joints and limits. Arm/pelvis mappings and mechanical limits remain unverified in the documented configuration.

[5] [6]

Cost

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

Project notes

Three configuration files belong together

The host, controller and simulation use an 18-value servo vector. The documented map assigns leg channels first, then arms, pelvis and head, with channels 14 and 15 unused. This is a software interface, not evidence of 18 independently verified mechanical degrees of freedom. Arm and pelvis assignments are explicitly unverified, and limits are derived from stored poses plus a margin rather than measured mechanical stops. [5] [6]

The controller expects servoConfig.json, servoControl.json and servoMap.json. The documentation says it still runs when the map is missing but does not enforce servo limits. Its identification tool can move individual channels and deliberately bypasses software limits. These details make configuration and physical calibration substantive work, rather than a file-copy step that proves the mechanism is ready. No servo was moved or calibrated in this review. [6]

The wiring instructions assume a modified board

The wiring page describes a Servo 2040 with its USB/external-power linking trace already cut. In that configuration, the servo supply does not power the controller logic, so the documented untethered setup has a separate 5 V logic supply. Do not assume these instructions describe an untouched board. The same page still leaves the exact servo model, operating voltage, battery and mounting/charging procedure unfinished. This review does not substitute a power recommendation for those missing choices. [5]

The documented host route uses Python on Linux and USB serial; the body uses MicroPython controller code and a BNO055 IMU. Stored poses can run untethered through the user button, while the host pose editor sends commands over serial. That is a concrete control workflow, but its presence is not a tested balancing or locomotion result. [5] [6]

Use simulation as a separate development surface

The MuJoCo directory contains XML models that reference repository STL files and discusses the closed-loop geometry of the leg mechanism. The software guide gives separate host and simulation requirements. Model exploration can help inspect geometry and control interfaces, but this publication has not installed the environment or compared simulated motion with a physical Kayra. [6] [7]

The repository carries BSD-3-Clause. That license is recorded for its design and software sources; it does not replace the terms of purchased electronics, board firmware or independent dependencies. No complete current build budget, manufacturing validation or physical performance result is claimed here. [3] [4] [5]

What we checked

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

Not yet established

  • Requirements: operating system, tools

Updates

Upstream last updated
Sep 13, 2026 [2]
Latest release
Not established
Profile updated
Oct 4, 2026
Sources last checked
Sep 30, 2026
Next review
Oct 30, 2026
Reviewed revision
100f3b7b447109989253179a5547fc84471deaa4 (commit snapshot; no published stable release found) · 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 · BSD-3-Clause
Root repository license; third-party boards, dependencies and assets retain separate terms. [1] [3] [4]
electronicsavailable · License not fully assessed
Integration wiring for purchased boards; not a complete board-manufacturing design or blanket component license. [5]
firmwareavailable · BSD-3-Clause
Repository controller scripts; board firmware and third-party libraries need separate matching. [3] [6]
softwareavailable · BSD-3-Clause
Root repository license; third-party boards, dependencies and assets retain separate terms. [1] [3] [4]
documentationavailable · BSD-3-Clause
Root repository license; third-party boards, dependencies and assets retain separate terms. [1] [3] [4]

This profile selects pose/servo control and physical simulation, not a trained policy or dataset.

References

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

Project sources

Videos

  • S008 open source humanoid Kayra getting simulated (YouTube video)
    Video from the project’s own channel (Ramin Assadollahi), linked from the project’s own documentation. Not reviewed by us for accuracy.
    Revision, date & where cited

    YouTube video Ramin Assadollahi · youtube.com · Accessed Oct 4, 2026

  • S009 Kayra walking four steps! (YouTube video)
    Video from the project’s own channel (Ramin Assadollahi), linked from the project’s own documentation. Not reviewed by us for accuracy.
    Revision, date & where cited

    YouTube video Ramin Assadollahi · youtube.com · Accessed Oct 4, 2026

  • S010 Open source humanoid Kayra taking her first steps! (YouTube video)
    Video from the project’s own channel (Ramin Assadollahi), linked from the project’s own documentation. Not reviewed by us for accuracy.
    Revision, date & where cited

    YouTube video Ramin Assadollahi · youtube.com · Accessed Oct 4, 2026

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

Change history

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