Kayra
Robot / hardware buildPrintable 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
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.
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.
Model sources
The preview uses the linked original design. Source grouping is retained where present; the caption identifies whether this is an assembly or one component.
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
Hardware & parts
- Hardware configuration
3D-printable humanoid with articulated servo-driven limbs.
- 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.
- Controller
Pimoroni Servo 2040 for the selected body-control route, communicating with host Python over USB serial.
- Sensors
- BNO055 IMU connected through I2C in the documented body setup
- 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.
Assembly & first use
- 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.
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.
| Layer | Availability / license |
|---|---|
| mechanical design | available · BSD-3-Clause Root repository license; third-party boards, dependencies and assets retain separate terms. [1] [3] [4] |
| electronics | available · License not fully assessed Integration wiring for purchased boards; not a complete board-manufacturing design or blanket component license. [5] |
| firmware | available · BSD-3-Clause Repository controller scripts; board firmware and third-party libraries need separate matching. [3] [6] |
| software | available · BSD-3-Clause Root repository license; third-party boards, dependencies and assets retain separate terms. [1] [3] [4] |
| documentation | available · 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
- S001 assadollahi/kayra: README.md
Revision, date & where cited
github.com · revision
100f3b7· Accessed Sep 30, 2026
Used for: Overview, What you need, Hardware & parts, Assembly & first use and 1 more - S002 assadollahi/kayra: commit 100f3b7
- S003 assadollahi/kayra: LICENSE
Revision, date & where cited
github.com · revision
100f3b7· Accessed Sep 30, 2026
Used for: Use simulation as a separate development surface, Source files and licenses - S004 assadollahi/kayra: files
Revision, date & where cited
github.com · revision
100f3b7· archive file inventory · Accessed Sep 30, 2026
Used for: Overview, Use simulation as a separate development surface, Source files and licenses - S005 Pinned Kayra: WIRING.md
Revision, date & where cited
github.com · revision
100f3b7· Accessed Sep 30, 2026
Used for: Overview, Is this for you?, Hardware & parts, Assembly & first use and 4 more - S006 Pinned Kayra: software/README.md
Revision, date & where cited
github.com · revision
100f3b7· Accessed Sep 30, 2026
Used for: Overview, Is this for you?, What you need, Hardware & parts and 5 more - S007 Pinned Kayra: mujoco/readme.md
Revision, date & where cited
github.com · revision
100f3b7· Accessed Sep 30, 2026
Used for: Is this for you?, What you need, Assembly & first use, Use simulation as a separate development surface
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.