Installing qsimcirq

The qsim-Cirq Python interface is available as a PyPI package for Linux users. For all other users, Dockerfiles are provided to install qsim in a contained environment.

Linux installation

Prior to installation, consider opening a virtual environment.

The qsim-Cirq interface uses CMake to ensure stable compilation of its C++ libraries across a variety of Linux distributions. CMake can be installed from their website, or with the command apt-get install cmake.

Other prerequisites (including pybind11 and pytest) are included in the requirements.txt file, and will be automatically installed along with qsimcirq.

To install the qsim-Cirq interface on Linux, simply run pip3 install qsimcirq. For examples of how to use this package, see the tests in qsim/qsimcirq_tests/.

MacOS and Windows installation

For users interested in running qsim on a MacOS or Windows device, we strongly recommend using the Docker config provided with this repository.

Experimental install process

Alternatively, MacOS and Windows users can follow the Linux install process, but it is currently untested on those platforms. Users are encouraged to report any issues seen with this process.


After installing qsimcirq on your machine, you can test the installation by copying qsimcirq_tests/ to your machine and running python3 -m pytest