quantumlib/cirq

Python framework for creating, editing, and running Noisy Intermediate-Scale Quantum (NISQ) circuits.

View on GitHub ↗Jump to charts ↓Open shareable report

Summary Information

Updated 14 minutes ago
Added to GitGenius on September 13th, 2026
Created on December 14th, 2017
Open Issues & Pull Requests: 125 (+0)
GitHub issues: Enabled
Number of forks: 1,267
Total Stargazers: 5,063 (+0)
Total Subscribers: 190 (+0)

Repository Insights (GitGenius)

Median issue/PR response: 39.4 hours
Mean response time: 87.9 days
90th percentile: 234.3 days
Tracked items: 679

Most active contributors

Sign in to see contributor activity.

How this project is maintained

About 7% of issues opened in the past year have never received a reply. 47% of open issues come from outside the core team, a mix of external reports and the maintainers' own roadmap. Work labelled "kind/bug-report" is answered fastest, typically in about 24 hours, while "good for learning" waits about 12 days. Only 59% of issues opened in the past year have been closed. Three people close 65% of everything that gets resolved.

Charts & Analytics

Fetching additional details & charts...

Issue Activity (beta)

Open issues: 96
New in 7 days: 16
Closed in 7 days: 0
Avg open age: 1,016 days
Stale 30+ days: 61
Stale 90+ days: 32

Recent activity

Opened in 7 days: 16
Closed in 7 days: 0
Comments in 7 days: 21
Events in 7 days: 111

Top labels

  • triage/accepted (418)
  • kind/feature-request (199)
  • kind/bug-report (197)
  • kind/health (149)
  • area/docs (127)
  • good first issue (91)
  • no QC knowledge needed (71)
  • status/stale (63)

Detailed Description

Cirq is a Python framework for creating, editing, and running quantum circuits on quantum computers and simulators.

Cirq addresses the challenge of programming noisy intermediate-scale quantum computers, where hardware-specific details significantly impact results. The framework provides abstractions tailored to NISQ devices, including flexible gate definitions, parameterized circuits with symbolic variables, circuit transformation and optimization capabilities, hardware device modeling, and noise modeling. It includes multiple built-in quantum circuit simulators and integrates with qsim for high-performance simulation, while maintaining interoperability with NumPy and SciPy.

Cirq suits developers and researchers working on near-term quantum algorithms and applications who need fine-grained control over circuit construction and hardware-specific optimizations. It is particularly valuable for those targeting specific quantum hardware platforms where noise characteristics and device constraints are central to achieving good results. The framework supports Python 3.11 and later across Linux, macOS, Windows, and Google Colab, making it accessible across different development environments. The project provides extensive learning resources including video tutorials, interactive Jupyter notebooks, and text-based documentation, alongside numerous examples ranging from textbook algorithms to advanced methods.

The project maintains active development with regular releases and a comprehensive changelog documenting changes across versions. Documentation is continuously updated and available both for stable releases and pre-release versions, supporting developers at different stages of adoption. The codebase includes an examples subdirectory with programs demonstrating applications across various quantum computing techniques, and a dedicated experiments page provides additional reference implementations from simple to advanced use cases.