Installing qsimcirq

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

Before installation

Prior to installation, consider opening a virtual environment.

Prerequisites are included in the requirements.txt file, and will be automatically installed along with qsimcirq.

Linux installation

We provide qsimcirq Python wheels on 64-bit x86 architectures with Python 3.{6,7,8,9}.

Simply run pip3 install qsimcirq.

MacOS installation

We provide qsimcirq Python wheels on x86 architectures with Python 3.{6,7,8,9}.

Simply run pip3 install qsimcirq.

Windows installation

We provide qsimcirq Python wheels on 64-bit x86 and amd64 architectures with Python 3.{6,7,8,9}.

Simply run pip3 install qsimcirq.

There's no compatible wheel for my machine!

If existing wheels do no meet your needs please open an issue with your machine configuration (i.e. CPU architecture, Python version) and consider using the Docker config provided with this repository.

Testing

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

It also has examples of how how to use this package.