---
id: types-pynput
version: "1.8.1.20260712"
license: Apache-2.0
license_treatment: permissive
maintenance: active
---

# types-pynput — Typing stubs for pynput

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

## 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 above — 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

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

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

## Tags

pynput type stubs, type hints for pynput, pynput mypy support, static typing pynput, pynput type checking, typeshed pynput stubs, type-stubs, type-checking

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