.env.example

# ── SelenaCore Environment Configuration ──────────────────────────────────

# GEMINI_API_KEY: Required for Gemini AI API calls (optional, for cloud LLM fallback).
GEMINI_API_KEY="MY_GEMINI_API_KEY"

# APP_URL: Core API base URL.
APP_URL="http://localhost"

# HOST_UID: UID of the host user (for PulseAudio socket path).
# Default: 1000
#HOST_UID=1000

# OLLAMA_MODELS_DIR: Path to Ollama models on the host.
# Default: /usr/share/ollama/.ollama/models
#OLLAMA_MODELS_DIR=/usr/share/ollama/.ollama/models

# ── Matter / Thread (opt-in protocol stack) ───────────────────────────────
# Enable the matter-server companion container with:
#   docker compose --profile matter up -d
# MATTER_SERVER_URL is read by system_modules/device_control/drivers/matter.py.
MATTER_SERVER_URL=ws://localhost:5580/ws
MATTER_SERVER_ENABLED=false

# OTBR (OpenThread Border Router) — only needed for native Thread devices.
# Most Matter bulbs/plugs are WiFi-only and do NOT need this.
# Enable with: docker compose --profile thread up -d  (requires nRF52840 dongle)
OTBR_ENABLED=false
OTBR_WEB_URL=http://localhost:8080

# ── Zigbee backend ────────────────────────────────────────────────────────
# Selects who owns the Zigbee USB coordinator dongle. Only one process can
# hold /dev/ttyUSB0 at a time — running both backends bricks the coordinator.
#   zigpy — SelenaCore drives the dongle directly via zigpy (built-in scanner)
#   z2m   — zigbee2mqtt owns the dongle; SelenaCore consumes its MQTT topics
#           via the protocol_bridge module and the zigpy scanner becomes a no-op
#   none  — disable Zigbee entirely
ZIGBEE_BACKEND=zigpy
#ZIGBEE_SERIAL_PORT=/dev/ttyUSB0
#ZIGBEE_BAUDRATE=115200
#ZIGBEE_RADIO_TYPE=znp     # znp (TI CC2531/CC2652) or ezsp (Silicon Labs)