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/qbraidrcusing:
$ 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
Agent updates
Send yourself Slack or email updates and read Slack replies using existing qBraid credentials:
qbraid comms slack send "Tests passed" --json
qbraid comms email send --subject "Progress" --file report.txt --json
qbraid comms slack read --json
See communication commands for Slack connection, stdin input, message limits, and pagination.
Release files for qbraid-cli 0.16.15
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | Provenance | |
|---|---|---|---|---|
| qbraid_cli-0.16.15.tar.gz | 162.8 kB | Without provenance | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| qbraid_cli-0.16.15-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 342.4 kB
Release files / qbraid_cli-0.16.15.tar.gz
| Download URL | qbraid_cli-0.16.15.tar.gz |
|---|---|
| Size | 162.8 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
1892bd8556ad123e8fb73a69d3f6b9909cf2f490ea82875a13de348036031e80
|
|
BLAKE2b-256 checksum How to use checksums |
62f694a6d05101e67d2ea519f68eda751c8dc6fd87ea1044ac65733948f12c08
|
| Upload date | |
|
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.15-py3-none-any.whl
| Download URL | qbraid_cli-0.16.15-py3-none-any.whl |
|---|---|
| Size | 179.6 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
9581a9de8739cb016f66468297f89e2d8914809ee1e59d1efd67c5b686b9bc09
|
|
BLAKE2b-256 checksum How to use checksums |
62d3d6b6e2c7812a9901abf02d06e2825224a88e107c04b5df458d86f858b46b
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/7.0.0 CPython/3.13.14
|
Security for qbraid-cli 0.16.15
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
No provenance found
None of the files in this release were uploaded with provenance metadata.
A note on package security
PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.
