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

# Open Quantum

> Connect your Open Quantum account to qBraid to run quantum jobs on your own Open Quantum credits.

The Open Quantum integration lets you run quantum jobs on Open Quantum devices through qBraid, paid for with your own [Open Quantum](https://www.openquantum.com/) credits. Open Quantum devices can only be billed to Open Quantum credits, so you need to connect your Open Quantum account before you can run jobs on them.

<Warning>
  **"Free" means free of qBraid credits, not free of charge.** Open Quantum
  devices are listed as free on qBraid because running a job on one costs you no
  qBraid credits. The job is instead billed to the Open Quantum account you
  connect below, drawing down that account's credit balance. You can top that
  balance up by buying credits, or claim [free Spark
  credits](#claim-your-free-spark-credits) through Open Quantum's promotional
  offerings.
</Warning>

You manage the connection from the **Integrations** tile on your [Profile page](https://account.qbraid.com/account/profile).

<Frame caption="The Integrations tile on your Profile page.">
  <img src="https://storage.googleapis.com/qbraid-static-assets/qbraid-docs/account/openquantum-profile-page.png" alt="qBraid Profile page with the Integrations tile highlighted" />
</Frame>

<Note>
  You need an [Open Quantum](https://www.openquantum.com/) account before you
  can connect. It doesn't have to match the email you use for qBraid, any Open
  Quantum account works.
</Note>

## Create your Open Quantum account

Set up Open Quantum first, so the account exists when you connect it to qBraid.

<Steps>
  <Step title="Go to Open Quantum">
    Open [openquantum.com](https://www.openquantum.com/).
  </Step>

  <Step title="Create an account">
    Sign up for an Open Quantum account. Google sign-in is supported.
  </Step>

  <Step title="Finish sign-up">
    Complete any remaining onboarding steps on the Open Quantum side.
  </Step>
</Steps>

## Claim your free Spark credits

When you sign in to your new Open Quantum account, a welcome banner greets you
with an offer of free compute credits, while supplies last. Click **Claim \$50
Free Credit** to add them to your Open Quantum account. These arrive as **Spark**
credits, Open Quantum's free and promotional credits, which
[expire](https://docs.openquantum.com/concepts/credits/) 90 days after they're
granted.

<Frame caption="The welcome banner on openquantum.com with the Claim $50 Free Credit button.">
  <img src="https://storage.googleapis.com/qbraid-static-assets/qbraid-docs/account/openquantum-free-credits.png" alt="Open Quantum homepage showing a welcome banner with a Claim $50 Free Credit button" />
</Frame>

Once you connect your account to qBraid below, jobs you submit to Open Quantum
devices through qBraid are billed against these credits.

## Connect Open Quantum to qBraid

<Steps>
  <Step title="Sign in to qBraid">
    Go to [account.qbraid.com](https://account.qbraid.com/) and sign in.
  </Step>

  <Step title="Open your Profile">
    Click your name and avatar at the bottom of the sidebar, or use **Account >
    Profile**.
  </Step>

  <Step title="Find the Integrations tile">
    Scroll down to the **Integrations** tile, below Personal Information. A grey
    dot next to **Open Quantum** means it isn't connected yet.

    <div style={{ maxWidth: "75%", margin: "0 auto" }}>
      <Frame caption="Before connecting: a grey status dot and a Connect button.">
        <img src="https://storage.googleapis.com/qbraid-static-assets/qbraid-docs/account/openquantum-integration-tile-disconnected.png" alt="Open Quantum tile showing a grey status dot and a Connect button" style={{ borderRadius: "12px" }} />
      </Frame>
    </div>
  </Step>

  <Step title="Click Connect">
    This opens the Open Quantum authentication window.
  </Step>

  <Step title="Sign in on the Open Quantum side">
    Sign in with your Open Quantum account. The window closes automatically once
    you're authenticated.
  </Step>
</Steps>

## Confirm the connection

Back on the Profile page, the **Open Quantum** entry now shows a green
**Connected** dot along with the account you're connected as. That's it, jobs
submitted to Open Quantum devices will now run on your Open Quantum credits.

<div style={{ maxWidth: "75%", margin: "0 auto" }}>
  <Frame caption="After connecting: a green Connected dot and a Disconnect button.">
    <img src="https://storage.googleapis.com/qbraid-static-assets/qbraid-docs/account/openquantum-integration-tile-connected.png" alt="Open Quantum tile showing a green Connected dot, the connected account, and a Disconnect button" style={{ borderRadius: "12px" }} />
  </Frame>
</div>

## Disconnect Open Quantum

To end the integration, open the **Integrations** tile and click **Disconnect**
next to **Open Quantum**. Once disconnected, you can no longer run jobs on
Open Quantum devices until you connect again, since those jobs can only be paid
for with your Open Quantum credits.

## Troubleshooting

<AccordionGroup>
  <Accordion title="Insufficient Open Quantum credits" icon="coins">
    This is the most common error. It means your Open Quantum balance can't
    cover the job, usually for one of these reasons:

    * You never claimed the \$50 of free Spark credits offered when you signed up.
    * You've spent the credits you had.
    * Your credits expired before you used them.
    * You're waiting on your next Promotional Credits refill.

    Check your balance on the [Open Quantum billing
    page](https://www.openquantum.com/settings/billing). **Credit Balance**
    shows your **Spark** and **Full** credits separately, along with the date
    your earliest Spark credits expire. Spark credits are the free and
    promotional ones, and expire 90 days after they're granted; Full credits are
    the ones you purchase, and expire after 12 months. Jobs spend your Spark
    credits first, then your Full credits. **Credit Transactions** below it
    itemizes every consumption, promotion, and expiration, so you can see
    exactly where your credits went.

    To top up, click **Add Credits** to reach the [Buy
    Credits](https://www.openquantum.com/buy-credits) page, where you can
    purchase Full credits in bundles. Otherwise, wait for your next Promotional
    Credits refill.
  </Accordion>

  <Accordion title="My jobs still fail after connecting" icon="triangle-exclamation">
    Open the **Integrations** tile and confirm **Open Quantum** shows a green
    **Connected** dot. If it's grey, click **Connect** and finish signing in on
    the Open Quantum side. Also check that your Open Quantum account has credits
    available.
  </Accordion>

  <Accordion title="The Connect button doesn't open a window" icon="window-restore">
    Check that your browser isn't blocking pop-ups for `account.qbraid.com`,
    then try again.
  </Accordion>

  <Accordion title="I still need help" icon="life-ring">
    Reach out from the **Support** link in the sidebar and we'll take a look at
    your job history.
  </Accordion>
</AccordionGroup>

## Related links

* [qBraid on Open Quantum](https://www.openquantum.com/frameworks/qbraid)
* [Open Quantum qBraid documentation](https://docs.openquantum.com/qbraid/overview/)
* [Open Quantum credits: Spark vs Full](https://docs.openquantum.com/concepts/credits/)