Alpha. Vary is under active development and not ready for production use. Syntax, APIs, performance, and behaviour may change between releases.

Linux

Quick install

One command installs varyup (the toolchain manager) and the latest Vary toolchain.

curl -fsSL https://github.com/ccollicutt/vary/releases/latest/download/install.sh | sh

This will download varyup to ~/.vary/bin/, install the latest Vary toolchain, and install the vary compiler shim.

Then add ~/.vary/bin to your PATH. Add this line to ~/.bashrc or ~/.zshrc:

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

Restart your shell, then verify:

vary --version

You should see:

Vary vX-alpha.Y

Options

FlagEffect
--skip-toolchainSkip automatic toolchain install

Environment variables VARY_HOME (default: ~/.vary) and VARY_RELEASE_URL can override defaults.

Manual install

If you prefer not to pipe to sh, you can install manually:

1. Download varyup

mkdir -p ~/.vary/bin
curl -fSL "https://github.com/ccollicutt/vary/releases/latest/download/varyup-linux-x64" -o ~/.vary/bin/varyup
chmod +x ~/.vary/bin/varyup

2. Verify checksum

curl -fSL "https://github.com/ccollicutt/vary/releases/latest/download/SHA256SUMS" -o /tmp/SHA256SUMS
cd ~/.vary/bin && grep "varyup-linux-x64$" /tmp/SHA256SUMS | sha256sum -c -

You should see varyup-linux-x64: OK. If the check fails, delete the binary and retry the download.

3. Add to PATH

Add to ~/.bashrc or ~/.zshrc:

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

Reload your shell and install a toolchain:

source ~/.bashrc   # or: source ~/.zshrc
varyup toolchain install latest

Managing toolchains

List available versions:

varyup toolchain list-available

Install a specific version:

varyup toolchain install <version>

Short aliases are available:

varyup tc la   # list-available
varyup tc i    # install

Run varyup with no arguments to see all commands and aliases.

Install VS Code extension

Each toolchain bundles the Vary VS Code extension. Install it with:

varyup vscode install

See VS Code for full extension documentation.

Next steps

ActionLink
Manage versions, update, pin per-projectvaryup
Write your first programGetting Started
Run vary test on examplesTesting
Run vary mutate on examplesMutation testing