Features

This plugin provides the classes BraketEngine for submitting photonic circuits to Amazon Braket and BraketJob for tracking the status of the Braket task.

BraketEngine and BraketJob have the same interfaces as RemoteEngine in Strawberry Fields and Job in the Xanadu Cloud Client, respectively, and can be used as drop-in replacements:

from braket.strawberryfields_plugin import BraketEngine

eng = BraketEngine("arn:aws:braket:us-east-1::device/qpu/xanadu/Borealis")
result = eng.run(prog, shots=1000)  # Synchronous, returns sf.Result
job = eng.run_async(prog, shots=1000)  # Asychronous, returns BraketJob
print(job.status)

Installation

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

• Download and install Python 3.7.2 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 Strawberry Fields:

  pip install strawberryfields

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

pip install amazon-braket-strawberryfields-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/aws/amazon-braket-strawberryfields-plugin-python.git
cd amazon-braket-strawberryfields-plugin-python
pip install .

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

pip show amazon-braket-strawberryfields-plugin

or alternatively from within Python:

from braket import strawberryfields_plugin
strawberryfields_plugin.__version__

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

tox -e unit-tests

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

tox

export AWS_PROFILE=Your_Profile_Name

tox -e integ-tests

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

tox -e docs

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

• Source Code: https://github.com/aws/amazon-braket-strawberryfields-plugin-python

• Issue Tracker: https://github.com/aws/amazon-braket-strawberryfields-plugin-python/issues

• General Questions: https://quantumcomputing.stackexchange.com/questions/ask (add the tag amazon-braket)

• Strawberry Fields Forum: https://discuss.strawberryfields.ai

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.