Tater Assistant Docs
Setup script path

Local Source Install

Clone Tater, run the setup script for the right runtime profile, then start TaterOS with the local launcher.

Medium
Why choose this

Key points

  • The setup script creates .venv, installs Tater's Python dependencies, and writes the selected runtime profile to .runtime/tater_profile.env.
  • Profiles cover CPU, edge / remote-only, macOS Apple Silicon, NVIDIA CUDA, AMD ROCm / Strix Halo, Jetson, and Jetson Thor.
  • Tater supports Python 3.11 through 3.13. On Linux, setup can install a checksum-verified private Python runtime when the system Python is unsupported.
  • Normal local profiles use Tater's embedded Redis runtime. The edge / remote-only profile expects the operating system redis-server package.
  • Model choices are finished inside TaterOS under Settings -> Models and Settings -> Voice Pipeline.
Install flow

Steps

  1. Clone the repository.
  2. Change into the Tater project directory.
  3. Run sh setup_tater.sh and choose the runtime profile for this machine, or pass a profile name for non-interactive setup.
  4. For edge / remote-only installs, install redis-server first, then run the edge profile.
  5. Start TaterOS with sh run_ui.sh.
  6. Open http://127.0.0.1:8501 from the same machine, or use the host's address from another device on your network.
  7. Finish setup in TaterOS by selecting your LLM, Vision, Spudex, voice, and optional Beast Mode model providers.
Important notes
  • The setup profile prepares the runtime only; actual model choices are managed from TaterOS.
  • run_ui.sh automatically loads .venv and .runtime/tater_profile.env when they exist, and listens on 0.0.0.0:8501 by default.
  • Set HTMLUI_PORT before run_ui.sh if you need a different port.
  • Set TATER_SETUP_INSTALL_MANAGED_PYTHON=0 to disable private Python downloads, or TATER_SETUP_INSTALL_SYSTEM_DEPS=0 to disable automatic Linux system-package installation.
  • Downloaded models live under agent_lab/models, Spudex work starts under agent_lab/workspace, and runtime state is kept under .runtime.
Commands and config

README snippets for this install path.

Clone and run setup 
git clone https://github.com/TaterTotterson/Tater.git
cd Tater
sh setup_tater.sh
Non-interactive profiles 
sh setup_tater.sh cpu
sh setup_tater.sh edge
sh setup_tater.sh macos
sh setup_tater.sh nvidia
sh setup_tater.sh rocm
sh setup_tater.sh jetson
sh setup_tater.sh thor
Start TaterOS 
sh run_ui.sh

# Optional different port:
HTMLUI_PORT=8601 sh run_ui.sh
Back to install guide Home Portals Cores