cirq-ionq
A Cirq package to simulate and connect to IonQ quantum computers
What it is and what it does
Cirq-IonQ is a bridge between Google's Cirq quantum programming framework and IonQ's quantum computers. It lets you write quantum algorithms using Cirq's abstractions and execute them on IonQ hardware, rather than only on simulators. The package depends on cirq-core and requests, and is built for NISQ (noisy intermediate-scale quantum) devices where hardware details matter for achieving good results.
You use it by defining a quantum circuit in Cirq, then submitting it to IonQ through the integration module's service interface. The package handles the translation between Cirq's circuit representation and IonQ's API, managing authentication and job submission. It's actively maintained, supports Python 3.11 through 3.14, and has no known security vulnerabilities.
Use it for:
- Run Cirq-written quantum algorithms on real IonQ quantum hardware instead of local simulators.
- Prototype quantum applications that require trapped-ion quantum computers for their specific qubit properties.
- Benchmark quantum circuit performance on IonQ devices as part of a larger Cirq-based research workflow.
- Integrate IonQ quantum execution into a hybrid classical-quantum application built with Cirq.
- Access IonQ's quantum computers from a Python environment without learning a separate SDK.
Worth the install?
AI-flagged interpretation of the facts on this page — verify before relying
Integrates Cirq quantum circuits with IonQ quantum computers, enabling you to write quantum algorithms in Cirq and execute them on IonQ hardware.
Yes, if you are already using Cirq and need access to IonQ quantum hardware. The package has low install friction, is actively maintained, carries a permissive license, and integrates cleanly with Cirq's ecosystem. It is not necessary if you only need local quantum simulation or are not targeting IonQ devices.
Install
cirq-ionq on PyPI
pip
pip install cirq-ionquv
uv add cirq-ionqpoetry
poetry add cirq-ionqInstalling cirq-ionq
Before you install
Low friction installation with only two runtime dependencies (requests and cirq-core). The package is actively maintained with recent releases, and supports modern Python versions (3.11–3.14).
License in practice
Licensed under Apache-2.0 (permissive), so you can use, modify, and distribute the package freely with minimal restrictions.
Quickstart
pip install cirq-ionq
import cirq
from cirq_ionq import IonQSimulatorService
# Create a simple quantum circuit
q0, q1 = cirq.LineQubit.range(2)
circuit = cirq.Circuit(cirq.H(q0), cirq.CNOT(q0, q1))
# Access IonQ service (requires authentication)
service = IonQSimulatorService()
Requires IonQ API credentials and access to IonQ devices; see the package documentation for authentication setup.
Verify before relying
- Whether the package supports all current IonQ device types and capabilities
- Specific performance characteristics or latency when executing circuits on IonQ hardware
- Cost or quota implications of using IonQ devices through this integration
Package facts
| License | Apache-2.0 (permissive) |
| Python support | supports the current Python release (>=3.11.0) |
| Install friction | low — pure-Python wheel |
| Runtime dependencies | 2 — requests, cirq-core |
| Maintenance | actively maintained — 46 days since the last release |
| Last repo commit | |
| First released | |
| Downloads | 155,344/month — #10,822 on PyPI (30-day window, as of 2026-08-14) |
| Known vulnerabilities | none known (OSV.dev, checked 2026-08-14) |
Evidence: cirq_ionq-1.7.0-py3-none-any.whl
Keywords: algorithms, api, cirq, google, google quantum, nisq, python, quantum, quantum algorithms, quantum circuit, quantum circuit simulator, quantum computer simulator, quantum computing, quantum development kit, quantum information, quantum programming, quantum programming language, quantum simulation, sdk, simulation
Tags
More Python Modules packages
Converts domain names between Unicode and…
permissive · top 100 on PyPI
setuptoolsSetuptools is a Python build backend and…
permissive · top 100 on PyPI
PyYAMLPyYAML parses and emits YAML 1.1 data format,…
permissive · top 100 on PyPI
pydanticPydantic validates Python data structures…
permissive · top 100 on PyPI
annotated-typesProvides reusable metadata objects for use with…
permissive · top 100 on PyPI
typing-inspectionProvides runtime tools to inspect and…
permissive · top 100 on PyPI
cirq-aqtCirq-AQT provides a Cirq integration that lets…
permissive · top 15,000 on PyPI
cirq-googleProvides access to Google's Quantum Computing…
permissive · top 15,000 on PyPI
cirq-pasqalCirq-Pasqal is a Cirq integration module that…
permissive · top 15,000 on PyPI
cirq-coreCirq-core provides the foundational framework…
permissive · top 15,000 on PyPI
qiskit-ionqQiskit IonQ Provider enables submission of…
permissive · top 15,000 on PyPI
cirq-webProvides browser-based 3D visualization tools…
permissive · top 15,000 on PyPI
cirqCirq is a Python framework for writing,…
permissive · top 15,000 on PyPI
openfermionOpenFermion compiles and analyzes quantum…
permissive · top 15,000 on PyPI
qiskitQiskit is an open-source SDK for building and…
permissive · top 5,000 on PyPI
openfermionpyscfBridges OpenFermion quantum algorithm library…
permissive · top 15,000 on PyPI