Skip to content
TALOS

Install

Pick the install path for your platform. The official installers and release archives are the supported binary entrypoints for v0.9.1. Cargo install from crates.io is planned, but not published yet.

Download a release

Install the latest release on macOS or Linux:

curl -fsSL https://raw.githubusercontent.com/wjhuang88/talos/main/install/install.sh | sh

Install the latest Windows x86_64 release from PowerShell:

iex (irm https://raw.githubusercontent.com/wjhuang88/talos/main/install/install.ps1)

Install or roll back to a specific release

Use the complete Git tag shown on GitHub Releases. For macOS or Linux: 

curl -fsSL https://raw.githubusercontent.com/wjhuang88/talos/main/install/install.sh \
  | TALOS_VERSION=v0.9.1 sh
~/.talos/bin/talos --version

For Windows x86_64 PowerShell:

$env:TALOS_VERSION = 'v0.9.1'
iex (irm https://raw.githubusercontent.com/wjhuang88/talos/main/install/install.ps1)
& "$env:USERPROFILE\.talos\bin\talos.exe" --version
Remove-Item Env:TALOS_VERSION

Replace v0.9.1 with the release tag you need. The installer overwrites the binary in the selected install directory; it does not roll back configuration or session data. Talos is pre-1.0, so back up ~/.talos before running an older binary, or set TALOS_INSTALL_DIR and test the older version in an isolated directory. To restore the newest release, clear TALOS_VERSION and run the normal latest-install command again. A missing tag or platform archive fails explicitly; the installer never silently substitutes another version.

Installers live under install/ in the repository because they are user-facing release entrypoints. Development and governance scripts live under scripts/; the old scripts/install.* paths are intentionally not kept after the pre-1.0 installer layout cleanup.

Or download an archive

Download the archive for your platform from GitHub Releases, then unpack it: 

tar -xzf talos-aarch64-darwin.tar.gz
chmod +x talos
./talos --help

Published archive names

Platform Archive
Linux x86_64 talos-x86_64-linux.tar.gz
Linux ARM64 talos-aarch64-linux.tar.gz
macOS Intel talos-x86_64-darwin.tar.gz
macOS Apple Silicon talos-aarch64-darwin.tar.gz
Windows x86_64 talos-x86_64-windows.zip

Note: Windows ARM64 artifacts are not published yet. The Windows installer script also refuses to run on ARM64 until a published artifact is available.

First-run setup

When you start Talos without a model configured, the TUI opens with a model picker instead of failing. Choose a model to get started. If the provider needs credentials, Talos shows instructions for setting the API key.

To skip the wizard in CI or non-interactive environments:

talos --no-init -p "summarize this repo"

Configuration management

View and edit configuration without hand-editing TOML. Secrets are masked in every display surface; see the Safety page for the full secret-masking boundary. 

talos --config-list                          # print all settings (secrets masked)
talos --config-get model                     # get a single value
talos --config-set model=claude-sonnet-4-20250514  # set and persist
talos --config-set providers.anthropic.api_key_env=ANTHROPIC_API_KEY

Build from source

Requirements:

cargo build --release -p talos-cli
./target/release/talos --help

To build all release artifacts locally:

./build.sh

The multi-platform build writes archives and checksums to dist/.

Cargo install status: cargo install talos-cli --bin talos is the planned crates.io binary-install shape, but it is still blocked by the publish gate. For local source testing, use cargo install --path crates/talos-cli --bin talos --locked.

Verify your install

After install, run a one-shot prompt in print mode to confirm the binary works end-to-end: 

talos -p --mock "/mock-request summarize this repository"

The mock provider gives a deterministic local response without touching a network provider. It is the same command the TUI smoke tests use to verify the runtime path before connecting to a real model.

The full release history is on the Releases page.