Installation and setup


PennyLane-Forest requires the following libraries be installed:

as well as the following Python packages:

If you currently do not have Python 3 installed, we recommend Anaconda for Python 3, a distributed version of Python packaged for scientific computation.

Additionally, if you would like to compile the quantum instruction language (Quil) and run it locally using a quantum virtual machine (QVM) server, you will need to download and install the Forest software development kit (SDK):

Alternatively, you may sign up for Rigetti’s Quantum Cloud Services (QCS) to acquire a Quantum Machine Image (QMI) which will allow you to compile your quantum code and run on real quantum processing units (QPUs), or on a preinstalled QVM. Note that this requires a valid QCS account.


Installation of PennyLane-Forest, as well as all required Python packages mentioned above, can be installed via pip:

$ python -m pip install pennylane-forest

Make sure you are using the Python 3 version of pip.

Alternatively, you can install PennyLane-Forest from the source code by navigating to the top directory and running

$ python install

Software tests

To ensure that PennyLane-Forest is working correctly after installation, the test suite can be run by navigating to the source code folder and running

$ make test


To build the HTML documentation, go to the top-level directory and run

$ make docs

The documentation can then be found in the doc/_build/html/ directory.