.env.example

# =============================================================================
# OpenWebUI connection
# =============================================================================
# OpenWebUI base URL. Values ending in /api are accepted.
OPENWEBUI_URL=http://localhost:3001/api

# Model/workspace id as known by OpenWebUI.
OPENWEB_LOADED_LLM=reachy-convo

# API key for OpenWebUI HTTP endpoints when API-key bearer auth is accepted.
OPENWEBUI_API_KEY=

# OpenWebUI browser/session JWT. Preferred over OPENWEBUI_API_KEY and required
# for authenticated Socket.IO user-join behavior.
OPENWEBUI_TOKEN=

# Optional browser User-Agent sent with OpenWebUI requests.
OPENWEBUI_USER_AGENT=Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/149.0.0.0 Safari/537.36


# =============================================================================
# OpenWebUI chat state
# =============================================================================
# Leave blank on first launch. The app saves the real OpenWebUI chat id after a
# successful turn. Callback and daily rollover clear this value on purpose.
OPENWEBUI_CHAT_ID=
OPENWEBUI_CHAT_WINDOW_START=
OPENWEBUI_CHAT_PENDING_REASON=
OPENWEBUI_CHAT_PENDING_EVENT_ID=


# =============================================================================
# OpenWebUI variables and user context
# =============================================================================
OPENWEBUI_USER_ID=
OPENWEBUI_USER_NAME=Reachy
OPENWEBUI_USER_EMAIL=reachy@example.local
OPENWEBUI_USER_LANGUAGE=en-US
OPENWEBUI_USER_LOCATION=Unknown
OPENWEBUI_USER_TIMEZONE=America/New_York


# =============================================================================
# Audio, speech, and VAD
# =============================================================================
# Digital gain applied to microphone input before VAD and transcription upload.
MIC_GAIN=1.0

# OpenWebUI speech read timeout in seconds.
OPENWEBUI_TTS_READ_TIMEOUT=15.0

# No-wake-word VAD tuning. ONNX Silero is preferred; audio-level fallback keeps
# startup alive if ONNX Runtime or the model is unavailable.
VAD_THRESHOLD=0.12
VAD_FALLBACK_THRESHOLD=0.010
VAD_SPEECH_ONSET_CHUNKS=2
VAD_SILENCE_END_CHUNKS=70
VAD_MIN_SPEECH_CHUNKS=8

# Optional override for the downloaded Silero ONNX model path. Blank uses
# ~/.cache/reachy-openwebui-vad/silero_vad.onnx.
SILERO_VAD_ONNX_PATH=

# Optional idle timeout. 0 disables idle-based conversation reset.
OPENWEBUI_CONVERSATION_IDLE_RESET_SECONDS=0


# =============================================================================
# Vision and Hugging Face cache
# =============================================================================
# Local device vision model used only when optional local vision code is present
# and the app is launched with --smolvlm.
LOCAL_DEV_VISION_MODEL=HuggingFaceTB/SmolVLM2-2.2B-Instruct

# Cache directory for downloaded Hugging Face assets.
HF_HOME=./cache

# Optional Hugging Face token for gated/private assets.
HF_TOKEN=