Tater Assistant logo Tater Assistant Source-backed docs
Advanced local setup

Local Python Install

Run Tater from source with Python 3.11 and Redis Stack, then configure Redis/Hydra in WebUI.

Medium
Why choose this

Key points

  • Requires Python 3.11, Redis Stack, and an OpenAI-compatible LLM backend such as Ollama, LocalAI, LM Studio, Lemonade, or OpenAI API.
  • The README recommends running inside a virtual environment to keep dependencies isolated.
  • Redis is no longer configured in .env; connection setup is handled in-WebUI and saved in .runtime.
Install flow

Steps

  1. Clone the repository.
  2. Change into the Tater project directory.
  3. Create and activate a Python virtual environment.
  4. Install dependencies from requirements.txt.
  5. Launch TaterOS and complete Redis setup in the popup (host/port/auth/TLS).
  6. Configure Hydra LLM base server(s) and optional Beast Mode role routing in Settings.
Important notes
  • Redis connection settings are saved locally in .runtime/redis_connection.json.
  • Redis encryption keys and live-encryption state are stored under .runtime when Redis encryption is enabled in Settings.
  • This path is the best fit when you want to inspect or modify the source directly.
Commands and config

README snippets for this install path.

Clone and prepare environment 
git clone https://github.com/TaterTotterson/Tater.git
cd Tater
python -m venv .venv
source .venv/bin/activate
pip install -r requirements.txt
Run TaterOS backend + WebUI 
uvicorn tateros_app:app --host 0.0.0.0 --port 8501 --reload --no-access-log
Alternative launcher 
sh run_ui.sh
Back to install guide Home Portals Cores