Registry / type-stubs / types-aiobotocore-lite

types-aiobotocore-lite

JSON →
library3.7.0pypypiunverified

types-aiobotocore-lite provides lite type annotations for the `aiobotocore` library, version 3.4.0. It offers Mypy-compatible stubs for a common subset of AWS services, generated by `mypy-boto3-builder`. The project maintains a frequent release cadence, often aligning with `aiobotocore` and `mypy-boto3-builder` updates.

pip install types-aiobotocore-lite
INSTALL
IMPORT
SIG · TYPES-AIOBOTOCORE-
T
types-aiobotocore-lite
type-stubspythonv3.7.0
Install
4.4s avg
Import
Disk
17MB
Pass rate
10/ 10
Env Coverage10 / 10
glibc
3.93.13
musl
3.93.13
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
musl
py 3.103.910 runs
installs and imports cleanly · install 0.0s · import 0.000s · 19.1MB
glibc
py 3.103.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.
fix
Upgrade 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.
fix
Migrate 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`).
fix
Update 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.
fix
Always 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`).
fix
If `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`.
Agent activity
43 hits · last 30 days
node
38
OpenAI (training)
1
Resources
types-aiobotocore-lite — pip install types-aiobotocore-lite · libregistry