---
id: types-aiobotocore
version: "3.9.0"
license: MIT
license_treatment: permissive
maintenance: active
---

# types-aiobotocore — Type annotations for aiobotocore 3.9.0 generated with mypy-boto3-builder 8.12.0

License: permissive · Maintenance: active · Downloads: 10.2M/mo

## What it is and what it does

types-aiobotocore is a stub package that adds comprehensive type annotations for aiobotocore 3.9.0, enabling static type checking and IDE autocompletion. It is generated automatically from botocore schemas using mypy-boto3-builder 8.12.0 and depends on botocore-stubs and typing-extensions.

The package works by providing drop-in type stubs that your IDE and type checker (mypy, pyright, pylint) can use to understand aiobotocore's API without modifying your code. It supports multiple installation modes: base annotations only, service-specific subsets via extras, or full coverage. The documentation is embedded in the type annotations and linked to AWS service docs.

Use it for:

- Enable IDE autocomplete and inline documentation for aiobotocore calls in VSCode with Pylance or PyCharm.
- Catch type errors in async AWS SDK code before runtime using mypy or pyright in CI/CD pipelines.
- Reduce boilerplate by letting your editor infer parameter types and return values for service clients.
- Support multiple IDEs (Emacs, Sublime Text, VSCode, PyCharm) with a single type annotation package.
- Maintain type safety when using aiobotocore in production without adding runtime dependencies via TYPE_CHECKING imports.

## Worth the install?

AI-flagged interpretation of the facts above — verify before relying.

Provides type annotations and IDE autocompletion support for aiobotocore 3.9.0, enabling static type checking with mypy, pyright, and other tools across VSCode, PyCharm, Emacs, and Sublime Text.

Yes. If you use aiobotocore in Python 3.9 or later, installing this package is a straightforward way to add IDE support and static type checking with no runtime overhead. The package is actively maintained, has no known vulnerabilities, and low install friction. The main caveat is PyCharm's documented performance issue with Literal overloads—if you use PyCharm, test the lite variant first or use mypy or pyright instead.

## Install

pip install types-aiobotocore
uv add types-aiobotocore
poetry add types-aiobotocore

## Installing types-aiobotocore

Before you install: Low friction install with only two runtime dependencies (botocore-stubs and typing-extensions). Actively maintained with a recent release 12 days ago and 670 repository stars.

License in practice: MIT license permits unrestricted use, modification, and distribution in both open-source and proprietary projects with minimal restrictions.

Quickstart:

# Install type annotations for aiobotocore
python -m pip install types-aiobotocore

# Use in your code with IDE support
import aiobotocore.session
# IDE now provides autocomplete and type checking for aiobotocore calls

Requires Python 3.9 or later; PyCharm users may experience performance issues with Literal overloads and should consider the lite variant instead.

Verify before relying:

- Whether the lite variant resolves PyCharm performance issues sufficiently for production use.
- Performance impact of full type annotations on large codebases compared to the lite variant.
- Whether all AWS services are covered or only a subset in the base installation.

## Package facts

- License: MIT (permissive)
- Python support: supports_current
- Install friction: low
- Maintenance: active
- Downloads: 10.2M/month (top 5,000 on PyPI)
- Known vulnerabilities: none known

## Tags

aiobotocore type stubs, aws async type annotations, boto3 type hints, mypy aiobotocore support, pyright aws async, ide autocomplete aiobotocore, static type checking aws, type-stubs, aws-sdk, async-io

[View on SkillFed](https://skillfed.io/packages/types-aiobotocore) · [View on PyPI](https://pypi.org/project/types-aiobotocore/)