{"id":20916,"library":"amazon-braket-sdk","title":"Amazon Braket Python SDK","description":"An open source library for interacting with quantum computing devices on Amazon Braket. Current version 1.117.0, requires Python >=3.11. Released on a monthly cadence.","status":"active","version":"1.117.0","language":"python","source_language":"en","source_url":"https://github.com/amazon-braket/amazon-braket-sdk-python","tags":["quantum computing","AWS","Braket","quantum","SDK"],"install":[{"cmd":"pip install amazon-braket-sdk","lang":"bash","label":"Install from PyPI"}],"dependencies":[{"reason":"AWS SDK for Python, required for Braket API calls","package":"boto3","optional":false},{"reason":"Local simulator for testing circuits","package":"amazon-braket-default-simulator","optional":true}],"imports":[{"note":"AwsDevice is in braket.aws, not braket.devices.","wrong":"from braket.devices import AwsDevice","symbol":"AwsDevice","correct":"from braket.aws import AwsDevice"},{"symbol":"Circuit","correct":"from braket.circuits import Circuit"},{"note":"Direct import of braket does not expose SDK class; use BraketSDK for session management.","wrong":"import braket","symbol":"BraketSDK","correct":"from braket import BraketSDK"}],"quickstart":{"code":"from braket.aws import AwsDevice\nfrom braket.circuits import Circuit\nfrom braket import BraketSDK\n\nsdk = BraketSDK()\ndevice = AwsDevice(\"arn:aws:braket:us-west-1::device/qpu/ionq/Harmony\")\nbell = Circuit().h(0).cnot(0, 1)\ntask = device.run(bell, shots=100)\nprint(task.result().measurement_counts)","lang":"python","description":"Runs a Bell state circuit on IonQ Harmony device using AWS credentials from environment or session."},"warnings":[{"fix":"Use braket.aws.aws_session.AwsSession with allow_pickle=True or deserialize with the appropriate safeguard.","message":"Pickle deserialization disabled by default (v1.117.0). Loading pickled tasks/circuits from untrusted sources will fail unless explicitly opt-in.","severity":"breaking","affected_versions":">=1.117.0"},{"fix":"Update device ARN to Rigetti Cepheus1108Q or other supported device.","message":"Rigetti Ankaa-3 retired in v1.116.0. Code using that device ARN will fail.","severity":"deprecated","affected_versions":">=1.116.0"},{"fix":"Always check latest device ARNs from AWS documentation or AwsDevice.get_device_region_map().","message":"Device ARN changes without deprecation notice. Example: Rigetti Cepheus1 renamed to Cepheus1108Q in v1.115.0.","severity":"gotcha","affected_versions":">=1.115.0"},{"fix":"Always specify qubit indices in Barrier().","message":"Barrier targets must include at least one qubit; qubit 0 is now valid (v1.111.1). Previously barrier with no targets would print a warning.","severity":"gotcha","affected_versions":">=1.111.1"}],"env_vars":null,"last_verified":"2026-04-27T00:00:00.000Z","next_check":"2026-07-26T00:00:00.000Z","problems":[{"fix":"Run 'pip install amazon-braket-sdk' again, or use 'from braket.aws import AwsDevice' directly.","cause":"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.","error":"AttributeError: module 'braket' has no attribute 'aws'"},{"fix":"Configure AWS CLI with 'aws configure' or set environment variables AWS_ACCESS_KEY_ID, AWS_SECRET_ACCESS_KEY.","cause":"AWS credentials not configured. Braket SDK requires valid AWS credentials.","error":"botocore.exceptions.NoCredentialsError: Unable to locate credentials"},{"fix":"Use a current device ARN, e.g., 'arn:aws:braket:us-west-1::device/qpu/rigetti/Cepheus1108Q'.","cause":"Device retired or ARN outdated. Ankaa-3 was retired in v1.116.0.","error":"ValueError: The device 'arn:aws:braket:us-west-1::device/qpu/rigetti/Ankaa-3' is not available."}],"ecosystem":"pypi","meta_description":null,"install_score":null,"install_tag":null,"quickstart_score":null,"quickstart_tag":null}