Reference
Environment variables·
Every variable TINY's code reads, scanned from os.getenv at every docs build — default, reader, purpose in ≤ 7 words. Filterable, each row linkable.
In 10 seconds
- Every
os.getenvin the repo lands here at build time (scripts/envdoc.py); a variable without a note fails the tests. - Values live in
.env,~/.reachy-dashboard.env(auth) and~/.tiny-mcp.env(fleet) on the CM4. Secrets never appear here.
Models·
| variable | default | purpose | reader |
|---|---|---|---|
AWS_REGION |
us-east-1 |
Bedrock region — text model and Nova Sonic. | tiny.py |
GEMINI_API_KEY |
— | Gemini Live key; GOOGLE_API_KEY is the fallback. |
tiny.py |
GOOGLE_API_KEY |
— | Fallback for GEMINI_API_KEY. |
tiny.py |
OPENAI_API_KEY |
— | OpenAI Realtime key for the voice persona. | tiny.py |
TINY_MODEL_ID |
global.anthropic.claude-opus-4-8 |
Bedrock model id for text personas. | tiny.py |
Voice·
| variable | default | purpose | reader |
|---|---|---|---|
REACHY_AUDIO_RATE |
16000 |
PyAudio device rate; resampled to the model. | tiny.py |
REACHY_DAEMON_PYTHON |
/venvs/mini_daemon/bin/python |
Daemon venv interpreter for the USB audio fallback. | xmos_audio.py |
TINY_PHOTO_QUESTION |
*(long)* |
Default question take_photo asks the model. |
vision.py |
VOICE_CONFIG_POLL_S |
2 |
Config poll period in a live session. | voice_listener.py |
VOICE_LANG |
— | ISO-639-1 transcription hint (tr, en). |
config.py |
VOICE_MODEL |
— | OpenAI Realtime model override (robot: gpt-realtime-2). |
tiny.py |
VOICE_NAME |
— | Provider voice; the robot sets shimmer. |
config.py |
VOICE_PROVIDER |
openai |
openai · nova_sonic · gemini — the bidi model. |
config.py |
VOICE_RELEASE_MEDIA |
0 |
1 releases daemon media before each start (Lite). |
voice_listener.py |
VOICE_RESTART_DELAY |
5 |
Backoff before a session rebuild; doubles per fatal error. | voice_listener.py |
VOICE_RESTART_DELAY_MAX |
300 |
Cap for that backoff. | voice_listener.py |
VOICE_TRANSCRIBE_PROMPT |
— | Free-text hint for the transcriber. | config.py |
VOICE_TURN_DETECTION |
server_vad |
server_vad or semantic_vad. |
config.py |
VOICE_VAD_EAGERNESS |
auto |
semantic_vad turn-taking: low |
medium |
VOICE_VAD_PREFIX_MS |
300 |
Audio kept before speech onset, ms. | config.py |
VOICE_VAD_SILENCE_MS |
600 |
Silence that ends a turn, ms. | test_config_api.py |
VOICE_VAD_THRESHOLD |
0.5 |
Server-VAD threshold 0–1; higher = harder barge-in. | config.py |
VOICE_XMOS_PARAMS |
DEFAULT_PARAMS |
XVF3800 params written at start; PP_NLATTENONOFF=0 = barge-in. |
xmos_audio.py |
Robot·
| variable | default | purpose | reader |
|---|---|---|---|
REACHY_BOOT_VOLUME_MIN |
60 |
Minimum volume tiny-wake enforces — alsa-state can boot deaf. | tiny-wake.py |
REACHY_CAMERA_BACKEND |
local |
Backend for transient reachy_camera grabs. |
reachy_camera.py |
REACHY_CLOSE_WAIT_WARN |
50 |
Warn at this many CLOSE-WAIT sockets (incident: 614). | daemonlink.py |
REACHY_CONNECTION_MODE |
auto |
auto · localhost_only · network → ReachyMini(connection_mode=). |
_reachy_common.py |
REACHY_DAEMON_FALLBACK_HZ |
4 |
REST poll cap while the stream is down. | daemonlink.py |
REACHY_DAEMON_STREAM_HZ |
10 |
Rate asked of /api/state/ws/full. |
daemonlink.py |
REACHY_DAEMON_STREAM_STALE_S |
1.5 |
Stream age that triggers one REST fallback read. | daemonlink.py |
REACHY_DOA_BODY_MAX_DEG |
60 |
Body yaw a turn may reach. | doa.py |
REACHY_DOA_FACE_FRESH_S |
1.5 |
A face younger than this blocks DoA. | doa.py |
REACHY_DOA_FRAME |
head |
head (relative to head yaw) or body (absolute). |
doa.py |
REACHY_DOA_HEAD_MAX_DEG |
45 |
Head yaw before the body takes over. | doa.py |
REACHY_DOA_MIN_CONSEC |
6 |
Agreeing speech frames before a turn. | doa.py |
REACHY_DOA_MIN_DELTA_DEG |
10 |
Bearings closer to straight ahead are ignored. | doa.py |
REACHY_DOA_RAIL_DEG |
3 |
Within this of 0/π = rail, ignored. | doa.py |
REACHY_DOA_RATE_S |
3 |
Minimum seconds between DoA turns. | doa.py |
REACHY_DOA_SIGN |
1 |
1 (owner-confirmed) or -1 if it turns away. |
doa.py |
REACHY_DOA_SPEAK_TAIL_S |
1.5 |
Seconds after speaking that speech still counts as own. | doa.py |
REACHY_DOA_TOL_DEG |
12 |
How much those frames may disagree. | doa.py |
REACHY_DOA_TURN |
1 |
1 turns toward speech when no face is locked. |
doa.py |
REACHY_DOA_TURN_DURATION_S |
0.7 |
Duration of the DoA goto. | doa.py |
REACHY_DOA_WINDUP_RATIO |
0.6 |
“Did not shrink” = new | delta |
REACHY_DOA_WINDUP_S |
10 |
Same-direction turns within this window need a shrinking bearing. | doa.py |
REACHY_FD_WARN_FRACTION |
0.6 |
Warn when daemon fds exceed this fraction. | daemonlink.py |
REACHY_HOST |
127.0.0.1 |
Daemon host for SDK client and dashboard. | server.py |
REACHY_MEDIA_BACKEND |
no_media |
Shared client's media backend; no_media leaves it to the daemon. |
_reachy_common.py |
REACHY_MOVES_ACTIVE_HZ |
5 |
/api/move/running probe rate after a move. |
daemonlink.py |
REACHY_MOVES_IDLE_PROBE_S |
3 |
/api/move/running probe interval when idle. |
daemonlink.py |
REACHY_PORT |
8000 |
Daemon HTTP port. | _reachy_common.py |
REACHY_SPAWN_DAEMON |
— | 1 = SDK spawns a daemon if none answers. |
_reachy_common.py |
REACHY_USE_SIM |
— | 1 = MuJoCo simulation (make sim). |
_reachy_common.py |
TINY_CAMERA_SNAPSHOT |
str(Path(tempfile.gettempdir()) / 'tiny_view.jpg') |
Where reachy_camera writes its frame. |
reachy_camera.py |
TINY_DASHBOARD_TOKEN |
— | Bearer for those calls off loopback. | head_tracking.py |
TINY_DASHBOARD_URL |
http://127.0.0.1:8097 |
Dashboard URL the tools call (snapshots, holds). | head_tracking.py |
TINY_TTS_REF_AUDIO |
https://github.com/gradio-app/gradio/raw/main/test/test_files/audio_sample.wav |
Reference clip for that Space fallback. | reachy_audio.py |
TINY_TTS_SPACE |
ResembleAI/Chatterbox-Multilingual-TTS |
Legacy HF Space fallback (answers 401 today). | reachy_audio.py |
TINY_TTS_URL |
http://127.0.0.1:5002 |
Piper TTS (tiny-tts.service) behind reachy_say. |
robot.py |
Telegram·
| variable | default | purpose | reader |
|---|---|---|---|
TELEGRAM_ALLOWED_USERS |
— | Usernames/ids allowed to talk ((any) = everyone). |
test_config_api.py |
TELEGRAM_BOT_TOKEN |
— | Bot token for the telegram persona. | telegram_listener.py |
TELEGRAM_DEFAULT_CHAT_ID |
— | Chat for unsolicited messages (thinker notes, photos). | test_config_api.py |
TELEGRAM_HISTORY_LIMIT |
— | Recent messages injected per chat. | telegram.py |
Thinker·
| variable | default | purpose | reader |
|---|---|---|---|
THINKER_DISABLED |
— | 1 makes the thinker a no-op. |
thinker_loop.py |
THINKER_HEARTBEAT_PHOTOS |
1 |
0 = no heartbeat photos. |
config.py |
THINKER_INTERVAL |
30 |
Seconds between thinker cycles (robot: 30). | thinker_loop.py |
Perception·
| variable | default | purpose | reader |
|---|---|---|---|
REACHY_FACE_TRACKING |
0 |
Legacy; see REACHY_TRACK_AUTOSTART. |
server.py |
REACHY_SPEAK_TAIL_S |
0.8 |
Extra seconds the speaking hold outlives audio. |
head_tracking.py |
REACHY_TRACK_AUTOSTART |
1 |
1 starts face tracking at boot and daemon restarts. |
server.py |
REACHY_TRACK_HOLD_TTL |
20 |
Seconds before an unreleased tracking hold expires. | tracking.py |
REACHY_TRACK_POLL_HZ |
2 |
Poll rate of the daemon's tracked face. | tracking.py |
REACHY_TRACK_REASSERT_MISSES |
2 |
ts: null polls before the tracker is re-enabled. |
tracking.py |
Dashboard·
| variable | default | purpose | reader |
|---|---|---|---|
REACHY_ASK_PREWARM |
1 |
0 skips the Ask agent prewarm. |
server.py |
REACHY_ASK_TIMEOUT |
60 |
Seconds an Ask turn may run. | server.py |
REACHY_CAMERA_SOCKET |
/tmp/reachymini_camera_socket |
Daemon camera IPC socket path. | robot.py |
REACHY_DAEMON_URL |
http://127.0.0.1:8000 |
Daemon base URL for the dashboard. | daemonlink.py |
REACHY_DASH_CAMERA |
*(long)* |
ipc (coexists with tracking) · rpicam · cv2. |
robot.py |
REACHY_DASH_CAMERA_INDEX |
0 |
V4L2 index for cv2. |
robot.py |
REACHY_DASH_CAMERA_OFF |
— | Any value disables the dashboard camera. | robot.py |
REACHY_DASH_CAM_FPS |
12 |
MJPEG frame-rate cap. | robot.py |
REACHY_DASH_TTS_URL |
os.getenv('TINY_TTS_URL', 'http://127.0.0.1:5002') |
TTS for dashboard Say (defaults to TINY_TTS_URL). |
robot.py |
REACHY_DIST |
*(long)* |
Built frontend directory (SPA shell). | server.py |
REACHY_HTTP_PORT |
8097 |
Dashboard port (behind the Cloudflare tunnel). | server.py |
REACHY_LOG |
INFO |
Dashboard log level. | server.py |
REACHY_MEM_DB |
*(long)* |
SQLite brain for the mind feed. | robot.py |
REACHY_NO_AUTOAPP |
— | Tests: import dashboard.server without building the app. |
server.py |
REACHY_RATE_LIMIT |
5 |
Control POSTs per second before 429. | server.py |
REACHY_STATE_CACHE_S |
0.06 |
Coalesces /api/state reads — one daemon request per window. |
robot.py |
REACHY_WS_HZ |
15 |
State frames per second on /ws. |
server.py |
Auth·
| variable | default | purpose | reader |
|---|---|---|---|
REACHY_AUTH_STORE |
*(long)* |
Passkey credential store path. | auth.py |
REACHY_LOOPBACK_READS |
1 |
0 disables keyless reads from the robot itself. |
auth.py |
REACHY_ORIGIN |
— | Expected WebAuthn origin(s), comma-separated. | auth.py |
REACHY_REG_TOKEN |
— | Required to enrol passkeys after the first (TOFU). | auth.py |
REACHY_RP_ID |
— | WebAuthn relying-party id — the public hostname. | auth.py |
REACHY_RP_NAME |
REACHY |
Display name in the passkey prompt. | auth.py |
REACHY_SESSION_STORE |
str(self.store_path.with_name('sessions.json')) |
Session cookie store path. | auth.py |
REACHY_SESSION_TTL |
43200 |
Passkey session lifetime, seconds. | auth.py |
REACHY_TOKEN |
— | Owner bearer — full /api/* and /ws (Bearer or ?token=). |
auth.py |
REACHY_USER_NAME |
owner |
User handle the passkeys register under. | auth.py |
Fleet·
| variable | default | purpose | reader |
|---|---|---|---|
TINY_MCP |
0 |
1 mounts tiny.technology fleet tools (tiny-tech MCP). |
config.py |
TINY_MCP_COMMAND |
— | Full server command, overriding auto-detect. | tiny_mcp.py |
TINY_MCP_HOME |
~/.tiny-mcp |
Isolated TINY_HOME for the MCP process. |
tiny_mcp.py |
TINY_MCP_MESH |
0 |
1 joins the zenoh mesh (off: CPU). |
tiny_mcp.py |
TINY_MCP_NODE |
— | node binary if not on PATH. | tiny_mcp.py |
TINY_MCP_PERSONAS |
— | Personas that get fleet tools. | tiny_mcp.py |
TINY_MCP_STARTUP_TIMEOUT |
45 |
Seconds to wait for the MCP handshake. | tiny_mcp.py |
TINY_MCP_TIMEOUT |
90 |
Per-call timeout for fleet tools. | tiny_mcp.py |
TINY_MCP_TINY_TECH |
— | Path to a tiny-tech package dir. | tiny_mcp.py |
TINY_SELF_DEVICE_IDS |
— | This robot's device ids — use_device refuses itself. |
tiny_mcp.py |
TINY_SELF_NAME |
— | Name prefixed to fleet prompts. | tiny_mcp.py |
TINY_TOKEN |
— | tiny.technology CLI JWT (TINY_TOKEN_FILE wins). |
tiny_mcp.py |
TINY_TOKEN_FILE |
— | Mode-600 file holding that token. Never logged. | tiny_mcp.py |
112 variables.