Config Reference¶

Complete reference for all config.yaml fields. Defaults are defined in app/core/config.py using Pydantic models.

server¶

Field	Type	Default	Required	Description
`host`	`str`	`"0.0.0.0"`	No	Server bind address
`port`	`int`	`8000`	No	Server port

home_assistant¶

Field	Type	Default	Required	Description
`url`	`str`	--	Yes	Home Assistant instance URL (e.g., `http://192.168.1.100:8123`)
`token`	`str`	--	Yes	Long-lived access token

audio¶

Field	Type	Default	Required	Description
`wake_word`	`str`	`"alexa"`	No	openwakeword model name
`stt_model`	`str`	`"tiny"`	No	faster-whisper model size: `tiny`, `small`, `medium`, `large`
`stt_language`	`str`	`"es"`	No	ISO language code for speech recognition
`tts_voice`	`str`	`"es_ES-davefx-medium.onnx"`	No	Path to Piper ONNX voice model

llm¶

Field	Type	Default	Required	Description
`ollama_url`	`str`	`"http://localhost:11434"`	No	Ollama API endpoint
`router_model`	`str`	`"llama3:8b"`	No	Model for intent classification
`general_model`	`str`	`"llama3:8b"`	No	Model for conversational responses
`domotica_model`	`str`	`"llama3:8b"`	No	Model for Home Assistant command translation
`musica_model`	`str`	`"llama3:8b"`	No	Model for Spotify command translation
`use_cloud`	`bool`	`false`	No	Use cloud LLM for the general agent
`cloud_provider`	`str`	`"openai"`	No	Cloud provider: `openai`, `anthropic`, or `mistral`
`cloud_api_key`	`str`	`""`	No	API key for the cloud provider
`cloud_base_url`	`str`	`""`	No	Custom API base URL (empty = provider default)
`cloud_model`	`str`	`""`	No	Cloud model name (empty = provider default)

Cloud Provider Defaults¶

Provider	Default Model	Other Options
`openai`	`gpt-5.4-mini`	`gpt-5.4-nano`, `gpt-5.1-mini`, `o3-mini`
`anthropic`	`claude-sonnet-4-6`	`claude-opus-4-6`, `claude-haiku-4-5-20251001`
`mistral`	`mistral-small-latest`	`mistral-large-latest`, `mistral-medium-latest`

spotify¶

Field	Type	Default	Required	Description
`client_id`	`str`	`""`	No	Spotify app client ID
`client_secret`	`str`	`""`	No	Spotify app client secret
`redirect_uri`	`str`	`"http://localhost:8888/callback"`	No	OAuth redirect URI
`token_cache_path`	`str`	`".spotify_cache"`	No	Path to cache the OAuth token

Full Example¶

server:
  host: "0.0.0.0"
  port: 8000

home_assistant:
  url: "http://192.168.1.100:8123"          # LAN IP of your HA instance
  token: "your_long_lived_access_token_here"

audio:
  wake_word: "alexa"
  stt_model: "tiny"                          # Downloads from HuggingFace on first run
  stt_language: "es"
  tts_voice: "/app/models/piper/es_ES-davefx-medium.onnx"

llm:
  ollama_url: "http://ollama:11434"          # Docker service name
  router_model: "llama3:8b"
  general_model: "llama3:8b"
  domotica_model: "llama3:8b"
  musica_model: "llama3:8b"
  use_cloud: false
  # cloud_provider: "openai"
  # cloud_api_key: ""
  # cloud_base_url: ""
  # cloud_model: ""

spotify:
  client_id: ""
  client_secret: ""
  redirect_uri: "http://localhost:8888/callback"
  token_cache_path: ".spotify_cache"