class Qctrl(email=None, password=None, api_root=None, oidc_url=None, env_namespace=None, skip_version_check=False, client=None, verbosity='VERBOSE', organization=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.

qctrl = Qctrl()

You can also access toolkits provided by Boulder Opal through the corresponding namespaces of the Qctrl object. See the reference for details.

Deprecated since version 15.4.4: Email and password based authentication has been removed in favour of url based authentication. To authenticate simply call qctrl = Qctrl() without any additional arguments.

  • email (str, optional) – The email address for a Q-CTRL account. [This field has been deprecated] (Default value = None)

  • password (str, optional) – The password for a Q-CTRL account. [This field has been deprecated] (Default value = None)

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

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

  • env_namespace (str, optional) – The environment namespace of the Q-CTRL stack. (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)

  • verbosity (str, optional) – The verbosity of messages when running calculations. Possible values are: “VERBOSE” (showing task status messages and progress bars) and “QUIET” (not showing them). (Default value = “VERBOSE”)

  • organization (str, optional) – The organization slug to allocate tenant resources.





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


Prints the BibTeX information for citing Boulder Opal, with the possibility to save it into a BibTeX file.


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.


Requests a minimum number of machines to be online.


Set the verbosity mode.


Starts collection mode.


Stops collection mode.