.env.example

# =============================================================================
# openbob — Environment Configuration
# Copy to .env and fill in your values.
# =============================================================================

# --- Data directory ---
# Absolute path on this machine — used for bind mount and agent container spawning
DATA_PATH=/opt/openbob/data

# --- Telegram (optional — only needed if Telegram channel is used) ---
# TELEGRAM_BOT_TOKEN=your-bot-token-here

# --- Matrix (optional — only needed if Matrix channel is used) ---
# MATRIX_HOMESERVER_URL=https://matrix.example.com
# MATRIX_ACCESS_TOKEN=your-access-token-here
# MATRIX_BOT_USER_ID=@yourbot:matrix.example.com

# --- Model ---
# Format: providerID/modelID
# Examples: anthropic/claude-sonnet-4-6  |  openrouter/anthropic/claude-sonnet-4-5
# Required — no default. Per-group overrides can be set via the register_group/update_group MCP tools.
MODEL=anthropic/claude-sonnet-4-6

# --- Provider API Keys (auth.json) ---
# All LLM provider credentials are stored in a single auth.json file.
# Copy your OpenCode credentials into the data directory (required):
#   mkdir -p ${DATA_PATH}/opencode
#   cp ~/.local/share/opencode/auth.json ${DATA_PATH}/opencode/auth.json
#
# The file is automatically mounted into each agent container.
# Format: { "anthropic": { "type": "api", "key": "sk-ant-..." }, ... }
# To add keys: run `opencode auth login` locally, then copy the updated file.

# --- Agent Container Env Forwarding ---
# Comma-separated list of env var names to forward as -e args to agent containers.
# Use for proxy URLs or any non-auth env vars the agent container needs.
# AGENT_FORWARD_ENV=HTTPS_PROXY,NO_PROXY

# --- Agent Timeouts & Limits ---
# Max time (ms) to wait for an agent to finish processing a prompt. Default: 480000 (8 min)
# AGENT_TIMEOUT=480000

# Max time (ms) to wait for an agent container to start up (health check). Default: 30000 (30s)
# AGENT_STARTUP_TIMEOUT=30000

# Idle timeout (ms). Containers are stopped after this duration without activity.
# Default: undefined (containers run forever). Example: 3600000 = 1 hour
# IDLE_TIMEOUT=3600000

# Max number of agent sessions running in parallel across all groups. Default: 5
# Limits concurrent LLM API calls. Messages/tasks are queued when the limit is reached.
# MAX_CONCURRENT_AGENTS=5

# --- Initial Group Registration ---
# Bootstrap the first group on startup. The channel type is inferred from the
# JID prefix: tg: → Telegram.
# To get the JID: start the bot, then send /chatid in the Telegram chat.
#
# Examples:
#   INITIAL_GROUP_JID=tg:-1001234567890
INITIAL_GROUP_JID=tg:your-chat-id-here
INITIAL_GROUP_FOLDER=main
INITIAL_GROUP_TRIGGER=openbob
INITIAL_GROUP_IS_MAIN=true

# --- OpenViking Memory (optional) ---
# Enable long-term memory across sessions. Requires: docker compose --profile memory up
#
# OPENVIKING_LLM_KEY is the API key OpenViking uses for its own embedding and LLM calls
# (e.g. an OpenRouter key). This is NOT related to agent/OpenCode auth.
# OPENVIKING_LLM_KEY=sk-or-your-key-here
#
# OPENVIKING_URL=http://openviking:1933
# OPENVIKING_LLM_MODEL=openai/gpt-4o-mini
# OPENVIKING_EMBEDDING_MODEL=openai/text-embedding-3-small
# OPENVIKING_EMBEDDING_API_BASE=https://openrouter.ai/api/v1
# OPENVIKING_EMBEDDING_DIMENSION=1536
#
# Memory scope: "global" (default) = one shared memory for all groups,
#               "group" = isolated memory per group (auto-provisions OV users)
# OPENVIKING_SCOPE=global
#
# Root API key for the OV server. Required when OPENVIKING_SCOPE=group
# to provision per-group users via the Admin API. Default: openbob-local
# OPENVIKING_API_KEY=openbob-local

# --- Optional ---
LOG_LEVEL=info

# --- Speech-to-Text (optional) ---
# Transcribe voice messages to text using NVIDIA Parakeet TDT.
# Requires: docker compose --profile stt up
# No configuration needed — the STT service is auto-detected at startup.
# First startup downloads the ~600MB ONNX model (cached in ${DATA_PATH}/stt-models).
# STT_MODEL=nemo-parakeet-tdt-0.6b-v3