Install & Compatibility
Where this runs
tested against v1.5.0 · pip install
no network on importno background threads
Install × environment matrix
Each cell = how many times install + import succeeded across repeated harness runs. Partial = flaky.
glibc = Debian/Ubuntu slim · musl = Alpine Linux
muslpy 3.10–3.95 runs
installs and imports cleanly · install 0.0s · import 0.000s · 491.3MB
glibcpy 3.10–3.95 runs
installs and imports cleanly · install 23.8s · import 0.000s · 475MB
515MB installed
● package 515MB
Code
Verified usage
Verified import paths — ran on the pinned version, not inferred.
Service
✓ from cirq_ionq import Service
✗ from cirq_ionq import IonQDevice
Sampler
✓ from cirq_ionq import Sampler
Job
✓ from cirq_ionq import Job
Run a Bell state circuit on the IonQ simulator.
import cirq
from cirq_ionq import IonQSimulator
# Get API key from environment (set IONQ_API_KEY)
import os
api_key = os.environ.get('IONQ_API_KEY', '')
if not api_key:
print('Set IONQ_API_KEY environment variable')
exit(1)
simulator = IonQSimulator(api_key=api_key)
q0, q1 = cirq.LineQubit.range(2)
circuit = cirq.Circuit(cirq.H(q0), cirq.CNOT(q0, q1), cirq.measure(q0, q1))
result = simulator.run(circuit, repetitions=100)
print(result.histogram(key='0,1'))
Upgrade
Version history
1.6.1latest on PyPI · released Aug 14, 2025
Audit
Dependencies
cirq-corerequiredRequired for core Cirq functionality.