Platform profile

Home Assistant

Voice and text assistant endpoint for Home Assistant Assist, with direct smart-home control and Verba Plugin-backed actions.

Voice and smart-home endpoint 12 settings 17 Verba Plugins
Runtime role

What this surface is for

Voice and smart-home endpoint

Highlights

Behavior in the current codebase

  • Designed for Assist pipeline conversations and direct smart-home control.
  • Includes session history, follow-up mic behavior, satellite lookup caching, and notification bridging.
  • Forms the conversational half of the Home Assistant integration story alongside automation actions.
Settings

Configuration schema

  • Continued chat (auto re-open mic) select

    If enabled, Tater automatically re-opens the Assist satellite mic when it ends with a question.

    Key: CONTINUED_CHAT_ENABLED Default: false Options: true, false
  • Follow-up idle wait (seconds) number

    How long to wait for the satellite to return to idle before re-opening the mic.

    Key: FOLLOWUP_IDLE_TIMEOUT_S Default: 12
  • Max History Cap number

    Hard ceiling to prevent runaway context sizes.

    Key: MAX_HISTORY_CAP Default: 20
  • Assist satellite map cache TTL (seconds) number

    How long to cache the area→assist_satellite mapping (registry lookups).

    Key: SATELLITE_MAP_CACHE_TTL_S Default: 3600
  • Session History (turns) number

    How many recent turns to include per HA conversation (smaller = faster).

    Key: SESSION_HISTORY_MAX Default: 6
  • Session TTL select

    How long to keep a voice session’s history alive (5m–24h).

    Key: SESSION_TTL_SECONDS Default: 2h Options: 5m, 30m, 1h, 2h, 6h, 24h
  • Voice PE entity #1 string

    Entity ID of a Voice PE light/LED (e.g., light.voice_pe_office)

    Key: VOICE_PE_ENTITY_1
  • Voice PE entity #2 string

    Entity ID of a Voice PE light/LED (e.g., light.voice_pe_office)

    Key: VOICE_PE_ENTITY_2
  • Voice PE entity #3 string

    Entity ID of a Voice PE light/LED (e.g., light.voice_pe_office)

    Key: VOICE_PE_ENTITY_3
  • Voice PE entity #4 string

    Entity ID of a Voice PE light/LED (e.g., light.voice_pe_office)

    Key: VOICE_PE_ENTITY_4
  • Voice PE entity #5 string

    Entity ID of a Voice PE light/LED (e.g., light.voice_pe_office)

    Key: VOICE_PE_ENTITY_5
  • Bind Port number

    TCP port for the Tater ↔ HA bridge

    Key: bind_port Default: 8787