Tater Assistant Docs
Portal profile

WebUI

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

Operator console Bundled Configured in app 67 Verbas
Portal role

What this portal is for

Operator console

Highlights

Behavior in the current codebase

  • Dashboard is now the default landing view, with cached scheduled briefs for Tater health, environment, awareness snapshots, voice satellites, Speaker ID, and Emotion ID.
  • Hosts private chat, Verba browsing, settings, ESPHome firmware management, and runtime controls in one place.
  • First-run Redis setup is handled in-WebUI via popup and stored under .runtime so connection config persists.
  • Redis settings include connection test/save plus live encryption and decryption controls for in-place data protection.
  • Hydra settings cover base server pools, optional Beast Mode role routing, and runtime tuning values.
  • The top runtime stats pills open a colorized live activity popup for Hydra jobs, LLM calls, vision calls, and context budget.
  • Integrations now include Hugging Face token storage so automatic model downloads can use authenticated Hub requests.
  • Settings -> People creates master users that can link portal accounts, WebUI identities, and ESPHome voice identities into one person record.
  • WebUI password login can be enabled from Settings -> General and uses cookie-backed sessions.
Settings

Configuration schema

The WebUI is itself the configuration portal, so this page documents behavior and role rather than a separate PORTAL_SETTINGS form.

Tater WebUI screenshot
Identity layer

People turns scattered accounts and devices into one known user.

The People panel is the human identity layer Tater uses when one person appears through multiple portals, devices, or voice identities.

Settings -> PeopleMaster userIdentity links

Master users

Create one master user per real person, then link all of their known identities to that record.

  • A master user can represent the same person across WebUI, Discord, Telegram, Matrix, IRC, HomeKit, macOS, XBMC, Meshtastic, and ESPHome voice identities.
  • Linked identities let Tater resolve a request origin into one person_id and person_name instead of treating every portal account as a separate user.
  • Speaker ID aliases from ESPHome voice turns can also be linked, so a recognized voice can map back to the same master user as that person's chat accounts.
InstructionsPrompt contextScoped

Per-person instructions

Each master user can carry trusted response instructions that only apply when that user is resolved.

  • Per-person instructions are useful for preferred names, tone preferences, accessibility needs, household roles, or other user-specific response style rules.
  • Tater injects those instructions only for the current resolved user and tells Hydra not to apply them to other people mentioned in the conversation.
  • These instructions are scoped under system and safety rules, so they personalize responses without overriding higher-priority behavior.
DiscoveryPortalsSpeaker ID

Discovered identities

The People panel can surface identities Tater has seen but not yet linked.

  • Tater discovers candidate identities from recent WebUI users, portal history, Memory Core identity docs, and ESPHome Speaker ID aliases.
  • Operators can attach a discovered identity to an existing master user or create a new master user first.
  • Manual links keep matching explicit, which is safer than guessing when multiple people share devices or rooms.
Built-in APIs

HTTP endpoints exposed by this portal.

GET /api/settings/people

Load People settings, master users, and discovered identity rows.

Returns summary metrics, saved people, linked aliases, and discovered identities from WebUI, portals, Memory Core, and ESPHome Speaker ID.

POST /api/settings/people/action

Create, edit, delete, link, and unlink People records.

Supports people_create, people_save, people_delete, people_alias_attach, and people_alias_detach actions for the Settings -> People panel.

Back to portals Verbas Portals ESPHome Cores Home