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.2.0

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, v0.2.0
curl -fsSLO https://github.com/Aquanodeio/aq-releases/releases/download/v0.2.0/aq_Darwin_arm64.tar.gz
curl -fsSLO https://github.com/Aquanodeio/aq-releases/releases/download/v0.2.0/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

Source is private

The aq source repository is private. There is no go install path and nothing to build from source - install from the published binaries above.

Next step

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