amazon-braket/amazon-braket-sdk-python

A Python SDK for interacting with quantum devices on Amazon Braket

Amazon Braket Python SDK

The Amazon Braket Python SDK is an open‑source library that lets you write Python code to run quantum‑computing jobs on Amazon Braket. It provides:

  • Device abstractions (AwsDevice, Devices) for both Amazon‑hosted simulators and real quantum processors (e.g., Rigetti, IonQ, etc.).
  • Circuit building via braket.circuits.Circuit.
  • Task submission (device.run, device.run_batch) and result retrieval.
  • Hybrid job support (AwsQuantumJob) for workflows that combine classical and quantum steps.
  • Local simulators bundled in the SDK for rapid prototyping without AWS resources.

Getting started

# Install the SDK from PyPI
pip install amazon-braket-sdk

You need Python 3.11+, Git, an AWS account with an IAM user/role that has Braket permissions, and the AWS SDK for Python (boto3). Configure your AWS credentials and region before using the SDK.

Simple example – Bell‑pair on the SV1 simulator

from braket.aws import AwsDevice
from braket.circuits import Circuit
from braket.devices import Devices

# Choose the managed state‑vector simulator
device = AwsDevice(Devices.Amazon.SV1)

# Build a 2‑qubit Bell circuit
bell = Circuit().h(0).cnot(0, 1)

# Submit the job (100 shots) and print the measurement histogram
task = device.run(bell, shots=100)
print(task.result().measurement_counts)

The SDK handles job creation, polling, and result parsing for you.

Running many circuits in parallel

circuits = [bell for _ in range(5)]
batch = device.run_batch(circuits, shots=100)
print(batch.results()[0].measurement_counts)

Batch submission speeds up large workloads on simulators.

Hybrid jobs (classical + quantum)

from braket.aws import AwsQuantumJob

job = AwsQuantumJob.create(
    device="arn:aws:braket:::device/quantum-simulator/amazon/sv1",
    source_module="job.py",
    entry_point="job:run_job",
    wait_until_complete=True,
)
print(job.result())

The SDK launches a Docker‑based job that can run multiple quantum tasks and ordinary Python code together.

Local simulation

The SDK ships with braket_sv, a fast state‑vector simulator that runs on your laptop. Use it for quick debugging before sending jobs to the cloud.

Documentation & help

License

Apache‑2.0.

In a nutshell: The Amazon Braket Python SDK is a production‑ready toolkit for building, submitting, and managing quantum circuits and hybrid workloads on AWS’s Braket service, with both cloud‑hosted and local simulators available.

Related

  • Project
    amazon-braket/amazon-braket-examples

    A collection of tutorials and examples for Amazon Braket, enabling users to build, test, and run quantum circuits on simulators and quantum hardware.

  • Project
    agilexrobotics/piper_sdk

    A Python SDK for the Piper robot arm that processes CAN bus data frames into custom data types for easier hardware control and monitoring.

  • Project
    aws/sagemaker-python-sdk

    An open-source library for training and deploying machine learning models on Amazon SageMaker, supporting popular frameworks and foundation model fine-tuning.

  • Project
    runpod/runpod-python

    The official Python library for RunPod, providing an SDK to build serverless AI workers and a GraphQL wrapper to manage GPU cloud pods and endpoints.

  • Project
    flyteorg/flytekit

    Flytekit Python is the official SDK for Flyte, letting you write, test, and deploy AI/ML workflows in pure Python using `@task` and `@workflow` decorators. Install with `pip install flytekit`, follow the quick‑start guide, and extend via plugins or contribute through the provided docs.