Q-CTRL Python Package

The Q-CTRL Python Package provides an intuitive and convenient Python interface to Q-CTRL's quantum control solutions for customers of Q-CTRL. To use the Q-CTRL Python Package, you will need to sign up to Q-CTRL and you will need a BOULDER OPAL account.


The Q-CTRL Python Package requires Python 3.6.4 or later, or Python 3.7.

To get started quickly and easily, we recommend Anaconda - a free and open-source distribution of the Python and R programming languages for scientific computing, that aims to simplify package management and deployment.

Once you're set up with the minimum required Python version, run the following command in your terminal application. The pip distribution includes the most recentstable release. For latest features or development purposes install from source.

Using PyPi

This will install the Q-CTRL Python Package and any dependencies onto your machine.

pip install qctrl

If you already have the qctrl package installed and wish to upgrade to the latest version, run:

pip install --upgrade qctrl


To authenticate into the Q-CTRL Python Package you will need to enter your Q-CTRL email and password when you are prompted while your script is being run, or you can authenticate directly:

qctrl = Qctrl(email="myemail@example.com", password="mypassword")

Quantum wiki

Comprehensive knowledge base of quantum control theory.

Explore open_in_new