Registry / type-stubs / types-aiobotocore

types-aiobotocore

library3.9.0pypypi✓ verified 27d ago

types-aiobotocore provides PEP 561 compliant type annotations for the `aiobotocore` library, enabling static type checking for asynchronous AWS client interactions. It helps catch type-related errors before runtime and improves IDE autocompletion. The current version is 3.4.0, and new versions are released frequently, tied to updates in the `mypy-boto3-builder` and `aiobotocore` itself.

type-stubs aws

pip install types-aiobotocore

github ↗package ↗docs ↗

INSTALL

IMPORT

SIG · TYPES-AIOBOTOCORE

types-aiobotocore

type-stubspythonv3.9.0

Install

4.4s avg

Import

—

Disk

17MB

Pass rate

10/ 10

Env Coverage10 / 10

glibc

3.9–3.13

musl

3.9–3.13

Install & Compatibility

Where this runs

tested against v3.9.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.10–3.95 runs

installs and imports cleanly · install 0.0s · import 0.000s · 19.1MB

glibc

py 3.10–3.95 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.

AioSession

✓ from aiobotocore_stubs.session import AioSession

✗ from aiobotocore_stubs.session import AioSession

This quickstart demonstrates how to use `aiobotocore` to list S3 buckets. By installing `types-aiobotocore` (and potentially `types-aiobotocore-s3`), your static type checker (like MyPy) will understand the types of `session` and `client`, providing autocompletion and error checking without altering the runtime code. Note that `aiobotocore` itself must be installed.

import asyncio from aiobotocore.session import get_session async def main(): session = get_session() # `types-aiobotocore` provides type stubs for the session and client. # For S3 specific types, you would also install `types-aiobotocore-s3`. async with session.create_client("s3") as client: response = await client.list_buckets() print("S3 Buckets:", [b["Name"] for b in response.get("Buckets", [])]) if __name__ == "__main__": asyncio.run(main())

Debug

Known issues

breakingPython 3.8 support has been removed as of `mypy-boto3-builder` version 8.12.0 (which generates `types-aiobotocore` 3.4.0). Users on Python 3.8 will need to upgrade to Python 3.9+.

fix

Upgrade your Python environment to 3.9 or higher.

affects: >=3.4.0

breakingThe builder migrated to PEP 561 compliant packages in version 8.12.0. While this is generally an improvement for type checker discovery, older type checker configurations or specific environments might require re-evaluation of how stub packages are found.

fix

Ensure your type checker (e.g., MyPy) is up-to-date and correctly configured to discover PEP 561 stubs. Reinstalling the package might resolve issues.

affects: >=3.4.0

gotchaThis `types-aiobotocore` package specifically provides type stubs for the *core* `aiobotocore` library (e.g., `AioSession`, generic `Client`). For service-specific type stubs (e.g., `S3Client`, `EC2Client`, `ListBucketsOutputTypeDef`), you must install the corresponding service package like `types-aiobotocore-s3`.

fix

Install service-specific type stub packages (`pip install types-aiobotocore-<service_name>`) for type checking related to individual AWS services.

affects: All

gotcha`types-aiobotocore` only provides type annotations; it does not include the `aiobotocore` runtime library itself. Both must be installed for your code to execute and be type-checked.

fix

Ensure you have `aiobotocore` installed via `pip install aiobotocore` alongside `types-aiobotocore`.

affects: All

Upgrade

Version history

3.9.0latest on PyPI · released Aug 2, 2026

Audit

Dependencies

aiobotocorerequiredThis package provides type stubs for aiobotocore. aiobotocore must be installed separately for runtime functionality.

Agent activity

33 hits · last 30 days

node

OpenAI (training)

Resources

githubhttps://github.com/youtype/mypy_boto3_builder ↗

packagehttps://pypi.org/project/types-aiobotocore/ ↗

docshttps://youtype.github.io/types_aiobotocore_docs/ ↗