Registry /
aws / amazon-braket-default-simulator
Install & Compatibility
Where this runs
tested against v1.33.0 · pip install
no network on importno background threads
Install × environment matrix
Each cell = how many times install + import succeeded across repeated harness runs. Partial = flaky.
glibc = Debian/Ubuntu slim · musl = Alpine Linux
py 3.10
✕ build_error
✓ 17.6s
py 3.11
✕ build_error
✓ 18.1s
py 3.12
✕ build_error
✓ 18.5s
py 3.13
✕ build_error
✓ 18.3s
446MB installed
● package 446MB
Code
Verified usage
Verified import paths — ran on the pinned version, not inferred.
LocalSimulator
✓ from braket.default_simulator import LocalSimulator
✗ from braket.devices import LocalSimulator
Set up and run a quantum circuit on the local default simulator.
from braket.devices import LocalSimulator
from braket.circuits import Circuit
# Create a local simulator device
device = LocalSimulator()
# Build a Bell state circuit
circuit = Circuit().h(0).cnot(0, 1)
# Run the circuit
result = device.run(circuit, shots=1000).result()
# Get measurement counts
counts = result.measurement_counts
print(counts)
Debug
Known issues
gotchaDo NOT manually import from `amazon_braket_default_simulator` directly. The package is a backend plugin; use `from braket.devices import LocalSimulator` to access the simulator. Direct imports may break or give unexpected results.fixUse `from braket.devices import LocalSimulator` and ensure `amazon-braket-default-simulator` is installed as a dependency.
affects: >=1.0.0
deprecatedThe `LocalSimulator` default backend may change. In older versions, it defaulted to a state vector simulator; newer versions may use density matrix. Always specify the backend if you rely on a specific simulation method.fixExplicitly create the simulator with a backend: `LocalSimulator('braket_dm')` for density matrix or `LocalSimulator('braket_sv')` for state vector. affects: <1.0.0 (historical) or unspecified
Upgrade
Version history
1.39.4latest on PyPI · released Jun 4, 2026
Audit
Dependencies
amazon-braket-sdkrequiredRequired for creating Braket circuits and devices; the simulator is used through the SDK's LocalSimulator.