class qctrl.Qctrl(email=None, password=None, api_root=None, skip_version_check=False)

A mediator class. Used to authenticate with Q-CTRL and access Q-CTRL features.

Creating an instance of this class requires authentication with Q-CTRL’s API.

The recommended method of authentication is through the interactive authentication method. This method can be invoked by simply calling Qctrl() without any arguments. This method will also create an authentication file that will be used for subsequent authentications when using the package.

q = Qctrl()

If needed authentication can also be done by passing your email and password as arguments to the Qctrl() function as shown below. Ensure that the credentials used are secure.

q = Qctrl(email='myemail', password='mypassword')
  • email (str, optional) – The email address for a Q-CTRL account. (Default value = None)

  • password (str, optional) – The password for a Q-CTRL account. (Default value = None)

  • api_root (str, optional) – The URL of the Q-CTRL API. (Default value = None)

  • skip_version_check (bool, optional) – option for disabling the version check. ( Default value = False)





Prints a list of previously run actions to the console and their statuses.


Creates a graph object.


This function is used to return the results of a previously run function.