Install¶

ravix ships prebuilt binaries for macOS and Linux (amd64 + arm64). Pick whichever install method matches your setup.

Homebrew¶

brew install ravi-hq/tap/ravix

This adds the ravi-hq tap and installs the formula. Upgrades follow the usual brew upgrade.

One-shot installer¶

curl -fsSL https://downloads.ravi.id/ravix/install.sh | sh

The script resolves your platform, downloads the matching tarball from Cloudflare R2, verifies its SHA256 against latest.json, and drops ravix into /usr/local/bin — falling back to ~/.local/bin if that isn't writable.

Environment overrides¶

Variable	Default	Purpose
`RAVIX_VERSION`	latest	Pin a specific version, e.g. `0.27.1`.
`RAVIX_PREFIX`	`/usr/local`	Install under `$PREFIX/bin`.
`RAVIX_BASE_URL`	`https://downloads.ravi.id/ravix`	Override the download host (e.g. for an internal mirror).

Manual download¶

All release artifacts live under https://downloads.ravi.id/ravix/v<version>/. The rolling manifest https://downloads.ravi.id/ravix/latest.json always points at the most recent release, with per-platform SHA256s.

VER=0.27.1
BASE="https://downloads.ravi.id/ravix/v${VER}"
curl -L "${BASE}/ravix-${VER}-darwin-arm64.tar.gz" | tar xz
curl -L "${BASE}/checksums.txt" | grep darwin-arm64 | shasum -a 256 -c -
sudo mv ravix /usr/local/bin/
ravix --version

From source¶

Requires Go 1.25 or later.

git clone https://github.com/ravi-hq/ravix.git
cd ravix
make build API_URL=https://ravi.id
./bin/ravix --version

API_URL is required — it's injected via ldflags into the binary.

Verify¶

ravix --version
# → ravix v0.27.1 (commit: ..., built: ..., api: https://ravi.id)

Then head to Quick start.