Research using Cirq!

This project contains modules for running quantum computing applications and experiments through Cirq. By way of example, we also document best practices for setting up robust experimental pipelines.

The Python package in the recirq/ directory contains a subdirectory for each experiment, such as qaoa, hfvqe, fermi_hubbard, otoc, toric_code, kpz, qcqmc, qec_memory, time_crystals, and random_circuit_sampling, along with the cirqflow workflow utilities and other shared helpers. The docs/ directory contains tutorials and Colab/Jupyter notebooks that accompany the experiments; they are published at https://quantumai.google/cirq/experiments.

ReCirq requires Python 3.10 or later. It is not available as a PyPI package, so please clone this repository and install from source. We recommend doing this inside a virtual Python environment (for example, one created with Python's built-in venv module). Once you have a Python virtual environment, then do these steps:

git clone https://github.com/quantumlib/ReCirq.git
cd ReCirq
pip install .

This installs the dependencies for all of the experiments. If you only want the dependencies for a specific experiment, install requirements.txt and the extra-requirements.txt file in that experiment's subdirectory instead, as described in the contribution guidelines.

Documentation is available at https://quantumai.google/cirq/experiments.

ReCirq leverages Cirq as a quantum programming language and SDK.

Google Quantum AI has a suite of open-source software. From high-performance simulators, to novel tools for expressing and analyzing fault-tolerant quantum algorithms, our software stack lets you develop quantum programs for a variety of applications.

Releases of ReCirq are archived on Zenodo. Click the badge at right to see all citation formats for all versions, or use the following BibTeX:

@software{quantum_ai_team_and_collaborators_2020_4091470,
  author       = {{Quantum AI team and collaborators}},
  title        = {ReCirq},
  month        = oct,
  year         = 2020,
  publisher    = {Zenodo},
  doi          = {10.5281/zenodo.4091470},
  url          = {https://doi.org/10.5281/zenodo.4091470}
}

• Have a question or problem? See the support guide for suggestions on how to get help.
• Found a bug or have a feature request? Open an issue on GitHub.
• Want to contribute code? Read the contribution guidelines and our community code of conduct.

For any questions or concerns not addressed here, please email quantum-oss-maintainers@google.com.

This is not an officially supported Google product. This project is not eligible for the Google Open Source Software Vulnerability Rewards Program.

Copyright 2025 Google LLC.