agronholm/typeguard

Health v2 · maintenance only

Flags: no_license

Adoption not part of the score

1780 stars · 140 forks observed · 2026-08-28

What it is AI-extracted, prompt v1, taxonomy v1, 2026-08-30, confidence not recorded

Typeguard is a Python library that performs run-time type checking based on PEP 484 type annotations, complementing static type checkers. It offers a check_type function, per-call checking helpers, and code instrumentation via a @typechecked decorator or an import hook.

Use cases

• validate function arguments against type hints at runtime
• check arbitrary objects against complex type annotations
• catch type violations that static checkers miss
• automatically instrument modules with type checking on import
• verify generator yield and send values match annotations

When to choose

• you want runtime enforcement of type hints in Python code
• you need isinstance-like checks supporting generic and arbitrary annotations
• you want automatic type checking without modifying function bodies

When to avoid

• you only need static type analysis (use mypy or pyright)
• runtime type checking overhead is unacceptable in hot code paths
• target module source code is unavailable for instrumentation

Facets

library · maturity active

type-system testing developer-tools developer-tools programming-languages testing python cross-platform runtime-type-checking type-annotations pep-484 type-hints instrumentation

Member repositories

For agents

markdown · JSON · MCP: product_card(name="agronholm/typeguard")