cirq-ionq 1.7.0.dev20260220193918
A Cirq package to simulate and connect to IonQ quantum computers
License: Apache-2.0
Requires Python: >=3.11.0
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

<div align="center">
<img width="190px" alt="Cirq logo"
src="https://raw.githubusercontent.com/quantumlib/Cirq/refs/heads/main/docs/images/Cirq_logo_color.svg"
><img width="50px" height="0" alt=""><img width="200px" alt="IonQ logo"
src="https://ionq.com/images/ionq-logo-dark.svg">
</div>

# cirq-ionq

This is the Cirq-IonQ integration module. It provides an interface that allows
[Cirq] quantum algorithms to run on quantum computers made by [IonQ
Inc.](https://ionq.com/). (See the [Documentation](#documentation) section
below for information about getting access to IonQ devices.)

[Cirq] is a Python package for writing, manipulating, and running [quantum
circuits](https://en.wikipedia.org/wiki/Quantum_circuit) on quantum computers
and simulators. Cirq provides useful abstractions for dealing with today’s
[noisy intermediate-scale quantum](https://arxiv.org/abs/1801.00862) (NISQ)
computers, where the details of quantum hardware are vital to achieving
state-of-the-art results. For more information about Cirq, please visit the
[Cirq documentation site].

[Cirq]: https://github.com/quantumlib/cirq
[Cirq documentation site]: https://quantumai.google/cirq

## Installation

This module is built on top of [Cirq]; installing this module will
automatically install the `cirq-core` module and other dependencies. There are
two installation options for the `cirq-ionq` module:

*   To install the stable version of `cirq-ionq`, use

    ```shell
    pip install cirq-ionq
    ```

*   To install the latest pre-release version of `cirq-ionq`, use

    ```shell
    pip install --upgrade cirq-ionq~=1.0.dev
    ```

    (The `~=` has a special meaning to `pip` of selecting the latest version
    compatible with the `1.*` and `dev` in the name. Despite appearances,
    this will not install an old version 1.0 release!)

If you would like to install Cirq with all the optional modules, not just
`cirq-ionq`, then instead of the above commands, use `pip install cirq` for the
stable release or `pip install --upgrade cirq~=1.0.dev` for the latest pre-release
version.

## Documentation

To get started with using IonQ quantum computers through Cirq, please refer to
the following documentation:

*   [Access and authentication](https://quantumai.google/cirq/ionq/access).
*   [Getting started
    guide](https://quantumai.google/cirq/tutorials/ionq/getting_started).

To get started with using Cirq in general, please refer to the [Cirq
documentation site].

For more information about getting help, reporting bugs, and other matters
related to Cirq and the Cirq-IonQ integration module, please visit the [Cirq
repository on GitHub](https://github.com/quantumlib/Cirq).

## Disclaimer

Cirq is not an official Google product. Copyright 2019 The Cirq Developers.