Skip to content

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.

  • operators editing .env · tool authors adding a knob
  • 5 min
  • 1129 words
  • from the code
  • verified 2026-09-21

In 10 seconds

  • Every os.getenv in 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.