Skip to the content
Know your tech before you buy it. Makers: get listed from $49/mo

setuptools

setuptools.pypa.io

  • Free plan
  • Windows
  • macOS
  • Linux

What setuptools is

setuptools is a free library for packaging Python projects so they can be shared and installed. It can act as a project’s packaging build backend, discover packages and namespaces, and let maintainers control which packages are distributed. The library handles build-system requirements and required or optional dependencies, including version restrictions and environment markers. Dependency groups are supported. Configured entry points can generate scripts during installation, including console commands and plugin entry points. Editable installs allow source changes to take effect without rebuilding and reinstalling. setuptools can also build C and C++ extension modules. Its documentation describes using it with pip, build, and PyPI for building and distributing Python packages. The project identifies modern PyPA-standard APIs and documented customization APIs as its most stable supported interfaces. The current PyPI listing requires Python 3.10 or later. setuptools runs on Linux, macOS, and Windows. The listed plan is free, and professional support is available through a Tidelift Subscription.

Who it suits

setuptools suits Python maintainers who package projects for distribution, including projects with dependencies, entry points, or C and C++ extensions. It runs across Linux, macOS, and Windows.

Good to know, and what to watch

  • Free Python packaging library
  • Acts as a packaging build backend
  • Supports required and optional dependencies
  • Editable installs reflect source changes
  • Builds C and C++ extension modules
  • Requires Python 3.10 or later
  • No lockfile support
  • No environment management
  • No package publishing

Setuptools

Free

Free plan

The verdict

setuptools covers core packaging, dependency declaration, installation scripts, editable development, and native extensions. Its Python-version requirement and lack of built-in publishing or environment-management features are important boundaries.

What the maker publishes

Build backend
Setuptools can serve as the packaging build backend for Python projects. source
C and C++ extensions
Setuptools can build C and C++ extension modules. source
Compatibility
The project identifies modern PyPA-standard APIs and documented customization APIs as its most stable supported interfaces. source
Compatibility limits
The current PyPI listing states that setuptools requires Python 3.10 or later. source
Dependencies
Setuptools supports build system requirements, required dependencies, and optional dependencies with version restrictions and environment markers. source
Editable installs
Setuptools supports editable installs that let source changes take effect without rebuilding and reinstalling the package. source
Entry points
Setuptools can create scripts during installation from configured entry points, including console commands and plugin entry points. source
Integrations
The documentation describes using setuptools with pip, build, and PyPI as part of building and distributing Python packages. source
Package discovery
Setuptools can automatically discover packages and namespaces and lets maintainers customize which packages are distributed. source
Purpose
Setuptools is a library designed to facilitate packaging Python projects for sharing and installation. source
Security maintenance
The release history documents security fixes, including a fix preventing archive members from being extracted outside the requested directory. source
Support
Professional support for setuptools is available through a Tidelift Subscription. source

Checked against the maker's pages on 8 Oct 2026.