Installation

Tachyon is distributed as a single self-contained binary of roughly 12 MB. There is no runtime to install alongside it — no Node, no Python, no container.

Linux

curl -fsSL https://tachyon.feyncode.com/install.sh | sh

The script detects your architecture (x64 or ARM64), drops the binary in a user-writable location, and puts it on your PATH. No root required.

macOS

Homebrew is the shortest path and keeps upgrades in the usual place:

brew install feyncode/tap/tachyon

The POSIX install script works equally well if you would rather not use Homebrew:

curl -fsSL https://tachyon.feyncode.com/install.sh | sh

Windows

Native PowerShell installer:

irm https://tachyon.feyncode.com/install.ps1 | iex

Direct downloads

For air-gapped machines or CI images that should pin an exact build, grab the asset directly from the release:

On Linux and macOS the asset is the raw binary — mark it executable and move it onto your PATH. On Windows it is a graphical installer, which registers an uninstaller and handles PATH for you; a bare .exe would only run once on double click.

Upgrading

Tachyon updates itself:

tachyon upgrade

Use --check to report whether an update exists without installing anything — handy in a shell prompt or a CI guard — and --force to reinstall the latest build even if you are already on it.

tachyon upgrade --check

Homebrew installs should upgrade through Homebrew (brew upgrade tachyon) so the two do not disagree about which binary is authoritative.

Verifying the install

tachyon doctor

This reports what Tachyon can actually see: which config files it loaded, which provider keys are present, whether MCP servers connect, and — importantly — whether a sandbox backend is available. If doctor says sandboxing is unavailable, the agent is running unconfined; see Permissions & sandboxing before granting it broad autonomy.