qBraid Quantum Jobs give Lab users direct access to all Amazon Braket supported devices with no additional access keys required. This includes access to QPU devices from IonQ, Oxford Quantum Circuits, QuEra, and Rigetti as well as on-demand simulators from AWS.
Each time you run a program on a QPU or on-demand simulator using qBraid Quantum Jobs, credits are subtracted from your account according to the cost of the job. The cost is calculated using the per-shot / per-task / per-second fee(s) from Amazon Braket pricing, with no mark-up.
Each qBraid credit is worth $.01 USD, so an Amazon Braket task costing $3.80 would subtract 380 credits from your qBraid balance. Credits can be purchased
from your account page, or redeemed using an access key. You can check your current credit balance on your account page,
QJOBS sidebar on Lab, or using the CLI:
$ qbraid jobs get-credits
Environments listed in the Environment Manager with the
quantum jobs tag have pre-configured support for qBraid Quantum Jobs.
You can also use the CLI to see which of your installed environments support Quantum Jobs with the qbraid envs list command.
Environments with the
jobs keyword listed before their path support qBraid Quantum Jobs.
Green or red highlighting over the
jobs keyword (not pictured) indicates whether jobs are enabled or disabled for that environment.
$ qbraid envs list # installed environments: # qsharp /opt/.qbraid/environments/qsharp_b54crn default jobs /opt/.qbraid/environments/qbraid_000000 qiskit /home/jovyan/.qbraid/environments/qiskit_9y9siy amazon_braket jobs /home/jovyan/.qbraid/environments/aws_braket_kwx6dl custom_env /home/jovyan/.qbraid/environments/custom_env_lj3zlt
qBraid Quantum Jobs are not limited to environments with pre-configured support. You can add Quantum Jobs to any environment that has Amazon Braket installed:
$ qbraid jobs add [env_name]
To use Quantum Jobs in an environment, they must be enabled. This can be done using the Quantum Jobs toggle in the Environment Manager, or using the qBraid CLI.
Quantum Jobs Toggle
To enable/disable Quantum Jobs from the Environment Manager, simply click the environment’s More button, and then flip the Quantum Jobs Toggle (located under the General Info section). Flipped to the left means quantum jobs are disabled; flipped to the right means quantum jobs are enabled.
To enable Quantum Jobs from Terminal, use the qBraid CLI jobs enable command:
$ qbraid jobs enable [env_name]
You can also enable Quantum Jobs from inside a notebook using the
! operator. This extra character, put at the beginning of the command, indicates that what you’ve entered is a bash command and not Python code.
To disable Quantum Jobs and run programs using your own AWS credentials, enter
$ qbraid jobs disable [env_name]
To reset your AWS credentials, follow instructions Quick configuration with aws configure.
Before executing/submitting your quantum program, make sure that your notebook kernel matches the correct environment, and that Quantum Jobs are enabled. From the Quantum Jobs sidebar, you can view the details of your submitted jobs, monitor the status of each job, and track your credits.
In the example to the right, a batch of 3 quantum jobs were submitted to IonQ Aria-1 device. Each job used 500 shots, so the cost was ~4590 qBraid credits, equivalent to $45.90 USD.
At any time, it’s now incredibly easy to retrieve the Job ID, recreate the
AwsQuantumTask object in a new program, and get the results:
from braket.aws import AwsQuantumTask # Job ID (arn) copied over from sidebar task = AwsQuantumTask(arn="arn:aws:braket:us-east-1:..." ) task.result() ...
On qBraid, the devices you can access are not restricted by your choice of programming framework. Target any of our 20+ supported QPUs and simulators from Qiskit, Amazon Braket, Cirq, PyQuil, or OpenQASM 2 using the qBraid SDK.
You can cancel and delete jobs using the Quantum Jobs sidebar. You can only delete jobs that have reached a
final state, and can only cancel jobs that have not yet reached a final state (e.g.