Bloq

Quantum workload orchestration — one SDK, every backend.

Bloq is a Python SDK by Bloq Quantum that lets you schedule and run quantum circuits across simulators, hardware providers, and the Bloq Quantum managed platform — from a single, unified interface.

Status: 0.4.0, pre-1.0. The public surface is frozen within a minor and takes bug-fix patches; breaking changes are allowed at the next minor until 1.0. estimate_cost / set_budget / spend_summary are reserved signatures that currently raise BloqCloudRequired.

What it does

Bloq sits between your circuit-authoring SDK of choice (Qiskit, Cirq, Braket, PennyLane, pytket, pyquil, QIR, raw OpenQASM, …) and the backend where the circuit actually runs (simulators or real quantum hardware). You write your circuit in whichever framework you prefer; Bloq handles transpilation, credential management, job dispatch, and result retrieval.

There are two ways to run a circuit through Bloq:

1. Direct providers — use your own API keys / credentials from IBM, AWS Braket, IonQ, Rigetti, and others. Bloq routes the job to the provider on your behalf.
2. Bloq Quantum platform — use a single Bloq API key and spend credits on any provider integrated into the Bloq platform. No per-provider accounts required.

Why Bloq?

Architecture (planned)

┌────────────────────────────────────────────────┐
│                  BloqClient                    │
│  (submit, list_backends, credentials, config)  │
├────────────────────────────────────────────────┤
│              Provider Registry                 │
│  ┌──────┐ ┌──────┐ ┌──────┐ ┌──────────────┐   │
│  │ IBM  │ │ AWS  │ │IonQ  │ │  Bloq Cloud  │   │
│  └──┬───┘ └──┬───┘ └──┬───┘ └──────┬───────┘   │
├─────┼────────┼────────┼────────────┼───────────┤
│            Circuit Transpiler / IR             │
│              (OpenQASM + adapters)             │
├─────┼────────┼────────┼────────────┼───────────┤
│               Job Scheduler                    │
│    (queue, dispatch, monitor, results)         │
└────────────────────────────────────────────────┘

Installation

pip install bloq

Bloq does not require any quantum framework to be installed. Use whichever framework you already have — Qiskit, Cirq, Braket, PennyLane, pytket, pyquil, pyqir, or none — and Bloq will work alongside it.

Optional convenience extras

If you're starting fresh and want Bloq to pull in a framework pinned to a version range we've tested against, you can use an extra:

pip install "bloq[qiskit]"          # Bloq + qiskit >=2.0,<3.0
pip install "bloq[aer]"             # Bloq + qiskit + qiskit-aer >=0.17
pip install "bloq[ibm]"             # Bloq + qiskit + qiskit-ibm-runtime >=0.45
pip install "bloq[cirq]"            # Bloq + cirq-core >=1.5
pip install "bloq[braket]"          # Bloq + amazon-braket-sdk >=1.100
pip install "bloq[pennylane]"       # Bloq + pennylane >=0.40
pip install "bloq[pytket]"          # Bloq + pytket >=2.0,<3.0
pip install "bloq[qir]"             # Bloq + pyqir >=0.12,<0.13
pip install "bloq[quantinuum]"      # Bloq + qnexus >=0.46,<0.48
pip install "bloq[iqm]"             # Bloq + iqm-client >=34.0,<36.0
pip install "bloq[all-providers]"   # Bloq + all of the above

To combine extras, comma-separate them inside one bracket (repeating the package as "bloq[qiskit]" "bloq[cirq]" is unnecessary, and older pip rejects it with "Double requirement given"):

pip install "bloq[qiskit,cirq,aer]"

Keep the quotes: in zsh the brackets are a glob pattern and an unquoted bloq[...] fails with no matches found. Installing from a git reference still works, and extras attach to it the same way, e.g. pip install "bloq[qiskit,cirq] @ git+https://github.com/bloq-quantum/bloq.git@main".

Extras are purely a convenience. If you already have a framework installed — especially one pinned by your team or another dependency — stick with plain pip install bloq and Bloq will use whatever version you have, as long as it falls inside our supported range.

Tested matrix (August 2026)

Qiskit 1.x is not supported — Bloq targets the Qiskit 2.x API. Versions outside the supported range raise UnsupportedProviderVersion at first use with a clear remediation message. BloqClient.version_report() returns the actually installed versions for easy copy-paste into bug reports.

Supported providers

Gate-model hardware and cloud services:

Neutral-atom (analog) hardware:

Local simulators:

Circuit-authoring frameworks you can hand to Bloq directly: Qiskit, Cirq, Braket, PennyLane, pytket, pyquil, QIR, Pulser, Bloqade, and raw OpenQASM 3.

Development

git clone https://github.com/bloq-quantum/bloq.git
cd bloq

python -m venv .venv
source .venv/bin/activate

pip install -e ".[dev,docs]"   # installs Bloq with dev tooling
pre-commit install

Common tasks

pytest                       # run the test suite
ruff check src/ tests/       # lint
ruff format src/ tests/      # format
mypy src/                    # type check
python -m build              # build sdist and wheel

Project layout

bloq/
├── src/bloq/              # Main package (to be populated)
├── tests/                 # Pytest test suite
├── .github/workflows/     # CI and PyPI publish workflows
├── CHANGELOG.md
├── CONTRIBUTING.md
├── LICENSE
├── README.md
└── pyproject.toml         # Build, lint, type-check, and test config

Contributing

Contributions are welcome. See CONTRIBUTING.md for setup, workflow, and pull-request guidelines.

License

Licensed under the Apache License 2.0.

Built by Bloq Quantum.