Installation

This guide covers every supported way to install sortie on your machine. Pick the method that fits your setup, verify the installation, and you’re ready to go.

Install Script (macOS and Linux)

The recommended method for macOS and Linux. The script detects your OS and architecture, downloads the correct binary, verifies its checksum, and places it on your PATH.

curl -sSL https://get.sortie-ai.com/install.sh | sh

By default the binary is installed to /usr/local/bin when running as root, or ~/.local/bin otherwise. If the install directory is not already on your PATH, the script prints the exact command to add it.

Script Options

Example — install a specific version to a custom directory:

SORTIE_VERSION=1.11.0 SORTIE_INSTALL_DIR=/opt/bin \
  curl -sSL https://get.sortie-ai.com/install.sh | sh

Install Script (Windows)

The recommended method for Windows. The script detects your architecture, downloads the correct binary, verifies its checksum, installs sortie.exe, and adds the install directory to your user PATH. It runs on Windows PowerShell 5.1 (the default on Windows 10 and 11) and on PowerShell 7+.

Run the one-liner in a PowerShell prompt:

irm 'https://get.sortie-ai.com/install.ps1' | iex

By default the binary is installed to %LOCALAPPDATA%\Programs\sortie, a per-user location that needs no administrator rights. The script adds that directory to your user PATH; restart any open shell sessions for the change to take effect.

Script Options

Set these as environment variables before running the one-liner:

Example — install a specific version to a custom directory:

$env:SORTIE_VERSION = '1.11.0'
$env:SORTIE_INSTALL_DIR = 'C:\tools\sortie'
irm 'https://get.sortie-ai.com/install.ps1' | iex

Homebrew (macOS and Linux)

If you use Homebrew, install Sortie from the official tap:

brew install sortie-ai/tap/sortie

The tap is added automatically on first install. To upgrade to a new release:

brew upgrade sortie

Docker

Sortie provides a Docker image at ghcr.io/sortie-ai/sortie.

See our guide on using Sortie in Docker for more details.

Download from GitHub Releases

If you prefer to download and install manually, grab the archive directly from GitHub.

tar -xzf sortie_VERSION_linux_amd64.tar.gz

Expand-Archive sortie_VERSION_windows_amd64.zip -DestinationPath .

sha256sum -c checksums.txt --ignore-missing

(Get-FileHash sortie_VERSION_windows_amd64.zip -Algorithm SHA256).Hash

install -m 755 sortie /usr/local/bin/sortie

Go Install

If you have Go 1.26+ installed, you can install directly from source:

go install github.com/sortie-ai/sortie/cmd/sortie@latest

The binary is placed in $GOPATH/bin (or $HOME/go/bin by default). Make sure that directory is on your PATH.

To pin a version:

go install github.com/sortie-ai/sortie/cmd/sortie@v1.0.0

Build from Source

For development or when you need a custom build. Requires Git and Go 1.26+.

git clone https://github.com/sortie-ai/sortie.git
cd sortie

make build

install -m 755 sortie /usr/local/bin/sortie

Verify the Installation

Confirm sortie is installed and on your PATH:

sortie --version

You should see output like:

sortie v0.x.x

Troubleshooting

Homebrew formula fails to install — The local tap may be stale. Run brew update first, then retry:

brew update
brew install sortie-ai/tap/sortie

command not found: sortie — The install directory is not on your PATH. Add it to your shell configuration file (~/.bashrc, ~/.zshrc, or ~/.config/fish/config.fish) and reload your shell:

export PATH="$HOME/.local/bin:$PATH"

sortie is not recognized (Windows) — The install script updates your user PATH, but open shells keep their old environment until you restart them. Close and reopen PowerShell, then run sortie --version again. To check that the install directory is on your user PATH:

[Environment]::GetEnvironmentVariable('Path', 'User')

Checksum mismatch — The download may have been corrupted or tampered with. Delete the file and download again. If the problem persists, open an issue.

Permission denied during install — Either run the install command with sudo, or choose a directory you own (e.g. ~/.local/bin).

Next steps

• Quick start — run Sortie end-to-end with a mock agent and local issues