Amazon Braket¶

OpenQAOA supports Braket and all gate-based QPU present on braket. For the freshest list, please check the Braket's documentation

Currently, the available devices are

Item	Device Name	Paradigm	Type	Device ARN	Region
IonQ	ionQdevice	gate-based	QPU	arn:aws:braket:::device/qpu/ionq/ionQdevice	us-east-1
Oxford Quantum Circuits	Lucy	gate-based	QPU	arn:aws:braket:eu-west-2::device/qpu/oqc/Lucy	eu-west-2
Rigetti	Aspen M-3	gate-based	QPU	arn:aws:braket:us-west-1::device/qpu/rigetti/Aspen-M-3	us-west-1
AWS	SV1	gate-based	SIM	arn:aws:braket:::device/quantum-simulator/amazon/sv1	*
AWS	DM1	gate-based	SIM	arn:aws:braket:::device/quantum-simulator/amazon/dm1	*
AWS	TN1	gate-based	SIM	arn:aws:braket:::device/quantum-simulator/amazon/tn1	*

Danger

Any computations on AWS braket carry a financial cost. Please, make sure you are conformable with the latest Amazon Braket pricing model before continuing!

How to connect to AWS braket¶

There are two ways to access the devices on Braket:

Access through your own laptop¶

In order to access Braket's services from your own device you will need to authenticate. This is a two step process. First, you need to create a pair of Access Key and Secret Access Key

Danger

Access keys are really dangerous. If leaked, they may compromise your AWS account.

To create and configure the access keys follow the this guide

If you are on a unix machine, then you will be able to set your credentials through the AWS Command Line Interface

$ aws configure
AWS Access Key ID [None]: AKIAI******EXAMPLE
AWS Secret Access Key [None]: wJalrXU******EXAMPLEKEY
Default region name [None]: us-west-1
Default output format [None]: json

OpenQAOA, via the Braket SDK, checks for the credentials on your local machine, and proceeds to authenticate.

Access through Braket hosted notebooks¶

You can get started by following Braket's official docs. Once you are on a hosted notebook, all you will need to do is to create an aws device.

Creating a Braket device¶

The procedure is simple:

from openqaoa import QAOA, create_device

q = QAOA()

sv1_device = create_device(location='aws', 
                            name='arn:aws:braket:::device/quantum-simulator/amazon/sv1', 
                            aws_region='us-west-1')
q.set_device(sv1_device)

Find an Available Device¶

If you are unsure about what devices are available to you, you can do the following:

from openqaoa import create_device

device = create_device(location='aws', 
                        name='',
                        aws_region='us-west-1')

device.check_connection()
device.available_qpus

The attribute check_connection authenticates your Braket credentials while available_qpus returns a list of Braket device arn strings representing the available devices to your Braket account, based on your access keys.

Info

Note that the list of available devices depend on the aws_region. If the device you are looking for does not exist, try another region name.

Once you've selected the desired device, recreate the device object with the selected device's arn name as name in the create_device function.