Python Packaging User Guide

Welcome to the Python Packaging User Guide, a collection of tutorials and references to help you distribute and install Python packages with modern tools.

This guide is maintained on GitHub by the Python Packaging Authority. We happily accept any contributions and feedback. 😊

Get started

Essential tools and concepts for working within the Python development ecosystem are covered in our Tutorials section:

• To get an overview of the flow used to publish your code, see the packaging flow

• To learn how to install packages, see the tutorial on installing packages

• To learn how to manage dependencies in a version controlled project, see the tutorial on managing application dependencies

• To learn how to package and distribute your projects, see the tutorial on packaging and distributing

• To get an overview of packaging options for Python libraries and applications, see the Overview of Python Packaging

Learn more

Beyond our Tutorials, this guide has several other resources:

• The Guides section for walk throughs, such as Installing pip/setuptools/wheel with Linux Package Managers or Packaging binary extensions.

• The Discussions section for in-depth references on topics such as Deploying Python applications or pip vs easy_install.

• The PyPA specifications section for packaging interoperability specifications.

Additionally, there is a list of other projects maintained by members of the Python Packaging Authority.