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

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

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

## What it is and what it does

This package is a type stub library generated by mypy-boto3-builder 8.12.0 that adds complete type annotations for the aiobotocore S3 service. It enables static type checkers (mypy, pyright) and IDEs (VSCode, PyCharm, Emacs, Sublime Text) to provide accurate code completion, inline documentation, and type error detection when working with async AWS S3 operations through aiobotocore.

The stubs cover the full S3 API surface including clients, paginators, waiters, service resources, and type definitions. Installation is straightforward—a single pip command adds the types to your environment, and they work automatically with any IDE or type checker that supports stub packages. The package has no runtime behavior; it only provides metadata for development-time tooling.

Use it for:

- Enable IDE autocompletion and inline type hints when writing async S3 code with aiobotocore in VSCode or PyCharm.
- Run mypy or pyright type checking on aiobotocore S3 code to catch type errors before runtime.
- Document S3 API method signatures and parameter types in your codebase without writing manual annotations.
- Reduce bugs in async S3 operations by catching incorrect method calls or argument types at development time.
- Generate paginator and waiter type hints for complex S3 operations like listing large buckets or waiting for uploads.

## Worth the install?

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

Provides type stubs and IDE autocompletion support for aiobotocore S3 3.9.0, enabling static type checking with mypy, pyright, and other tools.

Yes, if you use aiobotocore for S3 operations. The package is actively maintained, has no security vulnerabilities, carries a permissive MIT license, and adds zero runtime overhead. Install friction is minimal (one dependency). The only caveat is PyCharm users may experience performance issues with the full type stubs on large projects; the docs recommend the lite variant in that case.

## Install

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

## Installing types-aiobotocore-s3

Before you install: Low install friction with a single lightweight dependency (typing-extensions). Active maintenance with a recent release 12 days ago; repository shows 670 stars and steady commits.

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

Quickstart:

# Install
python -m pip install types-aiobotocore-s3

# Use in code
from aiobotocore.session import get_session
from types_aiobotocore_s3 import S3Client

session = get_session()
async with session.create_client("s3") as client:
    client: S3Client
    # Type checking and IDE completion now work

Requires aiobotocore 3.9.0 to be installed separately; Python 3.9 or later.

Verify before relying:

- Performance impact on PyCharm noted in docs (issue PY-40997) but severity/current status unclear.
- Whether types-aiobotocore-lite variant is recommended for production deployments over full version.

## 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 s3 type stubs, type annotations aws s3 async, mypy boto3 s3 types, pyright aiobotocore completion, s3 client type hints, async aws sdk typing, ide autocomplete s3 client, type-stubs, aws-sdk, async-io

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