---
id: types-setuptools
version: "84.0.0.20260812"
license: Apache-2.0
license_treatment: permissive
maintenance: active
---

# types-setuptools — Typing stubs for setuptools

License: permissive · Maintenance: active · Popularity: top 1,000 on PyPI

## Install

pip install types-setuptools
uv add types-setuptools
poetry add types-setuptools

## Description

## Typing stubs for setuptools

This is a [type stub package](https://typing.python.org/en/latest/tutorials/external_libraries.html)
for the [`setuptools`](https://github.com/pypa/setuptools) package. It can be used by type checkers
to check code that uses `setuptools`. This version of
`types-setuptools` aims to provide accurate annotations for
`setuptools==84.0.*`.

Given that `pkg_resources` is typed since `setuptools >= 71.1`, it is no longer included with `types-setuptools`.

This package is part of the [typeshed project](https://github.com/python/typeshed).
All fixes for types and metadata should be contributed there.
See [the README](https://github.com/python/typeshed/blob/main/README.md)
for more details. The source for this package can be found in the
[`stubs/setuptools`](https://github.com/python/typeshed/tree/main/stubs/setuptools)
directory.

This package was tested with the following type checkers:
* [mypy](https://github.com/python/mypy/) 2.3.0
* [pyrefly](https://pyrefly.org/) 1.3.0.dev1
* [pyright](https://github.com/microsoft/pyright) 1.1.411
* [ty](https://docs.astral.sh/ty/) 0.0.59

It was generated from typeshed...

## AI interpretation — verify before relying

Provides type hints for setuptools, enabling static type checkers to validate code that uses setuptools.

Verdict: A lean, actively maintained type stub package with no dependencies and permissive licensing. Tested against mypy 2.3.0, pyright 1.1.411, and other current type checkers for setuptools 84.0.*.

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