Skip to main content

Amazon Braket PennyLane Plugin

Latest Version Supported Python Versions Build Status codecov Documentation Status

The Amazon Braket PennyLane plugin offers four Amazon Braket quantum devices to work with PennyLane:

  • braket.aws.qubit for running with the Amazon Braket service’s quantum devices, both QPUs and simulators

  • braket.local.qubit for running the Amazon Braket SDK’s local simulator where you can optionally specify the backend (“default”, “braket_sv”, “braket_dm” etc)

  • braket.aws.ahs for running with the Amazon Braket service’s analog Hamiltonian simulation QPUs

  • braket.local.ahs for running analog Hamiltonian simulation on Amazon Braket SDK’s local simulator

The Amazon Braket Python SDK is an open source library that provides a framework to interact with quantum computing hardware devices and simulators through Amazon Braket.

PennyLane is a machine learning library for optimization and automatic differentiation of hybrid quantum-classical computations.

The plugin documentation can be found here: https://amazon-braket-pennylane-plugin-python.readthedocs.io/en/latest/.

Features

Provides four devices to be used with PennyLane:

  • Two gate-based devices, braket.aws.qubit for running on the Amazon Braket service, and braket.local.qubit for running on the Amazon Braket SDK’s local simulator.

  • Two analog Hamiltonian simulation devices, braket.aws.ahs for running on QPU via the Amazon Braket service, and braket.local.ahs for running on the Amazon Braket SDK’s local simulator.

  • Combines Amazon Braket with PennyLane’s automatic differentiation and optimization.

For the gate-based devices:

  • Both devices support most core qubit PennyLane operations.

  • All PennyLane observables are supported.

  • Provides custom PennyLane operations to cover additional Braket operations: ISWAP, PSWAP, and many more. Every custom operation supports analytic differentiation.

For the analog Hamiltonian simulation devices:

  • The devices support ParametrizedEvolution operators created via the PennyLane pulse programming module.

  • PennyLane observables in the measurement (Z) basis are supported

  • Provides translation of user-defined pulse level control to simulation and hardware implementation

Installation

Before you begin working with the Amazon Braket PennyLane Plugin, make sure that you installed or configured the following prerequisites:

  • Download and install Python 3.11 or greater. If you are using Windows, choose the option Add Python to environment variables before you begin the installation.

  • Make sure that your AWS account is onboarded to Amazon Braket, as per the instructions here.

  • Download and install PennyLane:

    pip install pennylane

You can then install the latest release of the PennyLane-Braket plugin as follows:

pip install amazon-braket-pennylane-plugin

You can also install the development version from source by cloning this repository and running a pip install command in the root directory of the repository:

git clone https://github.com/amazon-braket/amazon-braket-pennylane-plugin-python.git
cd amazon-braket-pennylane-plugin-python
pip install .

You can check your currently installed version of amazon-braket-pennylane-plugin with pip show:

pip show amazon-braket-pennylane-plugin

or alternatively from within Python:

from braket import pennylane_plugin
pennylane_plugin.__version__

Tests

Make sure to install test dependencies first:

pip install -e "amazon-braket-pennylane-plugin-python[test]"

Unit tests

Run the unit tests using:

tox -e unit-tests

To run an individual test:

tox -e unit-tests -- -k 'your_test'

To run linters, doc, and unit tests:

tox

Integration tests

To run the integration tests, set the AWS_PROFILE as explained in the amazon-braket-sdk-python README:

export AWS_PROFILE=Your_Profile_Name

Running the integration tests creates an S3 bucket in the same account as the AWS_PROFILE with the following naming convention amazon-braket-pennylane-plugin-integ-tests-{account_id}.

Run the integration tests with:

tox -e integ-tests

To run an individual integration test:

tox -e integ-tests -- -k 'your_test'

Documentation

To build the HTML documentation, run:

tox -e docs

The documentation can then be found in the doc/build/documentation/html/ directory.

Contributing

We welcome contributions - simply fork the repository of this plugin, and then make a pull request containing your contribution. All contributers to this plugin will be listed as authors on the releases.

We also encourage bug reports, suggestions for new features and enhancements, and even links to cool projects or applications built with the plugin.

Support

If you are having issues, please let us know by posting the issue on our Github issue tracker, or by asking a question in the forum.

License

This project is licensed under the Apache-2.0 License.

Metadata

Release files for amazon-braket-pennylane-plugin 1.36.0

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for amazon-braket-pennylane-plugin 1.36.0
File Size Uploaded Provenance
amazon_braket_pennylane_plugin-1.36.0.tar.gz 38.8 kB With provenance Details

Built distribution (wheel)

Table of built distributions (wheels) for amazon-braket-pennylane-plugin 1.36.0
File Interpreter ABI Platform
amazon_braket_pennylane_plugin-1.36.0-py3-none-any.whl Python 3 none any Details

Total release size: 81.5 kB

Release files / amazon_braket_pennylane_plugin-1.36.0.tar.gz

Download URL amazon_braket_pennylane_plugin-1.36.0.tar.gz
Size 38.8 kB
Tags Source
SHA-256 checksum
How to use checksums
5c234e998e5b9178f8bea1051ce022b192587c0225bc7272b5c006b093b9297a
BLAKE2b-256 checksum
How to use checksums
1675e6c39974e0dd3685945e8036ad7af58171300c1d3fb9f0d882f46a3aaa28
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.16

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Oct 21, 2026.

Transparency log

Release files / amazon_braket_pennylane_plugin-1.36.0-py3-none-any.whl

Download URL amazon_braket_pennylane_plugin-1.36.0-py3-none-any.whl
Size 42.7 kB
Tags Python 3
SHA-256 checksum
How to use checksums
a8cd5b0393c55044b9bee096da0d71567bbed1e1b92c5c05244f5d51ecf7fb57
BLAKE2b-256 checksum
How to use checksums
78e3bd621b35e02196d46d4525c75814d3a4b91e33fda991a7ab1f68aeef74f7
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.16

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Oct 21, 2026.

Transparency log

Security for amazon-braket-pennylane-plugin 1.36.0

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

Full provenance

All 2 files in this release have been uploaded with provenance metadata.

Select from 2 files

Attestation for amazon_braket_pennylane_plugin-1.36.0.tar.gz

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Oct 21, 2026.

Transparency log

A note on package security

PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.

To learn more about protecting yourself from malicious actors, visit our package security documentation.

Release history Release notifications | RSS feed

This release

1.36.0 This release

2 release files Full provenance

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page