/amazon-braket

name: amazon-braket
description: "Runs quantum workflows on AWS / Amazon Braket: circuits and algorithms, QPU/device and ARN discovery, LocalSimulator, tasks, program sets, Hybrid Jobs, S3 results, pricing, account setup, and spending limits. Applies to quantum programs and execution, AHS, OpenQASM, pulse control, reservations, notebooks, or Qiskit or PennyLane integrations."
metadata:
  version: "2"

<!-- markdownlint-disable MD013 -->

Amazon Braket

Primitives

The vocabulary of a Braket workflow, and which reference to open for each.

| Primitive | What it is | Related References | Open it when the request involves | | --- | --- | --- | --- | | **Device** | A simulator or QPU, identified by a region-scoped ARN | [devices.md](references/devices.md) | anything about a device: what exists, discovering or filtering the fleet, availability and status (online, offline, retired), which region a device lives in, ARNs, choosing a device for a workload, qubit count, connectivity or topology, native gates, fidelities, calibration data, queue depth, shot and gate limits, paradigm (gate-model vs analog Hamiltonian simulation), whether a device supports program sets, simulators and local emulators | | **Program** | The workload/input — one executable (Circuit, AHS, OpenQASM). Which type is legal depends on the device's paradigm | - | - | | **Quantum task** | One program + shots, run once (the atomic unit Braket meters) | - | - | | **Task batch** | Many *independent* tasks — SDK-only fallback for when a program set does not fit; works on all devices | [program-sets.md](references/program-sets.md) | see the Program set row; also [running multiple programs](https://docs.aws.amazon.com/braket/latest/developerguide/braket-batching-tasks.html) | | **Program set** | Many programs in **one service-side task** — preferred way to run multiple programs instead of task batch | [program-sets.md](references/program-sets.md) | running more than one program: parameter sweeps, scanning parameter values, task batches, `run_batch`, several circuits submitted together, attaching observables across programs, and minimizing per-task fees when many programs run, program sets. Also [getting started with program sets](https://github.com/amazon-braket/amazon-braket-examples/blob/main/examples/braket_features/program_sets/01_Getting_started_with_program_sets.ipynb) | | **Hybrid job** | Managed classical-quantum loop that orchestrates many tasks | [hybrid-job.md](references/hybrid-job.md) | hybrid jobs: `@hybrid_job`, algorithm scripts and source modules, `entry_point`, embedded simulators, BYOC and custom container images, CUDA-Q, job execution roles, hyperparameters, checkpoints, and retrieving job results | | **Spending limit** | Service-side hard cap that **rejects** QPU tasks — the only true enforcement (not SDK) | [spending-limit.md](references/spending-limit.md) | capping or enforcing spend: spending limits (create, update, delete, search), and cost guardrails | | **Cost tracking** | In-session cost *estimate* (not enforcement) | [spending-limit.md](references/spending-limit.md) | in-session cost tracking with `Tracker` | | **Pricing** | Current Braket rates and pricing models | [pricing.md](references/pricing.md) | current price or rate, simulator pricing, QPU per-task/per-shot pricing, Hybrid Job or reservation pricing, AWS Pricing API, bulk price list | | **Reservation** | Exclusive device access for a booked window (Braket Direct) | [reservation.md](references/reservation.md) | reservations: `DirectReservation`, `reservation_arn`, booking/cancelling a reservation, running tasks or hybrid jobs during a reservation window | | **Notebooks** | Jupyter/JupyterLab notebook instances for exploring Braket | [notebooks.md](references/notebooks.md) | creating or managing a Braket notebook instance, Jupyter, getting-started environment for Braket | | **Pulse control / gate calibrations** | Native gate calibrations and custom pulse sequences on supported QPUs | [pulse-control.md](references/pulse-control.md) | pulse control, gate calibrations, `gate_calibrations`, `refresh_gate_calibrations`, `gate_definitions` | | **Experimental capabilities** | Opt-in device features outside the published specifications | [experimental-capabilities.md](references/experimental-capabilities.md) | features that not all QPUs support, `EnableExperimentalCapability`, `experimental_capabilities` | | **Library integrations** | Third-party frameworks using Braket-owned providers or plugins | [Qiskit](references/libraries-qiskit.md), [PennyLane](references/libraries-pennylane.md) | Qiskit or PennyLane workflows targeting Braket; provider/plugin behavior and Braket-specific compilation, submission, or result retrieval |

Each reference carries the domain detail for its own area — field paths, key names, API shapes, and billing models.

Additional notes:

• **Setup** — first-time account setup, prerequisites, roles, notebooks, and the results S3 bucket

are covered in [setup.md](references/setup.md).

Critical Rules

These rules apply to every Braket request, whatever it involves.

1. **Use credentials with IAM-administrative permissions only for setup actions**, such as creating IAM roles and policies, creating or updating spending limits, and creating S3 buckets or other resources. After setup, use workload credentials with permissions scoped to the workflow.

1. **The Amazon Braket Python SDK (`pip install amazon-braket-sdk`, imported as `braket`) is the primary entry point.** Prefer it for every operation including Braket API operations, and understand what it covers by reading the [docs](https://amazon-braket-sdk-python.readthedocs.io/en/stable/) or inspecting the SDK's modules locally.

• Use local execution tools for running the Braket SDK, such as `shell` with

`python3 -c "<code>"`.

1. **The AWS MCP server is recommended for executing any other AWS API calls in this skill**, especially operations not