---
id: types-boto3-s3
version: "1.43.66"
license: MIT
license_treatment: permissive
maintenance: active
---

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

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

## What it is and what it does

This package is a type stub library that adds static type information to boto3's S3 service. It was generated using mypy-boto3-builder 8.12.0 and provides complete type annotations for S3 clients, paginators, waiters, and service resources. When installed, it enables IDEs like VSCode, PyCharm, Emacs, and Sublime Text to offer code completion and type checking for S3 operations without requiring explicit type annotations in your code.

The package is designed to work with type checkers including mypy and pyright, and supports Python 3.9 through 3.14. It has a single runtime dependency on typing-extensions and is maintained actively—the repository shows recent commits and the package was released 7 days ago. The type annotations cover the full S3 API surface, including client methods, paginators for iterating large result sets, and waiters for polling operations.

Use it for:

- Enable IDE autocomplete and type checking when writing boto3 S3 code in VSCode with Pylance or PyCharm.
- Run mypy or pyright on a codebase using boto3 S3 to catch type errors before runtime.
- Provide explicit type hints for S3Client, paginators, and waiters in function signatures and variable declarations.
- Use in Emacs or Sublime Text with LSP and pyright for real-time type checking and code completion.
- Avoid runtime errors by catching S3 API misuse during development with static type analysis.

## Worth the install?

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

Provides type annotations and IDE autocompletion support for boto3 S3 1.43.66, enabling static type checking with mypy, pyright, and other tools.

Yes. This is a low-friction, actively maintained type stub package with no known vulnerabilities and a permissive MIT license. Install it if you use boto3 S3 and want IDE autocomplete, static type checking, or both. It adds no runtime overhead and requires only typing-extensions as a dependency.

## Install

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

## Installing types-boto3-s3

Before you install: Low install friction with a single runtime dependency (typing-extensions). Actively maintained with a release 7 days ago and 670 repository stars.

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

Quickstart:

pip install types-boto3-s3

from boto3.session import Session
from types_boto3_s3 import S3Client

client: S3Client = Session().client("s3")
# Type checking and IDE autocomplete now available

Requires Python 3.9 or later; boto3 itself must be installed separately for runtime use.

Verify before relying:

- Whether PyCharm performance issues with Literal overloads mentioned in the description have been resolved in recent versions.
- Whether the lite variant (types-boto3-lite) offers meaningful performance improvements for large projects.

## Package facts

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

## Tags

boto3 s3 type annotations, boto3 type stubs, s3 client type hints, boto3 mypy support, aws s3 type checking, boto3 ide autocomplete, s3 static typing, type-stubs, aws-sdk, static-typing

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