cirq-google
The Cirq module that provides tools and access to the Google Quantum Computing Service
What it is and what it does
Cirq-google is the integration layer between Cirq (a quantum circuit framework) and Google's Quantum Computing Service. It extends Cirq with Google-specific tools for accessing quantum hardware, calibrating devices, and characterizing their behavior—essential for working with noisy intermediate-scale quantum (NISQ) computers where hardware details significantly affect results.
The package is designed for researchers and developers building quantum algorithms and applications that target Google's quantum processors. It handles the complexity of translating abstract quantum circuits into hardware-specific instructions and provides calibration utilities to optimize performance on real quantum devices. Installation automatically brings in cirq-core and supporting dependencies like protobuf and google-api-core for service communication.
Use it for:
- Run quantum circuits on Google's quantum processors through the Quantum Computing Service API
- Calibrate and characterize Google quantum hardware to understand device-specific noise and errors
- Develop and test quantum algorithms targeting NISQ devices with hardware-aware optimizations
- Access Google's quantum simulators for circuit validation before hardware execution
Worth the install?
AI-flagged interpretation of the facts on this page — verify before relying
Provides access to Google's Quantum Computing Service and tools for calibration and characterization of Google quantum hardware, built on top of Cirq for writing and running quantum circuits.
Yes, if you need to work with Google's quantum hardware or simulators. The package is actively maintained, production-stable, has low install friction, and carries a permissive license. It's the official integration point for Google quantum access within the Cirq ecosystem. Not necessary if you only use Cirq for general quantum circuit work without Google-specific hardware access.
Install
cirq-google on PyPI
pip
pip install cirq-googleuv
uv add cirq-googlepoetry
poetry add cirq-googleInstalling cirq-google
Before you install
Low install friction with a pure-wheel distribution. Actively maintained with a recent release and ongoing commits; the project is in production/stable status with 5046 repository stars.
License in practice
Licensed under Apache-2.0 (permissive), allowing commercial and private use with minimal restrictions beyond attribution and liability disclaimers.
Quickstart
pip install cirq-google
import cirq_google
# Access Google Quantum Computing Service
engine = cirq_google.Engine(project_id='your-project')
Requires Python 3.11 or later. Google Cloud credentials and a valid project ID are needed to access the Quantum Computing Service.
Verify before relying
- Specific quantum hardware devices supported and their current availability
- Authentication and quota requirements for the Google Quantum Computing Service
- Performance characteristics and simulation limits for circuit execution
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 | 5 — google-api-core, proto-plus, protobuf, typedunits, cirq-core |
| Maintenance | actively maintained — 46 days since the last release |
| Last repo commit | |
| First released | |
| Downloads | 173,045/month — #10,318 on PyPI (30-day window, as of 2026-08-14) |
| Known vulnerabilities | none known (OSV.dev, checked 2026-08-14) |
Evidence: cirq_google-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-coreCirq-core provides the foundational framework…
permissive · top 15,000 on PyPI
cirq-ionqIntegrates Cirq quantum circuits with IonQ…
permissive · top 15,000 on PyPI
cirq-pasqalCirq-Pasqal is a Cirq integration module that…
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
cirq-aqtCirq-AQT provides a Cirq integration that lets…
permissive · top 15,000 on PyPI
qm-octaveSDK for controlling Quantum Machine's Octave…
permissive · top 15,000 on PyPI
mqt.qcecVerifies whether two quantum circuits are…
permissive · top 15,000 on PyPI
openpulseOpenPulse parses and represents pulse grammar…
permissive · top 15,000 on PyPI
qualang-toolsProvides a comprehensive toolkit for writing…
permissive · top 15,000 on PyPI