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

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.16.0
File	Size	Uploaded
qbraid_cli-0.16.0.tar.gz	131.5 kB	Sep 18, 2026	Details

Built distribution (wheel)

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

Total release size: 276.7 kB

Release files / qbraid_cli-0.16.0.tar.gz

Download URL	qbraid_cli-0.16.0.tar.gz
Size	131.5 kB
Tags	Source
SHA-256 checksum How to use checksums	`625a1743037b91468e0c114a7a363a5e4b2b44b308d46d7360a44d40415ae05c`
BLAKE2b-256 checksum How to use checksums	`d3069d9b65215f5028878a743d5473812d9c41c8e086d0974c317ae9e6efb52a`
Upload date	Sep 18, 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.16.0-py3-none-any.whl

Download URL	qbraid_cli-0.16.0-py3-none-any.whl
Size	145.2 kB
Tags	Python 3
SHA-256 checksum How to use checksums	`63f8acf0edc2ac93449f15c75b5531d1c98f8036b3d425f0087eb9646be33e99`
BLAKE2b-256 checksum How to use checksums	`0be8e184947cf6b73a6a62d858789cc3e86223f422c6197046c9c3c3c99e0238`
Upload date	Sep 18, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	No
Uploaded via	`twine/7.0.0 CPython/3.13.14`