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.9.0 SORTIE_INSTALL_DIR=/opt/bin \
  curl -sSL https://get.sortie-ai.com/install.sh | sh

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 manually, or you’re on a platform the install script doesn’t cover (like Windows), 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"

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