Install the CLI

aq is Aquanode's control CLI. It runs on your laptop and talks to the Aquanode API to rent a GPU, provision the box, and bring up a working environment or restore a snapshot - turning that workflow into one-command deploys.

Install

Run the install script

curl -fsSL https://github.com/Aquanodeio/aq-releases/releases/latest/download/install.sh | sh

This downloads the right binary for your OS/arch from the latest GitHub Release, verifies its SHA-256 checksum, and installs aq to /usr/local/bin (or ~/.local/bin if that isn't writable).

Overrides

AQ_VERSION pins a specific release tag instead of latest. AQ_BIN_DIR sets the install directory.

Verify the install

aq version

aq 0.3.1

Alternative: direct download

If you'd rather not pipe a script to sh, download a platform tarball directly from the aq-releases page - each release publishes a tarball per OS/arch plus a checksums.txt.

# Example: macOS arm64, latest release
curl -fsSLO https://github.com/Aquanodeio/aq-releases/releases/latest/download/aq_Darwin_arm64.tar.gz
curl -fsSLO https://github.com/Aquanodeio/aq-releases/releases/latest/download/checksums.txt

# Verify the checksum
shasum -a 256 -c <(grep aq_Darwin_arm64.tar.gz checksums.txt)

# Unpack and install
tar -xzf aq_Darwin_arm64.tar.gz
sudo mv aq /usr/local/bin/aq

Building from source

aq's source is public at github.com/Aquanodeio/aq. With a Go toolchain (1.26+) you can skip the release binaries entirely:

go install github.com/Aquanodeio/aq@latest

Next step

Pair the CLI to your Aquanode account and bring up your first box - see the Quickstart.