cirq-web

What it is and what it does

cirq-web is a visualization module for the Cirq quantum computing framework that adds browser-based 3D rendering capabilities. It builds on top of cirq-core and enables developers to create interactive visualizations of quantum states, with the Bloch sphere as a primary example. The module generates portable HTML files that can be viewed in any modern browser, and integrates with Jupyter notebooks and Google Colab for interactive exploration.

The package is designed for quantum researchers, educators, and developers who need to visualize quantum states and circuits during development or presentation. It abstracts away the complexity of 3D graphics and web rendering, allowing users to generate visualizations with simple Python calls. The module is actively maintained as part of the broader Cirq ecosystem and supports current Python versions.

Use it for:

• Visualize quantum state vectors as interactive 3D Bloch spheres in Jupyter notebooks for educational purposes.
• Generate portable HTML visualizations of quantum states for inclusion in research papers or documentation.
• Debug quantum circuits by interactively exploring state evolution during algorithm development.
• Create interactive demonstrations of quantum computing concepts in Google Colab for teaching.
• Export quantum simulation results as shareable 3D visualizations without requiring specialized software.

Worth the install?

AI-flagged interpretation of the facts on this page — verify before relying

Provides browser-based 3D visualization tools for quantum circuits built with Cirq, including interactive Bloch sphere rendering that can be displayed in HTML files, Jupyter notebooks, or Google Colab.

Yes. cirq-web is worth installing if you work with Cirq and need to visualize quantum states or circuits. It has low install friction, active maintenance, no known vulnerabilities, and a permissive license. The single dependency on cirq-core is expected for a Cirq module. It fills a specific, well-defined need for quantum visualization in notebooks and browsers.

Install

cirq-web on PyPI

pip install cirq-web

uv add cirq-web

poetry add cirq-web

Installing cirq-web

Before you install

Low friction installation as a pure Python wheel with a single runtime dependency on cirq-core. Actively maintained with recent releases and no known vulnerabilities.

License in practice

Apache-2.0 permissive license allows free use, modification, and distribution in both open-source and commercial projects with minimal restrictions.

Quickstart

pip install cirq-web

import cirq
from cirq_web import BlochSphere

zero_state = [1+0j, 0+0j]
state_vector = cirq.to_valid_state_vector(zero_state)
sphere = BlochSphere(state_vector=state_vector)
sphere.generate_html_file()

Requires Python 3.11 or later; cirq-core must be installed as a runtime dependency.

Verify before relying

• Whether the 3D visualization requires specific browser capabilities or JavaScript support.
• Performance characteristics when rendering large or complex quantum states.
• Whether additional system dependencies are needed for HTML generation or browser display.

Package facts

Evidence: cirq_web-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