---
id: cirq-web
version: "1.7.0"
license: Apache-2.0
license_treatment: permissive
maintenance: active
---

# cirq-web — Web-based 3D visualization tools for Cirq.

License: permissive · Maintenance: active · Downloads: 131.4K/mo

## 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 above — 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

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

- License: Apache-2.0 (permissive)
- Python support: supports_current
- Install friction: low
- Maintenance: active
- Downloads: 131.4K/month (top 15,000 on PyPI)
- Known vulnerabilities: none known

## Tags

quantum circuit visualization, bloch sphere 3d display, quantum state visualization, cirq web visualization, interactive quantum visualization, quantum computing visualization tools, jupyter quantum visualization, quantum-computing, visualization, jupyter-compatible

[View on SkillFed](https://skillfed.io/packages/cirq-web) · [View on PyPI](https://pypi.org/project/cirq-web/)