amazon-braket/amazon-braket-sdk-python
A Python SDK for interacting with quantum devices on Amazon Braket
Amazon Braket Python SDK
Amazon Braket Python SDK 是一個開源程式庫,讓您使用 Python 程式碼在 Amazon Braket 上執行量子運算工作。它提供以下功能:
- 裝置抽象(
AwsDevice、Devices):支援 Amazon 主機的模擬器與實際量子處理器(例如 Rigetti、IonQ 等)。 - 電路建構:透過
braket.circuits.Circuit。 - 工作提交(
device.run、device.run_batch)與結果取得。 - 混合工作支援(
AwsQuantumJob):支援結合古典與量子步驟的流程。 - 本機模擬器:內建於 SDK 中,無需 AWS 資源即可快速原型開發。
快速上手
# 從 PyPI 安裝 SDK
pip install amazon-braket-sdk
您需要 Python 3.11+、Git、具備 Braket 權限的 AWS 帳戶(IAM 使用者/角色),以及 AWS SDK for Python(boto3)。使用 SDK 前請先設定 AWS 憑證與區域。
簡單範例 – 在 SV1 模擬器上產生貝爾態
from braket.aws import AwsDevice
from braket.circuits import Circuit
from braket.devices import Devices
# 選擇管理型狀態向量模擬器
device = AwsDevice(Devices.Amazon.SV1)
# 建構一個 2 量子位元的貝爾電路
bell = Circuit().h(0).cnot(0, 1)
# 提交工作(100 次測量)並列印測量直方圖
task = device.run(bell, shots=100)
print(task.result().measurement_counts)
SDK 會自動處理工作建立、輪詢與結果解析。
並行執行多個電路
circuits = [bell for _ in range(5)]
batch = device.run_batch(circuits, shots=100)
print(batch.results()[0].measurement_counts)
批次提交可大幅提升模擬器上的大規模工作負載處理速度。
混合工作(古典 + 量子)
from braket.aws import AwsQuantumJob
job = AwsQuantumJob.create(
device="arn:aws:braket:::device/quantum-simulator/amazon/sv1",
source_module="job.py",
entry_point="job:run_job",
wait_until_complete=True,
)
print(job.result())
SDK 會啟動一個基於 Docker 的工作,可同時執行多個量子任務與一般 Python 程式碼。
本機模擬
SDK 內建 braket_sv,一個可在您的筆電上執行的快速狀態向量模擬器,適合在提交至雲端前進行快速除錯。
文件與協助
- 速查表 – 常用呼叫的單頁概覽:https://amazon-braket.github.io/amazon-braket-sdk-python/
- 完整 API 參考 – https://amazon-braket-sdk-python.readthedocs.io/
- 範例 – 請參閱配套的
amazon-braket-examples倉儲中的 Jupyter 筆記本。 - 支援 – 在 GitHub 上開立問題,或在 Quantum Computing Stack Exchange 提問。
授權
Apache-2.0。
簡要總結:Amazon Braket Python SDK 是一個生產就緒的工具包,可在 AWS 的 Braket 服務上建構、提交與管理量子電路與混合工作負載,支援雲端主機與本機模擬器。
相關
- 專案
- 專案
- 專案
- 專案
- 專案