Install the Gradient CLI

How to install the Gradient Command Line Interface


The Gradient CLI is available on pypi and works on Windows, MacOS, and Linux.

The CLI requires Python 3.4+ (or Python 2.7). Be sure to use a compatible version of pip (or pip3) depending on your Python version.

Pro Tip! We highly recommend installing and using the CLI within a Python virtual environment. This will minimize conflicts with existing libraries on your computer. We recommend virtualenv. See below for more instructions.

Install the CLI

Using pip to install the latest stable release

pip install -U gradient

Using pip to install the latest prerelease

pip install -U --pre gradient

Connecting your account

You can either stash your API key on your computer or include your API key on each command.

Set your active API key

First, obtain an API Key, and then:


Alternatively, you can include your API key with each command:

gradient experiments run ... --apiKey XXXXXXXXXXXXXXXXXXX

Note: You can reveal your current API key with cat ~/.paperspace/config.json

Obtaining an API key

First, sign in to your Paperspace account. On the left of your home console, you will find an 'API' section. There, you'll find a form where you can create API keys. You'll use the API keys you generate here to authenticate your requests.

API keys section of the console (

Enable autocomplete

Add following to your .bashrc (or .zshrc) to enable autocomplete anytime you activate your shell. If gradient was installed in a virtual environment, the following has to be added to the activate script:

eval "$(_GRADIENT_COMPLETE=source gradient)"

Alternatively, you can create activation script by:

(_GRADIENT_COMPLETE=source gradient) > ~/

and then add . ~/ to your .bashrc, .zshrc or activate script.


Using a virtual environment

First, install virtualenv:

pip install virtualenv

Python 3.4+

Create new virtual environment:

python3 -m virtualenv <virtual_env_dir_path>

Activate virtual environment:

source <virtual_env_dir_path>/bin/activate

Python 2.7 (note that Python 2.7 will be deprecated in 2020) Create new virtual environment:

virtualenv <virtual_env_dir_path>

Activate virtual environment:

source <virtual_env_dir_path>/bin/activate