Install & Compatibility
Where this runs
tested against v3.7.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.000s · 19.1MB
glibcpy 3.10–3.910 runs
installs and imports cleanly · install 4.4s · import 0.000s · 20MB
17MB installed
● package 17MB
Code
Verified usage
Verified import paths — ran on the pinned version, not inferred.
get_session
✓ from aiobotocore_stubs.session import get_session
✗ from aiobotocore-stubs.session import get_session
This example demonstrates how to use `aiobotocore` with `types-aiobotocore-lite` installed. The type hints for `S3Client`, `CreateBucketRequestRequestTypeDef`, and `CreateBucketOutputTypeDef` are provided by the stub package. To verify type checking, run `mypy your_script_name.py` after installing `aiobotocore` and `types-aiobotocore-lite`.
import asyncio
from aiobotocore.session import get_session
from typing import TYPE_CHECKING, Dict, Any
# These imports are for type checking only and won't be executed at runtime
if TYPE_CHECKING:
# Example: S3Client is made available by types-aiobotocore-lite for common services
from types_aiobotocore_s3.client import S3Client
from types_aiobotocore_s3.type_defs import CreateBucketRequestRequestTypeDef, CreateBucketOutputTypeDef
async def create_s3_bucket(bucket_name: str) -> Dict[str, Any]:
session = get_session()
async with session.create_client("s3") as client: # type: S3Client
# Now 'client' is type-checked as S3Client
request_params: CreateBucketRequestRequestTypeDef = {
"Bucket": bucket_name
}
response: CreateBucketOutputTypeDef = await client.create_bucket(**request_params)
print(f"Bucket '{bucket_name}' created: {response}")
return response
async def main():
# Replace with a unique bucket name, AWS credentials must be configured
await create_s3_bucket("my-unique-test-bucket-12345")
if __name__ == "__main__":
# Make sure AWS_ACCESS_KEY_ID and AWS_SECRET_ACCESS_KEY are set in your environment
# or ~/.aws/credentials is configured.
asyncio.run(main())
Debug
Known issues
breakingPython 3.8 support has been removed in versions generated by mypy-boto3-builder 8.12.0 and newer. Ensure your project uses Python 3.9 or newer.fixUpgrade your Python environment to 3.9 or higher.
affects: >=3.4.0 (generated by mypy-boto3-builder >= 8.12.0)
breakingThe `sms-voice` service is no longer supported and has been removed from generated packages. Use `pinpoint-sms-voice` instead.fixMigrate your code to use the `pinpoint-sms-voice` client and types.
affects: >=3.4.0 (generated by mypy-boto3-builder >= 8.11.0)
breakingTypeDef naming conventions changed in builder 8.9.0, leading to shorter names for packed method arguments and reordered postfixes for conflicting TypeDefs (e.g., `CreateDistributionRequestRequestTypeDef` -> `CreateDistributionRequestTypeDef`).fixUpdate your TypeDef imports and usage to reflect the new naming conventions, or pin to an older `types-aiobotocore-lite` version if backward compatibility is critical.
affects: >=3.4.0 (generated by mypy-boto3-builder >= 8.9.0)
gotchaIt is crucial to keep the `types-aiobotocore-lite` version aligned with the `aiobotocore` version you are using. Mismatched versions can lead to incorrect type hints or `mypy` errors.fixAlways install `types-aiobotocore-lite` that matches the major.minor version of your `aiobotocore` installation (e.g., `types-aiobotocore-lite==3.4.*` for `aiobotocore==3.4.*`).
affects: all
gotcha`types-aiobotocore-lite` provides type stubs for a *subset* of commonly used AWS services. If you require type hints for a less common service not included in the 'lite' package, you may need to install the full `types-aiobotocore` package or the individual service stub package (e.g., `types-aiobotocore-rekognition`).fixIf `mypy` reports missing types for a specific service, consider installing the full `types-aiobotocore` or the specific service stub: `pip install types-aiobotocore` or `pip install types-aiobotocore-<service>`.
affects: all
Upgrade
Version history
3.7.0latest on PyPI · released May 10, 2026
Audit
Dependencies
aiobotocorerequiredProvides type stubs for this runtime library; typically, `types-aiobotocore-lite` should be installed alongside `aiobotocore`.