Installation

Rye ships as two local binaries:

rye: the user-facing CLI.
ryed: the background daemon that owns proxy lifecycle, local storage, policy sync, and system proxy restoration.

Install with the script

Install the latest stable release:

curl -fsSL https://storage.googleapis.com/barn.rye.ai/install.sh | sh

The installer:

Detects macOS or Linux and the local CPU architecture.
Downloads release artifacts from https://storage.googleapis.com/barn.rye.ai/releases.
Verifies each binary against the release manifest checksum.
Installs rye and ryed into a bin directory.
Installs shell completions for supported shells.
Registers ryed with launchd on macOS or a systemd user service on Linux when available.
Installs claude and codex app shims when those commands exist.

Install location

By default, the installer uses:

$HOME/.local/bin for non-root user installs.
/usr/local/bin when you pass --system or run as root.

Use --prefix to choose a different prefix:

curl -fsSL https://storage.googleapis.com/barn.rye.ai/install.sh | sh -s -- --prefix "$HOME/.rye"

Make sure the selected bin directory is on PATH.

Installer options

install.sh [stable|latest|VERSION] [--system] [--prefix PATH] [--no-persist-proxy] [--no-wrap-agents]

Use these options when piping the script through sh:

curl -fsSL https://storage.googleapis.com/barn.rye.ai/install.sh | sh -s -- latest
curl -fsSL https://storage.googleapis.com/barn.rye.ai/install.sh | sh -s -- 0.7.2
curl -fsSL https://storage.googleapis.com/barn.rye.ai/install.sh | sh -s -- --no-wrap-agents

Option	Use it when
`stable`	You want the default stable release.
`latest`	You want the newest published release.
`VERSION`	You need a specific semver release.
`--system`	You want to install under `/usr/local`.
`--prefix PATH`	You want a custom install prefix.
`--no-persist-proxy`	You do not want the installer to copy existing proxy environment variables into shell startup files.
`--no-wrap-agents`	You do not want the installer to set up `claude` and `codex` shims.

Install with Homebrew

On systems using Homebrew:

brew install ryeai/tap/rye

Start the daemon:

brew services start rye

Then sign in and start Rye:

rye auth login
rye up

Update Rye

Use the Rye updater:

rye upgrade

Pin a release:

rye upgrade 0.7.2

If you installed with Homebrew, update through Homebrew:

brew upgrade ryeai/tap/rye

Verify installation

rye version
rye daemon status
rye doctor

If rye is not found, restart your shell and confirm the install directory is on PATH.

Start here

Core concepts

Configure Rye

Operate

Installation

Install with the script

Install location

Installer options

Install with Homebrew

Update Rye

Verify installation

​Install with the script

​Install location

​Installer options

​Install with Homebrew

​Update Rye

​Verify installation

Install with the script

Install location

Installer options

Install with Homebrew

Update Rye

Verify installation