pypa/packaging.python.org

Python Packaging User Guide

Python

1,677

3,147 commits

updated Oct 12, 2026

See the code

README

Python Packaging User Guide
===========================

http://packaging.python.org

The "Python Packaging User Guide" (PyPUG) aims to be the authoritative resource on
how to package and install distributions in Python using current tools.

To follow the development of Python packaging, see the `Python
Packaging Authority <https://www.pypa.io/en/latest/>`_.

Code of Conduct
---------------

Everyone interacting in the Python Packaging User Guide project's codebases,
issue trackers, chat rooms, and mailing lists are expected to follow the
`PSF Code of Conduct`_.

.. _PSF Code of Conduct: https://github.com/pypa/.github/blob/main/CODE_OF_CONDUCT.md

Contributing
------------

This guide is community-maintained and contributions are welcome! Please see the
`contributing guide`_ for details on our writing style guide and how to build
the guide locally to test your changes.

.. _contributing guide: https://packaging.python.org/contribute

License
-------

The Python Packaging User Guide is licensed under a Creative Commons
Attribution-ShareAlike license: http://creativecommons.org/licenses/by-sa/3.0 .

History
-------

This Guide was forked from the “Hitchhiker's Guide to Packaging” in March 2013,
which was maintained by Tarek Ziadé. Thank you Tarek for all your efforts in
Python packaging.

Not written in Markdown, so it's shown here as plain text — view it formatted on GitHub.

pypa/packaging.python.org

Python Packaging User Guide

Python

1,677

3,147 commits

updated Oct 12, 2026

See the code

README

Python Packaging User Guide
===========================

http://packaging.python.org

The "Python Packaging User Guide" (PyPUG) aims to be the authoritative resource on
how to package and install distributions in Python using current tools.

To follow the development of Python packaging, see the `Python
Packaging Authority <https://www.pypa.io/en/latest/>`_.

Code of Conduct
---------------

Everyone interacting in the Python Packaging User Guide project's codebases,
issue trackers, chat rooms, and mailing lists are expected to follow the
`PSF Code of Conduct`_.

.. _PSF Code of Conduct: https://github.com/pypa/.github/blob/main/CODE_OF_CONDUCT.md

Contributing
------------

This guide is community-maintained and contributions are welcome! Please see the
`contributing guide`_ for details on our writing style guide and how to build
the guide locally to test your changes.

.. _contributing guide: https://packaging.python.org/contribute

License
-------

The Python Packaging User Guide is licensed under a Creative Commons
Attribution-ShareAlike license: http://creativecommons.org/licenses/by-sa/3.0 .

History
-------

This Guide was forked from the “Hitchhiker's Guide to Packaging” in March 2013,
which was maintained by Tarek Ziadé. Thank you Tarek for all your efforts in
Python packaging.

Not written in Markdown, so it's shown here as plain text — view it formatted on GitHub.

Project health

Overall

6.3/10

Maintained

10/10

Code review

10/10
OpenSSF Scorecard

Significant stargazers

Marco Edward Gorelli

693 followers · starred Dec 2024

Cooper Lees

190 followers · starred May 2022

Nikolaus Waxweiler

71 followers · starred Jul 2019

FichteFoll

233 followers · starred Nov 2019