Skip to content

Installation & Authentication

To run qBraid circuits on Open Quantum hardware you need a qBraid account, an Open Quantum account, and a one-time link between them.

1. Create accounts

  • Open Quantum — sign up at openquantum.com. Every new account includes $50 in free compute credits.
  • qBraid — sign up at qbraid.com.

2. Connect

Account linking is a one-time step done from qBraid's website:

  1. Open the qBraid dashboard.
  2. Navigate to your profile.
  3. In the Integrations field, select Open Quantum and follow the prompts to authorize the link.

3. Credentials

In a Local Environment (e.g. VS Code)

Install the qBraid SDK and provide your qBraid API key. You can find or generate the key in your qBraid account settings.

pip install qbraid

from qbraid.runtime import QbraidProvider

provider = QbraidProvider(api_key="YOUR_QBRAID_API_KEY")

In qBraid Lab

In qBraid Lab, the qBraid SDK is preinstalled and your qBraid API key is detected automatically, so you can skip entering credentials:

from qbraid.runtime import QbraidProvider

provider = QbraidProvider()  # API key auto-detected in qBraid Lab

The same code runs in qBraid Lab and locally; the only difference is whether the API key is auto-detected or supplied explicitly.

Credits

Open Quantum jobs submitted through qBraid are billed to your Open Quantum account. You do not need qBraid credits to run them. To check your Open Quantum balance or top up, visit your Open Quantum account. For how credit cost is calculated per backend and shot count, see Credits & Pricing.

Next Steps