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.10.1. Cargo install is also available from crates.io; registry publication follows each GitHub release.

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.10.1 sh
~/.talos/bin/talos --version

For Windows x86_64 PowerShell:

$env:TALOS_VERSION = 'v0.10.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.10.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

Install with Cargo

Version 0.10.1 is available on crates.io. This compiles locally and requires a Rust toolchain and platform build tools; use the release archives to avoid compilation. The repository uses Rust 1.99.0.

cargo install talos-cli --version 0.10.1 --bin talos --locked
talos --version

Cargo installs into ~/.cargo/bin by default. Ensure it is on PATH; use where.exe talos on Windows or command -v talos on Unix if another installation is selected.

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 --locked installs the latest available registry version. Version 0.10.1 is published; check cargo info talos-cli before pinning a newer version. A GitHub tag alone does not confirm registry availability. 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.