---
id: types-boto3-ecr
version: "1.43.0"
license: MIT
license_treatment: permissive
maintenance: active
---

# types-boto3-ecr — Type annotations for boto3 ECR 1.43.0 service generated with mypy-boto3-builder 8.12.0

License: permissive · Maintenance: active · Downloads: 78.9K/mo

## What it is and what it does

types-boto3-ecr is a type stub package that adds static type information for boto3's ECR (Elastic Container Registry) service. It is generated from boto3 1.43.0 and works with mypy, pyright, VSCode Pylance, PyCharm, and other type-aware tools. When installed, it enables IDE autocompletion and type checking for ECR client operations, paginators, and waiters without requiring explicit type annotations in your code.

The package is a thin layer of type definitions only—it has no runtime behavior and does not replace boto3 itself. It is designed to be installed alongside boto3 in development environments or behind a TYPE_CHECKING guard in production code to avoid a runtime dependency. It supports Python 3.9 through 3.14 and is maintained as part of the mypy-boto3-builder project.

Use it for:

- Enable IDE autocompletion and type hints when writing boto3 ECR code in VSCode, PyCharm, or Emacs.
- Catch type errors in ECR client calls before runtime using mypy or pyright in CI/CD pipelines.
- Annotate ECR client, paginator, and waiter types explicitly in codebases that require strict type safety.
- Provide type information for ECR operations (e.g., describe_repositories, put_image) without manual annotation.
- Use in development environments only via TYPE_CHECKING to avoid adding a production dependency.

## Worth the install?

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

Provides type stubs and annotations for boto3 ECR 1.43.0, enabling type checking and IDE autocompletion when working with AWS Elastic Container Registry through boto3.

Yes, if you use boto3 with ECR and want type checking or IDE autocompletion. Install friction is negligible, maintenance is active, and the MIT license poses no restrictions. The only gotcha is PyCharm's known performance issue with Literal overloads (documented in the package), which may warrant using types-boto3-lite instead. No security vulnerabilities.

## Install

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

## Installing types-boto3-ecr

Before you install: Low install friction with a single lightweight runtime dependency (typing-extensions). Package is actively maintained with recent releases and no known vulnerabilities.

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

Quickstart:

pip install types-boto3-ecr

from boto3.session import Session
from types_boto3_ecr import ECRClient

client: ECRClient = Session().client("ecr")
# Type checking and IDE autocompletion now work

Requires Python 3.9 or later; boto3 must be installed separately in your environment.

Verify before relying:

- Whether PyCharm performance issues mentioned in docs (PY-40997) remain relevant to current versions.
- Whether types-boto3-lite is recommended as a default over the full package for most users.

## Package facts

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

## Tags

boto3 ecr type annotations, aws ecr type stubs, boto3 type hints, ecr client type checking, mypy boto3 ecr, pyright boto3 support, ide autocomplete boto3, type-stubs, aws-sdk, static-analysis

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