qiskit-ionq

library1.0.2pypypi✓ verified 88d ago

Qiskit provider for IonQ backends, enabling users to run quantum circuits on IonQ's trapped-ion quantum computers via the IonQ API. Current version: 1.0.2, requires Python >=3.10 and Qiskit >=2.0. Releases are on-demand.

ai-ml

pip install qiskit-ionq

github ↗package ↗homepage ↗

INSTALL

IMPORT

SIG · QISKIT-IONQ

qiskit-ionq

ai-mlpythonv1.0.2

harness data pending

Install & Compatibility

Where this runs

No compatibility data collected yet for this library.

Code

Verified usage

Verified import paths — ran on the pinned version, not inferred.

IonQProvider

✓ from qiskit_ionq import IonQProvider

✗ from qiskit_ionq.providers import IonQProvider

IonQProvider is a top-level export in qiskit_ionq, not in a submodule.

IonQBackend

✓ from qiskit_ionq import IonQBackend

✗ from qiskit.providers.ionq import IonQBackend

IonQBackend is exported from qiskit_ionq directly; it is not part of Qiskit's core providers.

Runs a Bell state circuit on the IonQ simulator backend. Requires IONQ_API_TOKEN environment variable.

from qiskit_ionq import IonQProvider from qiskit import QuantumCircuit # Initialize provider with your API token from environment variable provider = IonQProvider(token=os.environ.get('IONQ_API_TOKEN', 'your_token_here')) # Get backend backend = provider.get_backend('ionq_simulator') # Create a simple Bell state circuit qc = QuantumCircuit(2, 2) qc.h(0) qc.cx(0, 1) qc.measure([0, 1], [0, 1]) # Run the circuit job = backend.run(qc, shots=1024) print(job.result().get_counts())

Debug

Known issues

breakingVersion 1.0.0+ requires Qiskit >=2.0. Older versions of qiskit-ionq (0.x) are incompatible with Qiskit >=2.0. Upgrade both together.

fix

Upgrade Qiskit to 2.x and qiskit-ionq to 1.x: pip install 'qiskit>=2.0' 'qiskit-ionq>=1.0.0'

affects: <1.0.0

breakingThe `run` method now expects circuits to be in a Qiskit `QuantumCircuit` object, not a list of `Instruction` or `Operation` objects.

fix

Ensure you pass circuits as `QuantumCircuit` instances: `backend.run(qc)`

affects: >=1.0.0

gotchaIonQProvider accepts a token via constructor parameter or environment variable IONQ_API_TOKEN. Not providing either will raise an authentication error.

fix

Set the IONQ_API_TOKEN environment variable or pass token='your_token' to IonQProvider.

affects: all

Errors

Common errors & fixes

ImportError: cannot import name 'IonQProvider' from 'qiskit_ionq'

Using an outdated version (<1.0.0) where the class was named differently or not exported.

fix

Upgrade to the latest version: pip install --upgrade qiskit-ionq

TypeError: backend.run() got an unexpected keyword argument 'circuits'

Passing circuits as keyword argument 'circuits' instead of positional argument.

fix

Use `backend.run(circuit, shots=1024)` instead of `backend.run(circuits=circuit, ...)`.

qiskit_ionq.exceptions.IonQAuthenticationError: 401 Client Error: Unauthorized

Missing or invalid API token.

fix

Set the IONQ_API_TOKEN environment variable or pass a valid token to IonQProvider.

Upgrade

Version history

1.0.2latest on PyPI · released Aug 30, 2025

Audit

Dependencies

qiskitrequiredCore dependency for quantum circuit construction and transpilation.

requestsrequiredHTTP client for IonQ API calls.

matplotliboptionalUsed for optional visualization features.

Agent activity

5 hits · last 30 days

node

OpenAI (training)

Resources

githubhttps://github.com/qiskit-community/qiskit-ionq ↗

packagehttps://pypi.org/project/qiskit-ionq/ ↗

homepagehttps://ionq.com ↗