Install & Compatibility
Where this runs
tested against v1.43.80 · pip install
no network on importno background threads
Install × environment matrix
Each cell = how many times install + import succeeded across repeated harness runs. Partial = flaky.
glibc = Debian/Ubuntu slim · musl = Alpine Linux
muslpy 3.10–3.95 runs
installs and imports cleanly · install 0.0s · import 0.000s · 18.7MB
glibcpy 3.10–3.95 runs
installs and imports cleanly · install 1.7s · import 0.000s · 19MB
17MB installed
● package 17MB
Code
Verified usage
Verified import paths — ran on the pinned version, not inferred.
EKSClient
✓ from mypy_boto3_eks import EKSClient
✗ from mypy_boto3_eks import EKSClient
EKSServiceResource
✓ from mypy_boto3_eks import EKSServiceResource
ServiceResource
✓ from mypy_boto3_eks import ServiceResource
This quickstart demonstrates how to use `mypy-boto3-eks` to add type hints to your `boto3` EKS client interactions. It shows importing the `EKSClient` type and a response `TypeDef`, allowing Mypy to validate your code and IDEs to provide better autocompletion.
import boto3
from mypy_boto3_eks.client import EKSClient
from mypy_boto3_eks.type_defs import ListClustersResponseTypeDef
# Initialize a Boto3 EKS client with type hinting from mypy-boto3-eks
client: EKSClient = boto3.client("eks")
# Call a client method and ensure the response is correctly typed
response: ListClustersResponseTypeDef = client.list_clusters()
print("Found EKS clusters:")
for cluster in response.get("clusters", []):
print(f"- {cluster['name']} (version: {cluster.get('version', 'N/A')})")
# mypy will now provide checks for attribute access and types
# Example: if 'nextToken' is present, its type is known
if 'nextToken' in response:
next_token: str = response['nextToken']
print(f"Next Token: {next_token}")
Debug
Known issues
breakingStarting with `mypy-boto3-builder` version 8.12.0 (which generates `mypy-boto3-eks` packages), Python 3.8 is no longer supported. Projects requiring type annotations for EKS must use Python 3.9 or newer.fixUpgrade your Python environment to 3.9 or newer. If you must use Python 3.8, pin `mypy-boto3-eks` to a version generated by builder < 8.12.0, which may mean using an older `boto3` version.
affects: >=8.12.0 (builder), all generated packages from this builder version onwards
gotchaThe version of `mypy-boto3-eks` is closely tied to the `boto3` version it provides stubs for. Using mismatched versions (e.g., `mypy-boto3-eks==1.42.85` with `boto3==1.28.0`) can lead to Mypy errors or incorrect type hints.fixAlways install the `mypy-boto3` stub package version that matches your `boto3` runtime package version. E.g., `pip install boto3==1.42.85 mypy-boto3-eks==1.42.85`.
affects: All versions
breakingInternal type definition (TypeDef) names for request/response structures can change across major builder versions (e.g., `CreateDistributionRequestRequestTypeDef` becoming `CreateDistributionRequestTypeDef`).fixIf you explicitly import and use specific `TypeDef` classes in your type annotations, review your code after upgrading `mypy-boto3-eks` to ensure TypeDef names are still valid. Refer to the specific service's `type_defs.pyi` for current names.
affects: >=8.9.0 (builder)
gotchaService API changes in underlying `boto3` (e.g., service renames like `sms-voice` to `pinpoint-sms-voice` or changes in API parameters) are reflected in the stub packages. This can lead to type errors if your code calls deprecated or renamed methods/services.fixStay informed about `boto3` and AWS API changes. When upgrading `mypy-boto3-eks`, review relevant service documentation and update your code to reflect the latest API conventions. Mypy will help identify outdated calls.
affects: All versions, whenever upstream `boto3` changes
Upgrade
Version history
1.43.80latest on PyPI · released Aug 25, 2026
Audit
Dependencies
boto3optionalProvides the actual AWS API client. This package provides type stubs for it.
mypyoptionalThe static type checker that consumes these type stubs.