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

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)

  • client (gql.Client, optional) – A GraphQL client that provides access to a Q-CTRL GraphQL endpoint. You can pass this parameter to use Q-CTRL features provided by a non-standard Q-CTRL API implementation, for example, one running locally or in a private cloud. If you pass this parameter, do not pass email, password, or api_root. (Default value = None)

  • functions (Functions) –

  • types (Types) –

  • operations – Deprecated, call methods on Graph instead.





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


Creates a graph object for representing remote computations.


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


Checks if the object is in collection mode.


Context manager for executing multiple function calls in parallel.


Starts collection mode.


Stops collection mode.