Install & Compatibility
Where this runs
tested against v1.43.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
muslpy 3.10–3.910 runs
installs and imports cleanly · install 0.0s · import 0.597s · 53.3MB
glibcpy 3.10–3.910 runs
installs and imports cleanly · install 5.6s · import 0.556s · 54MB
52MB installed
● package 52MB
Code
Verified usage
Verified import paths — ran on the pinned version, not inferred.
BraketClient
✓ from mypy_boto3_braket.client import BraketClient
✗ from boto3.client import BraketClient
Type stubs provide specific client types from their own namespace, not directly from `boto3`'s runtime module.
CreateQuantumTaskRequestRequestTypeDef
✓ from mypy_boto3_braket.type_defs import CreateQuantumTaskRequestRequestTypeDef
✗ from boto3.braket.type_defs import CreateQuantumTaskRequestRequestTypeDef
Type definitions are provided by the stub library, not directly from `boto3`.
Session
✓ from boto3.session import Session
The `boto3` Session object is used at runtime and automatically gets type-hinted by the stubs.
Initialize a `boto3` Braket client and leverage the type annotations provided by `mypy-boto3-braket` for autocompletion and static type checking. This example demonstrates how to retrieve and print a list of quantum tasks.
import boto3
from mypy_boto3_braket.client import BraketClient
def get_braket_client() -> BraketClient:
# boto3.client('braket') returns a botocore.client.Braket object at runtime.
# mypy-boto3-braket provides the type hint to make it a BraketClient for static analysis.
client: BraketClient = boto3.client('braket')
return client
if __name__ == '__main__':
# Example usage: list quantum tasks (replace with actual region/credentials if running)
braket_client = get_braket_client()
try:
response = braket_client.list_quantum_tasks(
maxResults=5,
# Additional filtering parameters can be added here
)
print(f"Successfully retrieved {len(response['quantumTasks'])} quantum tasks.")
for task in response.get('quantumTasks', []):
print(f" Task ARN: {task['quantumTaskArn']}, Status: {task['status']}")
except Exception as e:
print(f"Error listing quantum tasks: {e}")
Debug
Known issues
breakingSupport for Python 3.8 was officially removed starting with `mypy-boto3-builder` version 8.12.0. If you are using an older Python version, you will encounter compatibility issues.fixUpgrade your Python environment to 3.9 or newer. The PyPI metadata for this library explicitly requires Python >=3.9.
affects: >=8.12.0 of mypy-boto3-builder (which generates this stub library)
breakingGenerated TypeDef names were changed in `mypy-boto3-builder` version 8.9.0. Specifically, argument TypeDefs like `CreateDistributionRequestRequestTypeDef` were shortened to `CreateDistributionRequestTypeDef`, and conflicting `Extra` postfixes were moved (e.g., `CreateDistributionExtraRequestTypeDef` became `CreateDistributionRequestExtraTypeDef`).fixReview your codebase for type hint imports and usage, and update TypeDef names according to the new naming conventions.
affects: >=8.9.0 of mypy-boto3-builder
gotchaThis library provides *only* type annotations for the `boto3` AWS SDK. `boto3` itself is a separate runtime dependency and must be installed alongside `mypy-boto3-braket` for your code to function at runtime. Without `boto3` installed, type checking will still work, but runtime execution will fail.fixEnsure `boto3` is installed in your environment (e.g., `pip install boto3 mypy-boto3-braket`).
affects: All versions
gotchaThe `mypy-boto3-*` packages are standalone service stubs. For a more integrated experience or to install stubs for multiple services, consider using `boto3-stubs` with service extras (e.g., `pip install 'boto3-stubs[braket]'`). The `mypy-boto3` package is considered legacy and users are encouraged to use `types-boto3` or specific service stubs.fixPrefer `boto3-stubs` with extras for multiple services or `mypy-boto3-service` for individual services. Avoid the old `mypy-boto3` package unless specifically maintaining legacy code.
affects: All versions
Upgrade
Version history
1.43.0latest on PyPI · released Apr 29, 2026
Audit
Dependencies
boto3requiredThis library provides type annotations for `boto3`'s Braket service; `boto3` itself must be installed separately as a runtime dependency.
typing-extensionsoptionalMay be required for full compatibility with older Python versions (pre 3.9) or specific type features, though current versions officially require Python 3.9+.