> ## Documentation Index
> Fetch the complete documentation index at: https://docs.qbraid.com/llms.txt
> Use this file to discover all available pages before exploring further.

> ## Agent Instructions
> Prefer the qBraid CLI for programmatic platform actions: pip install 'qbraid-cli>=0.12', then run `qbraid configure` once with an API key from https://account.qbraid.com/account/api-keys.
> Always install the latest packages (pip install -U qbraid qbraid-cli); do not pin versions from memory. qbraid-cli below 0.12.0 is incompatible with the current API.
> Device IDs use the QRN format vendor:provider:type:name (e.g. qbraid:qbraid:sim:qir-sv, rigetti:rigetti:qpu:cepheus-1-108q). Legacy underscore IDs are deprecated.
> The REST API base URL is https://api-v2.qbraid.com/api/v1, authenticated with an X-API-Key header.
> Free simulators cost no credits; QPU and GPU jobs consume credits. Surface the estimated cost to the user before submitting a paid job.
> For account signup, API keys, credits, and end-to-end action recipes, see https://qbraid.com/llms.txt.

# Overview

<div style={{ display: "flex", justifyContent: "center", alignItems: "center" }}>
  <img src="https://mintcdn.com/qbraidco/QULd4SW4jpedhfda/v2/cli/_static/cli_banner.png?fit=max&auto=format&n=QULd4SW4jpedhfda&q=85&s=81aab3848b35485700702c664e2afa3d" alt="qBraid-CLI" style={{ width: "200", height: "auto", margin: "0" }} className="block dark:hidden" width="3840" height="640" data-path="v2/cli/_static/cli_banner.png" />

  <img src="https://mintcdn.com/qbraidco/oaKSHMFAnH5HdzF8/v2/cli/_static/cli_banner_dark.png?fit=max&auto=format&n=oaKSHMFAnH5HdzF8&q=85&s=b73f57685f9038bc36c1ae595035e62f" alt="qBraid-CLI" style={{ width: "200", height: "auto", margin: "0" }} className="hidden dark:block" width="3840" height="640" data-path="v2/cli/_static/cli_banner_dark.png" />
</div>

<div style={{ textAlign: "center", marginTop: "-8px" }}>
  *Universal command line interface for interacting with all parts of the qBraid
  platform.*
</div>

The **qBraid CLI** is a versatile command-line interface tool designed for seamless interaction
with qBraid cloud services and quantum software management tools.

## Getting Started

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

* [Launch qBraid Lab →](https://lab.qbraid.com/)
* [Make an account →](https://account.qbraid.com/)

For help, see qBraid Lab User Guide: [Getting Started](/v2/lab/user-guide/getting-started).

### Local Setup

If you prefer to use qBraid-CLI on your local machine, you can install it from PyPI with:

```bash theme={null}
pip install qbraid-cli
```

<Warning>
  qbraid-cli versions \<0.12 are *not* compatible with qBraid API V2. See [migration guide](/v2/api-reference/rest/migration).

  To ensure compatibility with the new platform, use **qbraid-cli** ≥ 0.12.0.
</Warning>

To manage qBraid [environments](/v2/lab/user-guide/environments) using the CLI, you must also install the `envs` extra:

```bash theme={null}
pip install 'qbraid-cli[envs]'
```

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

1. Create a qBraid account or log in to your existing account by visiting
   [account.qbraid.com](https://account.qbraid.com/)
2. Navigate to **Account** > **API Keys** in the left-sidebar, and then click "Create API Key".
3. Save your API key from step 2 in local configuration file `~/.qbraid/qbraidrc` using:

```bash theme={null}
$ qbraid configure
```

**Important for Windows Users:**

If you encounter a warning like:

```bash theme={null}
WARNING: The script qbraid.exe is installed in 'C:\Users\<YourUsername>\AppData\Local\Packages\PythonSoftwareFoundation.Python.<version>\LocalCache\local-packages\Python<version>\Scripts' which is not on PATH.
```

You need to add the directory containing qbraid.exe to your system's PATH.

1. Copy the directory path provided in the warning.
2. Follow these steps:

* Open the Start Menu, search for "Environment Variables," and select "Edit the system environment variables."
* In the System Properties window, click the Environment Variables button.
* Under "User variables," locate the Path variable, click Edit, and add the copied directory.

3. Save the changes and restart your terminal.

## Basic Commands

```bash theme={null}
$ 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:

```bash theme={null}
$ qbraid <command> <subcommand> [options and parameters]
```

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

```bash theme={null}
$ qbraid envs list
```

To view help documentation, use one of the following:

```bash theme={null}
$ qbraid --help
$ qbraid <command> --help
$ qbraid <command> <subcommand> --help
```

For example:

```bash theme={null}
$ qbraid --help

Usage: qbraid [OPTIONS] COMMAND [ARGS]...

The qBraid CLI — A unified interface for AI agents, quantum computing,
Python environments, and cloud compute.

Options
  --version  -v                 Show the version and exit.
  --install-completion          Install completion for the current shell.
  --show-completion             Show completion for the current shell, to copy it or customize the installation.
  --help     -h                 Show this message and exit.

Commands
  admin                         CI/CD commands for qBraid maintainers.
  agents                        Manage AI coding agent sessions.
  compute                       Manage cloud compute and SSH.
  lab                           Launch qBraid Lab (JupyterLab).
  configure                     Configure CLI settings.
  account                       Manage qBraid account.
  devices                       Browse quantum devices.
  jobs                          Submit and track quantum computing jobs.
  projects                      Browse and install qBraid Hub projects.
  skills                        Create, install, and share AI coding skills.
  troubleshoot                  Diagnose qBraid platform issues.
  envs                          Manage Python environments.
  kernels                       Add, remove, and repair Jupyter kernels.
  pip                           Run pip command in active qBraid environment.
```

To get the version of the qBraid CLI:

```bash theme={null}
$ qbraid --version
```