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

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.3
File	Size	Uploaded
qbraid_cli-0.15.3.tar.gz	130.5 kB	Sep 16, 2026	Details

Built distribution (wheel)

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

Total release size: 274.7 kB

Release files / qbraid_cli-0.15.3.tar.gz

Download URL	qbraid_cli-0.15.3.tar.gz
Size	130.5 kB
Tags	Source
SHA-256 checksum How to use checksums	`34d667c8008faff6c85d3a8b4fa8acbe2f7e04ceef013a249b5d78216ae8df7a`
BLAKE2b-256 checksum How to use checksums	`f0ae9fd436b3cedaaf3edf6e83d9c32358819f05cf042419aebb7a7108467958`
Upload date	Sep 16, 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.3-py3-none-any.whl

Download URL	qbraid_cli-0.15.3-py3-none-any.whl
Size	144.2 kB
Tags	Python 3
SHA-256 checksum How to use checksums	`7cb6df243acc73f98d6fb2c1fef4a2377ee259b3974936e89e2fa31af846669d`
BLAKE2b-256 checksum How to use checksums	`9524d6daac6169bee26ea6e9ba7207190229cb10515c65e3fecf9eeba2f1c7d6`
Upload date	Sep 16, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	No
Uploaded via	`twine/7.0.0 CPython/3.13.14`