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 --versionCargo 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:
- Rust 1.95 or newer
- Cargo
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.