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

# Overview

<div style={{ display: "flex", justifyContent: "center", alignItems: "center" }}>
  <img src="https://mintcdn.com/qbraidco/MWMLuPZDp_BcNo9C/core/_static/core_banner.png?fit=max&auto=format&n=MWMLuPZDp_BcNo9C&q=85&s=6b860257852ac91f6c2e2747eb72d293" alt="qBraid-CORE" style={{ width: "200", height: "auto", margin: "0" }} width="3840" height="640" data-path="core/_static/core_banner.png" />
</div>

<div style={{ textAlign: "center", marginTop: "-8px" }}>
  *Python client for developing software with qBraid cloud services*
</div>

qBraid-CORE is a Python library providing core abstractions for software development within the qBraid ecosystem, and a low-level interface to a growing array of qBraid cloud services. The qbraid-core package forms the foundational base for the [qBraid CLI](https://pypi.org/project/qbraid-cli/), the [qBraid SDK](https://pypi.org/project/qbraid/), and the
[jupyter-environment-manager](https://pypi.org/project/jupyter-environment-manager/).

You can find the latest, most up to date, documentation [here](https://sdk.qbraid.com/qbraid-core/), including a list of services that are supported.

## Getting Started

You can install qbraid-core from PyPI with:

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

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

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

### Local configuration

After installing qbraid-core, you must configure your account credentials:

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](/v2/cli/user-guide/config-files) `~/.qbraid/qbraidrc`, where `~` corresponds to your home (`$HOME`) directory:

```ini theme={null}
[default]
api-key = YOUR_KEY
url = https://api-v2.qbraid.com/api/v1
```

Or generate your `~/.qbraid/qbraidrc` file via the qbraid-core Python interface:

```python theme={null}
>>> from qbraid_core import QbraidSessionV1
>>> session = QbraidSessionV1(api_key='API_KEY')
>>> session.save_config()
```

Other credential configuration methods can be found [here](/v2/cli/user-guide/overview#local-setup).

### Verify setup

After configuring your qBraid credentials, verify your setup by running the following from a Python interpreter:

```python theme={null}
>>> from qbraid_core.services.runtime import QuantumRuntimeClient
>>> quantum_client = QuantumRuntimeClient()
>>> device_list = quantum_client.list_devices()
>>> for device in device_list:
...     print(device.qrn)
```

## Community

* For feature requests and bug reports: [Submit an issue](https://github.com/qBraid/qBraid-Lab/issues)
* For discussions and/or specific questions about qBraid services, [join our discord community](https://discord.gg/KugF6Cnncm)
* For questions that are more suited for a forum, post to [Stack Overflow](https://stackoverflow.com/) with the [`qbraid`](https://stackoverflow.com/questions/tagged/qbraid) tag.