Tater Assistant Docs
Portal profile

WebUI

Local Vue 3 control center for the Dashboard, private chat, Music Core, Integrations, Verbas, Portals, Cores, Spudex, Voice, System Tasks, runtime telemetry, and settings.

Operator console Bundled Configured in app 51 Verbas
Portal role

What this portal is for

Operator console

Highlights

Behavior in the current codebase

  • The Dashboard, Chat, Integrations, Verba, Portals, Cores, Spudex, Settings, Music Core, and live runtime popup now use Tater's locally bundled Vue 3 and TypeScript interface.
  • The orange-and-gray UI keeps navigation, cards, dialogs, settings forms, and responsive layouts consistent without downloading a frontend from a third party.
  • Dashboard is the default landing view, with alphabetized masonry sections for health, environment imagery, awareness snapshots, voice satellites, Speaker ID, and Emotion ID.
  • Live surfaces update in place without replacing the selected tab, scroll position, open dropdown, or in-progress form values.
  • Settings -> System Tasks shows Tater-owned and Core-owned jobs with run state, last and next run times, errors, and a Run Now control.
  • Satellite inventory, integration devices, Dashboard briefs, hardware telemetry, loaded models, and context estimates rebuild in the background and on relevant change events.
  • The installed Tater version appears at the bottom of the left menu and comes from the packaged build metadata on macOS, Docker, and local command-line installs.
  • 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 pill opens live model, Hydra, LLM, vision, context, Apple GPU/unified-memory, and unload controls without blocking Model Settings initialization.
  • 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
Dashboard Chat Music Integrations Voice Installed build
DashboardSystems healthy
Now playing ยท Family Room Tater Recommendations
Voice8 satellitesOffice Stereo ready
System TasksAll caught upNext refresh in 3m
HomeDevices, people, rooms, and coresLive local state without page reloads
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