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.

66documented Verbas
18kernel tools
9portals
13integrations
4install paths
Mac app release

Tater v88.3 is ready for macOS.

Download the native Tater server app with the menu bar icon, private runtime, first-run setup, and automatic update checks.

Tater macOS update v88.3.

Release v88.3 Build 92 28.3 MB Auto-updates
Pulled from the Tater update manifest • SHA f16bc56a5b16.
Tater Assistant

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

Tater ties the app, WebUI, Tater 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.
  • Download only the integrations you enable, then let cores discover cameras, sensors, speakers, garage doors, search providers, and weather sources by capability.
  • Use Spudex when Tater needs terminal console access for commands, scripts, local diagnostics, small apps, or hosted workspace tasks.
  • 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.

Modular integrations

Integrations live in Tater_Integrations and download only when enabled, so new providers can expose devices, actions, and web search without editing Tater core.

Capability-driven devices

Cores can ask for all cameras, speakers, garage doors, sensors, lights, weather sources, or search providers across every enabled integration.

Search provider choice

search_web can use enabled providers such as SearXNG, Brave Search, Google Custom Search, or Serper instead of one baked-in backend.

Smart chaining

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

Spudex terminal workbench

Spudex gives Tater a console-style tab for direct assistant chat, manual commands, tracked sessions, policy controls, and Hydra-accessible terminal tools.

Guardian Core

Guardian watches network inventory, source health, posture scoring, AI findings, device trust, watch checks, and guided security confirmations from a dark Tater-themed UI.

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.

Tater Voice

Tater Voice 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 Tater Voice 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 Tater 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 Tater Voice 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.

Local LLMs and vision

Tater can run Base, Hydra, and vision models through llama.cpp GGUF, Hugging Face Transformers, and MLX Engine, with runtime tuning, chat templates, and live debug output.

OpenAI-compatible API

External apps can call Tater through /v1/models and /v1/chat/completions in Direct or Hydra mode, protected by a local API key.

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 + integrations + cores

One assistant. Verbas, portals, integrations, and cores.

Portals

Operator console Bundled Configured in app

WebUI

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

Chat endpoint v1.0.5 2 settings

Discord

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

Chat endpoint v1.0.3 5 settings

Telegram

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

Chat endpoint v1.0.4 13 settings

Matrix

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

Chat endpoint v1.0.3 6 settings

IRC

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

Social research endpoint v1.1.3 45 settings

Moltbook

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

Voice endpoint v1.1.4 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.3 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.4 4 settings

XBMC4Xbox

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

Integrations

Web search v1.0.0 Optional

Brave Search

Adds Brave Search as one selectable provider for the search_web kernel tool.

Web search v1.0.0 Optional

SearXNG

Adds a self-hosted SearXNG instance as a modular search provider.

Web search v1.0.0 Optional

Google Custom Search

Adds Google Custom Search as a modular search provider.

Web search v1.0.0 Optional

Serper

Adds Serper's Google Search API as a modular search provider.

Smart home v1.1.0 Optional

Home Assistant

Provides a shared Home Assistant endpoint and token for legacy HA-backed devices and notification paths.

Security v1.1.0 Optional

UniFi Protect

Exposes UniFi Protect cameras, sensors, and direct speaker announcement targets.

Cores

Network security monitor v1.3.7 13 settings

Guardian Core

Network guardian core for inventory, source health, posture scoring, AI review, and guided security confirmations.

Scheduler v1.0.38 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.26 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.52 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.9 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

Integration docs

Browse optional downloaded integrations, device capabilities, and search providers.

Open integrations

Tater Voice

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

Open Tater Voice

Local LLMs

Model downloads, llama.cpp, Transformers, MLX Engine, vision, runtime tuning, chat templates, and live LLM debug tools.

Open LLM docs

OpenAI API

Use Tater from external apps through /v1/models and /v1/chat/completions in Direct or Hydra mode.

Open API docs

Spudex

Open the terminal workbench docs for direct chat, controlled commands, sessions, policy, and Hydra tools.

Open Spudex

Core docs

Built-in runtime services such as awareness automation, Guardian network review, 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