qbraid-cli

Command Line Interface for interacting with all parts of the qBraid platform.

Resources:

Getting Started

The qBraid-CLI comes pre-installed and pre-configured in qBraid Lab:

For help, see qBraid Lab User Guide: Getting Started.

You can also install the qBraid-CLI from PyPI with:

pip install qbraid-cli

To manage qBraid environments using the CLI, you must also install the envs extra:

pip install 'qbraid-cli[envs]'

Local configuration

After installation, you must configure your account credentials to use the CLI locally:

Create a qBraid account or log in to your existing account by visiting account.qbraid.com
Copy your API Key token from the left side of your account page:
Save your API key from step 2 in local configuration file ~/.qbraid/qbraidrc using:

$ qbraid configure

For more on API keys, see documentation.

Basic Commands

$ qbraid
----------------------------------
  * Welcome to the qBraid CLI! * 
----------------------------------

        ____            _     _  
   __ _| __ ) _ __ __ _(_) __| | 
  / _` |  _ \| '__/ _` | |/ _` | 
 | (_| | |_) | | | (_| | | (_| | 
  \__,_|____/|_|  \__,_|_|\__,_| 
     |_|                         


- Use 'qbraid --help' to see available commands.

- Use 'qbraid --version' to see the current version.

Reference Docs: https://docs.qbraid.com/v2/cli/api-reference/qbraid

A qBraid CLI command has the following structure:

$ qbraid <command> <subcommand> [options and parameters]

For example, to list installed environments, the command would be:

$ qbraid envs list

To view help documentation, use one of the following:

$ qbraid --help
$ qbraid <command> --help
$ qbraid <command> <subcommand> --help

To get the version of the qBraid CLI:

$ qbraid --version

Magic Commands

You can also access the CLI directly from within Notebooks using IPython magic commands. First, configure the qBraid magic commands extension using:

$ qbraid configure magic

The above command can also be executed from within a Jupyter notebook using the ! operator. Then, from within a notebook cell, load the qBraid magic IPython extension using:

In [1]: %load_ext qbraid_magic

Now you can continue to use the qBraid-CLI as normal from within your Jupyter notebook using the magic % operator, e.g.

In [2]: %qbraid jobs list

Metadata

Release files for qbraid-cli 0.15.1

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for qbraid-cli 0.15.1
File	Size	Uploaded
qbraid_cli-0.15.1.tar.gz	127.2 kB	Sep 9, 2026	Details

Built distribution (wheel)

Table of built distributions (wheels) for qbraid-cli 0.15.1
File	Interpreter	ABI	Platform	Reset
qbraid_cli-0.15.1-py3-none-any.whl 140.4 kB Sep 9, 2026	Python 3	none	any	Details

Total release size: 267.6 kB

Release files / qbraid_cli-0.15.1.tar.gz

Download URL	qbraid_cli-0.15.1.tar.gz
Size	127.2 kB
Tags	Source
SHA-256 checksum How to use checksums	`745799a11c96199e280bf745bdbac163d97fc8b6001b75882ac41247954246c2`
BLAKE2b-256 checksum How to use checksums	`51302a30c1d4da54cb68beadf04a57bb09d2814a3ac5d924a3e2013b43bf2346`
Upload date	Sep 9, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	No
Uploaded via	`twine/7.0.0 CPython/3.13.14`

Release files / qbraid_cli-0.15.1-py3-none-any.whl

Download URL	qbraid_cli-0.15.1-py3-none-any.whl
Size	140.4 kB
Tags	Python 3
SHA-256 checksum How to use checksums	`d7fb70388a2c98d319ca9084f194f83f24c26d9fa0399b733fd2d0570fbfff7d`
BLAKE2b-256 checksum How to use checksums	`c06fa1e5e787b4c47f44c18e3279130f3e1e77ef95ad1dfaf8ef244fcfd8d742`
Upload date	Sep 9, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	No
Uploaded via	`twine/7.0.0 CPython/3.13.14`