class qiskit_aqt_provider.aqt_provider.AQTProvider[source]#

Bases: ProviderV1

Provider for backends from Alpine Quantum Technologies (AQT).

__init__(access_token: str | None = None, *, load_dotenv: bool = True, dotenv_path: str | Path | None = None)[source]#

Initialize the AQT provider.

The access token for the AQT cloud can be provided either through the access_token argument or the AQT_TOKEN environment variable.


If no token is set (neither through the access_token argument nor through the AQT_TOKEN environment variable), the provider is initialized with access to the offline simulators only and NoTokenWarning is emitted.

The AQT cloud portal URL can be configured using the AQT_PORTAL_URL environment variable.

If load_dotenv is true, environment variables are loaded from a file, by default any .env file in the working directory or above it in the directory tree. The dotenv_path argument allows to pass a specific file to load environment variables from.

  • access_token – AQT cloud access token.

  • load_dotenv – whether to load environment variables from a .env file.

  • dotenv_path – path to the environment file. This implies load_dotenv.

backends(name: str | Pattern[str] | None = None, *, backend_type: Literal['device', 'simulator', 'offline_simulator'] | None = None, workspace: str | Pattern[str] | None = None) BackendsTable[source]#

Search for backends matching given criteria.

With no arguments, return all backends accessible with the configured access token.

Filters can be either strings or regular expression patterns. Strings filter by exact match.

  • name – filter for the backend name.

  • backend_type – if given, restrict the search to the given backend type.

  • workspace – filter for the workspace ID.


Collection of backends accessible with the given access token that match the given criteria.

get_backend(name=None, **kwargs)#

Return a single backend matching the specified filtering.

  • name (str) – name of the backend.

  • **kwargs – dict used for filtering.


a backend matching the filtering.

Return type:



QiskitBackendNotFoundError – if no backend could be found or more than one backend matches the filtering criteria.

class qiskit_aqt_provider.aqt_provider.BackendsTable[source]#

Bases: Sequence[AQTResource]

Pretty-printable collection of AQT backends.

The __str__() method returns a plain text table reprensentation of the available backends. The _repr_html_() method returns an HTML representation that is automatically used in IPython/Jupyter notebooks.

__str__() str[source]#

Plain-text table representation.

_repr_html_() str[source]#

HTML table representation (for IPython/Jupyter).

by_workspace() Dict[str, List[AQTResource]][source]#

Backends grouped by workspace ID.

class qiskit_aqt_provider.aqt_provider.NoTokenWarning[source]#

Bases: UserWarning

Warning emitted when a provider is initialized with no access token.