---
id: boto3-type-annotations-with-docs
version: "0.3.1"
license: MIT License
license_treatment: permissive
maintenance: abandoned
---

# boto3-type-annotations-with-docs — Type annotations for boto3. Adds code completion in IDEs such as PyCharm.

License: permissive · Maintenance: abandoned · Downloads: 119.9K/mo

## What it is and what it does

This package solves a fundamental limitation of boto3: because AWS services are instantiated at runtime using factory methods with string arguments, IDEs cannot infer their types or provide code completion. boto3_type_annotations works around this by defining static stand-in classes for every boto3 service—clients, resources, paginators, and waiters—with full type annotations extracted from boto3's own docstrings. You import these classes and use them to annotate boto3 objects in your code, giving your IDE the type information it needs to offer autocomplete and catch type errors.

The package comes in two variants: a 2.2 MB version without docstrings (boto3_type_annotations) and a 41 MB version with full docstrings (boto3_type_annotations_with_docs, the subject here). The trade-off is size versus development convenience—docstrings in your IDE during development versus a lighter production dependency. The project is abandoned as of 2019, meaning it will not track boto3 API changes or receive updates.

Use it for:

- Enable IDE autocomplete and type checking when writing boto3 code in PyCharm, VS Code, or other IDEs with type support.
- Annotate boto3 client parameters in function signatures to catch argument errors before runtime.
- Develop boto3-heavy applications where IDE support significantly reduces lookup time and typos.
- Use in development environments where docstring access in the IDE is valuable, then switch to the lightweight variant for production.
- Type-check boto3 code with mypy or similar static type checkers to catch service method misuse.

## Worth the install?

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

Provides type-annotated stand-in classes for boto3 AWS service clients, resources, paginators, and waiters to enable IDE code completion and type inference.

Yes, if you actively develop with boto3 and want IDE code completion—the type annotations work and have no runtime overhead. However, be aware the project is abandoned (last update 2019) and will not track boto3 API changes. For production use, prefer the lightweight variant (boto3_type_annotations) unless you need docstrings in development. Monitor boto3 releases; if the API diverges significantly from 2019, these annotations may become inaccurate.

## Install

pip install boto3-type-annotations-with-docs
uv add boto3-type-annotations-with-docs
poetry add boto3-type-annotations-with-docs

## Installing boto3-type-annotations-with-docs

Before you install: Low install friction with no runtime dependencies. However, the project is abandoned—last commit was 2019-11-28 and no releases since 2019-05-02. It will not track boto3 API changes or receive maintenance updates.

License in practice: MIT License (permissive) allows use, modification, and distribution with minimal restrictions. No licensing barrier to adoption.

Quickstart:

pip install boto3_type_annotations_with_docs

import boto3
from boto3_type_annotations.s3 import Client

client: Client = boto3.client('s3')
client.create_bucket(Bucket='my-bucket')

Requires boto3 to be installed separately; type annotations are stand-ins only and do not execute boto3 calls themselves.

Verify before relying:

- Whether type annotations remain accurate for current boto3 versions given the project's abandonment since 2019.
- Compatibility with modern Python versions and type checkers (mypy, pyright) not explicitly stated in the fact sheet.
- Whether the 41 MB package size with docstrings is still acceptable relative to current boto3 and botocore sizes.

## Package facts

- License: MIT License (permissive)
- Python support: unspecified
- Install friction: low
- Maintenance: abandoned
- Downloads: 119.9K/month (top 15,000 on PyPI)
- Known vulnerabilities: none known

## Tags

boto3 type annotations, aws sdk type hints, boto3 ide code completion, type stubs for boto3, boto3 intellisense support, aws client type checking, boto3 static type hints, type-hints, aws-sdk, ide-support

[View on SkillFed](https://skillfed.io/packages/boto3-type-annotations-with-docs) · [View on PyPI](https://pypi.org/project/boto3-type-annotations-with-docs/)