Tater Assistant Docs
Portal profile

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.

Operator console Bundled Configured in app 41 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, Tater Voice firmware management, and runtime controls in one place.
  • Adds the Spudex workbench for terminal-backed assistant sessions, direct Spudex chat, manual command runs, live logs, process control, and policy settings.
  • 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 have a Store/Manage split: Store downloads optional modules, Manage enables/disables installed modules, and Setup refreshes available provider settings.
  • The integration runtime restores missing enabled integrations at boot and keeps disabled integrations unimported.
  • Web search providers are modular integrations, with SearXNG, Brave Search, Google Custom Search, and Serper available from the integration catalog.
  • Hugging Face token storage moved into the modular integration catalog so automatic model downloads can use authenticated Hub requests when enabled.
  • Settings -> People creates master users that can link portal accounts, WebUI identities, and Tater 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 Tater 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 Tater 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 Tater Voice 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.
SpudexTerminalAgent Lab

Spudex workbench

Run terminal-backed tasks from a dedicated WebUI tab while keeping sessions, logs, process controls, and policy settings visible.

  • The Spudex tab includes a console-style chat where an assistant can run commands, write files, inspect output, search when needed, and continue until the terminal task is complete.
  • Manual sessions let operators run one command directly, keep background processes visible, and stop model-started sessions from the UI.
  • Settings cover enabled platforms, the working folder under Agent Lab, approval behavior, command timeout, output caps, max task steps, and policy toggles for network, installs, shells, containers, host/admin commands, and other command classes.
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 Tater Voice 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.

GET /api/spudex

Load Spudex settings, sessions, logs, process state, and platform options.

Feeds the Spudex tab with current settings, active sessions, recent terminal history, tracked processes, and available platform toggles.

POST /api/spudex/chat

Run a direct Spudex chat turn.

Bypasses Hydra and sends the request into the Spudex console loop, where the model can run commands, write files, search, verify results, and report back in the same session.

POST /api/spudex/run

Start a manual Spudex command session.

Runs a single command from the configured Agent Lab working folder, optionally in the background, with live log streaming and stop controls.

Back to portals Verbas Portals Tater Voice Cores Home