---
id: mypy-boto3-guardduty
version: "1.43.54"
license: MIT
license_treatment: permissive
maintenance: active
---

# mypy-boto3-guardduty — Type annotations for boto3 GuardDuty 1.43.54 service generated with mypy-boto3-builder 8.12.0

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

## What it is and what it does

This package provides type stubs for boto3's GuardDuty service, generated by mypy-boto3-builder. It enables static type checkers (mypy, pyright) and IDEs (VSCode, PyCharm, Emacs, Sublime Text) to understand and validate GuardDuty client calls, offering autocomplete and catching type errors at development time rather than runtime.

The package is purely a type-annotation layer—it has no runtime behavior and depends only on typing-extensions. It's designed to be installed alongside boto3 and works by providing type information for GuardDuty's client, paginators, waiters, and service models. Installation is straightforward via pip, and it integrates transparently with most Python development environments.

Use it for:

- Enable IDE autocompletion and type checking when writing boto3 GuardDuty code in VSCode or PyCharm.
- Catch GuardDuty API call errors (wrong parameters, missing arguments) before runtime using mypy or pyright.
- Document GuardDuty client method signatures and return types for team members reading the code.
- Validate paginator and waiter usage with full type hints for GuardDuty operations.
- Integrate GuardDuty type checking into CI/CD pipelines using mypy or pyright without runtime overhead.

## Worth the install?

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

Provides type annotations and IDE autocompletion for boto3's GuardDuty service, enabling static type checking with mypy, pyright, and editor support.

Yes, if you use boto3 GuardDuty in a typed Python project. The package is actively maintained, has no security vulnerabilities, carries a permissive MIT license, and adds negligible install friction. It's particularly valuable in codebases using mypy or pyright, or in IDEs like VSCode with Pylance. The only caveat: PyCharm users may experience performance issues with the full type stubs and should consider boto3-stubs-lite instead.

## Install

pip install mypy-boto3-guardduty
uv add mypy-boto3-guardduty
poetry add mypy-boto3-guardduty

## Installing mypy-boto3-guardduty

Before you install: Low friction: single runtime dependency (typing-extensions), wheel-only distribution, and actively maintained with recent releases. Designed as a lightweight type-stub package with no complex build requirements.

License in practice: MIT license permits unrestricted use, modification, and distribution. Safe to include in commercial or proprietary projects without licensing obligations.

Quickstart:

pip install mypy-boto3-guardduty

from boto3.session import Session
from mypy_boto3_guardduty import GuardDutyClient

client: GuardDutyClient = Session().client("guardduty")
# Type checking and IDE autocompletion now work on client methods

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

Verify before relying:

- Whether the package works with all boto3 versions or only 1.43.54 and nearby releases.
- Performance impact on PyCharm (documentation mentions potential slowness with Literal overloads).
- Whether paginators and waiters are fully typed or only partially covered.

## Package facts

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

## Tags

boto3 type stubs guardduty, aws guardduty type annotations, boto3 guardduty mypy support, guardduty client type hints, boto3 stubs ide autocomplete, aws type checking guardduty, boto3 guardduty pyright, type-stubs, aws-guardduty, boto3

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