Devices & Credentials

Quantinuum Nexus provides an interface to many different quantum execution environments.

Here we use the general term Device to mean a specific quantum computer, emulator or simulator.

You can use qnexus to view the Devices you have available to you through the Nexus platform.

import qnexus as qnx

# Pull in all available devices and return a pandas dataframe
qnx.devices.get_all().df()

# List Quantinuum devices
qnx.devices.get_all(
    issuers=[qnx.devices.IssuerEnum.QUANTINUUM]
).df()

# List IBMQ devices under a specific IBMQ hub, group, and project
qnx.devices.get_all(
    issuers=[qnx.devices.IssuerEnum.IBMQ],
    ibmq_hub="ibm-q",
    ibmq_group="open",
    ibmq_project="main",    
).df()

# List simulator and emulator devices that are hosted in the Nexus platform
qnx.devices.get_all(
    nexus_hosted=True,
).df()

Credentials

Some devices require credentials, which can be set at https://nexus.quantinuum.com/settings/accounts

By default you do not need to set credentials for Nexus-hosted simulators or for Quantinuum devices that you have access to. Once you have credentials saved you won’t be able to view them again, but you will be able to identify them by name.

# List your saved credentials
my_credentials = qnx.credentials.get_all()

my_credentials.df()

Using saved credentials

Saved credentials will be used automatically when listing devices or submitting jobs, however you can specify a set of credentials to use by passing their identifier or unique name.

qnx.devices.get_all(
    credentials=[my_credentials[0]]
).df()