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

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.2
File	Size	Uploaded
qbraid_cli-0.15.2.tar.gz	128.6 kB	Sep 11, 2026	Details

Built distribution (wheel)

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

Total release size: 270.9 kB

Release files / qbraid_cli-0.15.2.tar.gz

Download URL	qbraid_cli-0.15.2.tar.gz
Size	128.6 kB
Tags	Source
SHA-256 checksum How to use checksums	`904253a0423a7bed648ff230d1cced95050241a18d4c2735e6e2e2f62dad70b2`
BLAKE2b-256 checksum How to use checksums	`6219045550e242d9181708f1c8f8161ac82b9cbdfe534d428aa37c061a507518`
Upload date	Sep 11, 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.2-py3-none-any.whl

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