Install & Compatibility
Where this runs
tested against v1.110.1 · pip install
no network on importno background threads
Install × environment matrix
Each cell = how many times install + import succeeded across repeated harness runs. Partial = flaky.
glibc = Debian/Ubuntu slim · musl = Alpine Linux
py 3.10
✕ build_error
✓ 23s
py 3.11
✕ build_error
✓ 22.8s
py 3.12
✕ build_error
✓ 23s
py 3.13
✕ build_error
✓ 22.5s
514MB installed
● package 514MB
Code
Verified usage
Verified import paths — ran on the pinned version, not inferred.
AwsDevice
✓ from braket.aws import AwsDevice
✗ from braket.devices import AwsDevice
AwsDevice is in braket.aws, not braket.devices.
Circuit
✓ from braket.circuits import Circuit
BraketSDK
✓ from braket import BraketSDK
✗ import braket
Direct import of braket does not expose SDK class; use BraketSDK for session management.
Runs a Bell state circuit on IonQ Harmony device using AWS credentials from environment or session.
from braket.aws import AwsDevice
from braket.circuits import Circuit
from braket import BraketSDK
sdk = BraketSDK()
device = AwsDevice("arn:aws:braket:us-west-1::device/qpu/ionq/Harmony")
bell = Circuit().h(0).cnot(0, 1)
task = device.run(bell, shots=100)
print(task.result().measurement_counts)
Errors
Common errors & fixes
AttributeError: module 'braket' has no attribute 'aws'
Incomplete installation or wrong import path. braket.aws is a subpackage that must be installed separately? No, it's part of SDK but may not be imported if not properly installed.
fixRun 'pip install amazon-braket-sdk' again, or use 'from braket.aws import AwsDevice' directly.
botocore.exceptions.NoCredentialsError: Unable to locate credentials
AWS credentials not configured. Braket SDK requires valid AWS credentials.
fixConfigure AWS CLI with 'aws configure' or set environment variables AWS_ACCESS_KEY_ID, AWS_SECRET_ACCESS_KEY.
ValueError: The device 'arn:aws:braket:us-west-1::device/qpu/rigetti/Ankaa-3' is not available.
Device retired or ARN outdated. Ankaa-3 was retired in v1.116.0.
fixUse a current device ARN, e.g., 'arn:aws:braket:us-west-1::device/qpu/rigetti/Cepheus1108Q'.
Upgrade
Version history
1.119.1latest on PyPI · released Jun 10, 2026
Audit
Dependencies
boto3requiredAWS SDK for Python, required for Braket API calls
amazon-braket-default-simulatoroptionalLocal simulator for testing circuits