Get Quantum CLI
See what we're up to: Runway is here! 🚀

quantum-cli Basics #

Install #

Download the quantum-cli binary for your system, or use the Docker image at r.planetary-quantum.com/quantum-public/cli:2.

Configuration #

The user and password can either be given on the command line:

$ quantum-cli --user foo --password bar endpoints ls

or you can

  • set the QUANTUM_USER and QUANTUM_PASSWORD env variables
  • or create a ~/.config/quantum/env file:
QUANTUM_USER=your-user-account
QUANTUM_PASSWORD=your-password

Basics #

$ quantum-cli help # (and -h after a subcommand) shows a short usage help
$ quantum-cli selfupdate # will update to the latest version

$ quantum-cli endpoints ls # the command to try first, should show all
$                          # the nodes you have access to

$ quantum-cli stack ls --endpoint foo # all stacks on that endpoint

Creating/Updating stacks #

This is described in detail on its own page.

Just some additional notes: .quantum files can be validated by running:

$ quantum-cli validate
$ # or
$ quantum-cli validate --project /some/dir/

A debug log is also available:

$ DEBUG=1 quantum-cli ...commands as usual...

Docker Image #

We make a docker image containing quantum-cli available at r.planetary-quantum.com/quantum-public/cli:2.

That image also contains some additional tools so you can use it directly even if you have build/publish steps:

  • docker (for docker build and docker login/docker push)
  • git
  • make, and jq

Example usage would be something like:

$ docker run -it --rm \
    -e QUANTUM_USER=foo -e QUANTUM_PASSWORD=bar \
    r.planetary-quantum.com/quantum-public/cli:2 \
    quantum-cli endpoints ls