types-pynput

What it is and what it does

types-pynput is a type stub package that provides type annotations for the pynput library. It allows static type checkers like mypy and pyright to understand and validate code that uses pynput's keyboard and mouse input APIs. The stubs are maintained as part of the typeshed project and are kept in sync with pynput version 1.8.1.

This package contains no runtime code—it exists purely to help your type checker understand pynput's API surface. You install it alongside pynput (or in your development environment) so that when you run type checking, the checker can verify that you're calling pynput functions correctly and with the right argument types.

Use it for:

• Enable mypy or pyright to catch type errors in code that controls keyboard or mouse input via pynput.
• Document the expected types for pynput function arguments and return values in an IDE with type-aware autocomplete.
• Enforce type safety in automation or testing scripts that use pynput for input simulation.
• Integrate pynput type checking into a CI/CD pipeline that runs static analysis on Python projects.

Worth the install?

AI-flagged interpretation of the facts on this page — verify before relying

Provides type hints for the pynput library, enabling static type checkers like mypy and pyright to validate code that uses pynput for keyboard and mouse input.

Yes, if you use pynput and run static type checking. It has no runtime cost, low install friction, and is actively maintained. Install it in your development or CI environment alongside pynput to catch type-related bugs early. Not necessary if you don't use a type checker or don't use pynput.

Install

types-pynput on PyPI

pip install types-pynput

uv add types-pynput

poetry add types-pynput

Installing types-pynput

Before you install

Low friction—a pure stub package with no runtime dependencies. Actively maintained as part of typeshed, with recent releases and no known vulnerabilities.

License in practice

Licensed under Apache-2.0 (permissive), allowing free use, modification, and distribution with minimal restrictions.

Quickstart

pip install types-pynput

# In your code, type checkers will now understand pynput imports:
from pynput.keyboard import Listener
from pynput.mouse import Controller

Requires Python 3.10 or later.

Verify before relying

• Whether pynput itself must be installed separately for these stubs to be useful in type checking workflows.
• Compatibility with type checkers other than mypy 2.2.0 and pyright 1.1.411.

Package facts

Evidence: types_pynput-1.8.1.20260712-py3-none-any.whl

Tags

More Software Development packages