Skip to content

Guide

Safety envelope·

What TINY clamps before a value reaches the daemon, what it deliberately leaves to the SDK, and where each limit lives in the code — read from tools/_reachy_common.py, not remembered.

  • anyone writing a motion tool or a prompt that moves the head
  • 1 min
  • 213 words
  • from the code
  • verified 2026-09-21

In 10 seconds

  • Head pitch/roll ±40°, yaw ±180°, body yaw ±160° — clamped before the daemon.
  • Antennas, translation, recorded emotions: bounded by daemon and SDK.
  • MAX_YAW_DELTA = 65° is declared, not enforced.

The envelope·

value limit enforced by where
head pitch ±40° TINY clamp(), then SDK _reachy_common.py:32 · reachy_motion.py:62
head roll ±40° TINY, then SDK :33 · :63
head yaw ±180° TINY, then SDK :34 · :64
body yaw ±160° TINY, then SDK :35 · :66,118
head − body yaw delta 65° declared, unused :36
antennas ~±90° daemon / SDK radians pass through
head translation ~±20 mm daemon / SDK create_head_pose
move duration ≥ 0.1 s TINY max(0.1, …) goto_target
recorded emotions the daemon's library daemon only a name travels

Where it is enforced·

# tools/_reachy_common.py:32-36 — verbatim
LIM_HEAD_PITCH = (-40.0, 40.0)
LIM_HEAD_ROLL = (-40.0, 40.0)
LIM_HEAD_YAW = (-180.0, 180.0)
LIM_BODY_YAW = (-160.0, 160.0)
MAX_YAW_DELTA = 65.0

# tools/_reachy_common.py:103
def clamp(value: float, lo: float, hi: float) -> float:
    return max(lo, min(hi, value))
# tools/reachy_motion.py:62-66 — the first thing reachy_look does
pitch = clamp(pitch, *LIM_HEAD_PITCH)
roll = clamp(roll, *LIM_HEAD_ROLL)
yaw = clamp(yaw, *LIM_HEAD_YAW)
if body_yaw is not None:
    body_yaw = clamp(body_yaw, *LIM_BODY_YAW)

The SDK clamps again; the daemon rejects the unreachable.

What a move also does·

  • A look wins over face tracking — held for the move + 3 s.
  • Emotions are names, not angles — no prompt can produce a bad pose.
  • Every tool returns an error string, never raises — the model reads it aloud.

Beyond the hard limits

Small moves look natural — big swings read as malfunction. Keep the head−body delta under ~45°.

No danger class

Unlike neon's mutex-gated arm tools, every TINY tool is self-bounded. No unsafe=True — nothing to escape.