Humanoid SDK

Version: 0.1 Draft

The Humanoid SDK defines a proposed developer interface for applications executing on Humanoid OS.

What This Is

Rather than issuing low-level motor commands, applications should request high-level humanoid capabilities from the runtime.

Illustrative capability requests include:

RequestWalk()
RequestStand()
RequestReach()
RequestGrasp()
RequestLift()
RequestCarry()
RequestToolUse()
RequestHumanContact()
RequestMissionAuthority()
RequestReleaseToken()

These names are proposed API forms, not a representation that all listed APIs are presently implemented or stable.

Why It Exists

The SDK is intended to separate application intent from robot-specific actuator details.

Applications request capabilities; Humanoid OS determines how those capabilities are scheduled, governed, validated, coordinated, and executed on a particular embodiment.

Relationship to Humanoid OS

Applications
     |
     v
Humanoid SDK
     |
     v
Humanoid Runtime / Humanoid OS
     |
     +---- Constitution
     +---- Capability Registry
     +---- Resource Management
     +---- TrustBoundary
     |
     v
Actuator Runtime

Design Goals

• stable high-level developer APIs;
• hardware abstraction;
• Constitution-aware execution;
• whole-body coordination;
• capability-based programming;
• separation between application intent and actuator authority.

Status / Implementation State

Proposed SDK architecture. The current repository primarily documents intended interfaces. API names, signatures, transport mechanisms, and language bindings may change.

Planned Work

• Python SDK
• C++ SDK
• ROS 2 bindings
• Rust SDK
• reference examples
• capability schemas
• runtime authorization examples

Related Repositories

• TrustRobotics/humanoid-os
• TrustRobotics/humanoid-constitution
• TrustRobotics/TrustBoundary
• TrustRobotics/TrustRobotics-rfcs
• TrustRobotics/TrustRobotics-architecture

Patent Notice

Publication of proposed API forms does not grant any patent license. Certain implementations may incorporate technologies protected by issued or pending TrustRobotics patent rights.