There are many tools and approaches that can be used to create a Python package. We build resources that help you both understand the tool ecosystem and also learn how to create a Python package using modern best practices.

Community-created Python Packaging Guide

A group of people working on a tetris like set of building blocks, trying to stack the blocks together.

Our packaging guide is a living document that will help you navigate the Python packaging ecosystem and learn about modern Python packaging best practices.

  • Created & curated by the community
  • Reviewed by beginner to expert level Pythonistas
  • Accurate, modern & beginner-friendly

All contributions are recognized both on our website and in the guidebook’s citation.

Scientific Python packaging guidebook sections

Beginner friendly Python packaging tutorials

Beginner-friendly Python packaging tutorials that will take you through the full process of creating a Python package, following modern best practices.

What is a Python package

Learn about what a Python package is and the basic components that make up a Python package.

View Tutorial

Make your Python code installable

Learn how to create the most basic version of a Python package which can then be installed into a Python environment.

View Tutorial

Publish your Python package to PyPI

Learn how to publish your Python package to test.PyPI.org and to PyPI.org.

View Tutorial

Get Involved: Help us improve our scientific Python packaging resources

A black and grey sketch of a group of people sitting at a desk in front of a monitor smiling.

We need your help! Our packaging content is community-created and reviewed through an open review process on GitHub. The more feedback that we get, the more useful our resources are to the community. Get involved by:

  • Opening an issue about problems that you find in our guidebook
  • Submitting a pull request that fixes a typo or mistake in the guide.
  • Get credit for your contribution

All contributions are recognized both on our website and in the guidebook’s citation.

See what we're working on now