Tater docs

Tater connects your voice to home, tools, and automations.

Talk to Tater from voice devices or the app, and Hydra routes the request through Verbas, portals, cores, firmware, and smart-home controls from one place.

Tater Assistant

Your local voice assistant for rooms, devices, and automations.

Tater ties the app, WebUI, ESPHome voice satellites, wake-word engines, dashboard, firmware tools, and Verbas into one control surface for your home.

  • Talk through VoicePE, Sat1, or S3Box devices, then let Hydra route the request to Verbas, cores, and smart-home controls.
  • Use the app or WebUI for private chat, quick actions, attachments, device health, dashboards, and firmware updates.
  • Mix local or remote wake detection with microWakeWord, openWakeWord, or NanoWakeWord, plus intercom and display notifications.
What Tater does

Tater plans, acts, and connects across your stack.

Smart chaining

Hydra breaks work into steps, picks the next tool, and keeps going until the task is done.

Tater Dashboard

The default WebUI view now gives a cached home brief, health, environment, awareness snapshots, voice devices, Speaker ID, and Emotion ID without blocking page load.

Native ESPHome voice

ESPHome is built into Tater, powering VoicePE, Sat1, and S3Box devices with room-aware voice sessions, remote openWakeWord, remote NanoWakeWord, intercom, wake arbitration, live entities, reply playback routing, logs, and native operator screens.

Tater S3Box displays

ESP32-S3-BOX-3 displays can run a Tater LVGL firmware with sensor bubbles, weather history bars, voice states, tool-call visuals, and camera snapshot notifications.

Firmware recovery

The ESPHome firmware tab supports browser USB flashing, USB device selection, OTA and USB logs, and safe-mode recovery erases for ESP32 devices.

Voice identity and tone

Speaker ID and Emotion ID can warm SpeechBrain models, detect enrolled speakers or tone, and pass useful context into voice turns.

People identity layer

Settings -> People creates master users that link portal accounts and ESPHome voice identities, with scoped per-person response instructions.

Display notifications

Tater apps and cores can publish display events with text, images, snapshots, and tool-progress metadata to targeted ESPHome screens.

Remote wake and intercom

Satellites can switch between microWakeWord, remote openWakeWord, and remote NanoWakeWord, fall back locally if a remote wake server is unavailable, and use Tater intercom broadcasts across room devices.

Environment-aware sensors

Environment Core supplies normalized readings for displays and dashboard briefs, including Ecowitt rain, Ecobee remote sensors, and Fahrenheit/Celsius conversion.

Hugging Face integration

A saved Hugging Face token can be injected into model download environments for private, gated, or higher-rate model pulls.

Beast Mode routing

Base servers can run normal AI calls while Chat/Astraeus/Thanatos/Minos/Hermes optionally route to per-head models.

Redis control + encryption

Redis setup, connectivity checks, and live encrypt/decrypt controls are managed directly in WebUI settings.

API key protection

Portal routes on the main Tater port can be locked behind X-Tater-Token so companion apps and integrations use shared API keys.

Core layer

Built-in tools handle files, web research, memory, images, notes, attachments, and delivery.

Verbas

Actions speak louder then words. Verbas extend Tater into smart-home, media, camera, note, download, and admin workflows.

Portals + cores

One assistant. Verbas, portals, and cores.

Portals

Operator console Bundled Configured in app

WebUI

FastAPI + static control center for Dashboard, setup, private chat, Verba/Portal/Core management, ESPHome firmware, voice tuning, Hydra runtime stats, and Redis operations.

Chat endpoint v1.0.4 2 settings

Discord

Full-featured Discord bot with rich interactions, media output, background jobs, and Verba-backed actions.

Chat endpoint v1.0.2 5 settings

Telegram

Telegram bot integration with allowlists, DM restrictions, queued notifications, media delivery, and Verba execution.

Chat endpoint v1.0.3 13 settings

Matrix

Federated Matrix client with encryption support, Markdown rendering, and full Verba compatibility.

Chat endpoint v1.0.2 6 settings

IRC

Lightweight IRC bot that responds to mentions and runs compatible Verbas.

Social research endpoint v1.1.2 45 settings

Moltbook

Social/research community portal that keeps Tater active on Moltbook with a structured, safety-first loop.

Voice endpoint v1.1.3 5 settings

HomeKit

Siri and Apple Shortcuts portal for a full Siri-to-Tater round-trip, with per-device sessions, Shortcut-friendly JSON, and optional auth protection.

Desktop endpoint v1.1.2 5 settings

macOS

Native desktop portal used by the Tater Menu status-bar app for chat, quick actions, notification polling, and attachment workflows.

Console endpoint v1.1.3 4 settings

XBMC4Xbox

Original Xbox integration through the custom Cortana-powered Tater skin and scripts for XBMC4Xbox.

Cores

Scheduler v1.0.37 No required fields

AI Task Runner

Built-in scheduled task runner for timed and recurring AI jobs with delivery routed through notifier portals.

Background service v1.0.23 10 settings

Memory Core

Background memory extraction layer that scans chat history, stores user and room memory, and feeds Hydra context.

Personal intelligence engine v1.0.46 1 settings

Personal Core

Email intelligence core that scans inboxes, builds a structured personal profile, injects optional Hydra context, and supports cross-portal notifications.

Background service v1.0.8 1 settings

RSS

Background feed watcher that summarizes articles and dispatches updates through notifier portals.

Documentation map

Start broad, then drill into the details.

Overview

Start with the core story and the docs map.

Stay here

Portal docs

See every portal, its role, and its settings.

Open portals

ESPHome tab

Built-in voice runtime docs for satellites, live entities, and playback flows.

Open ESPHome

Core docs

Built-in runtime services such as awareness automation, scheduling, memory, personal email intelligence, and RSS monitoring.

Open cores

Hydra core

Astraeus -> Thanatos -> Minos -> Hermes loop, Beast Mode routing, and guardrails.

Open Hydra

Tools + Verbas

Browse built-in tools and the current Verba snapshot.

Open Verbas
WebUI snapshot

The operator side is live.

The WebUI handles setup, chat, plugin browsing, settings, Hydra runtime controls, and Redis encryption in one place.

Tater WebUI screenshot