Skip to main content
This is a pre-production deployment of Warehouse. Changes made here affect the production instance of PyPI (pypi.python.org).
Help us improve Python packaging - Donate today!

Common Questions

What's a package, project, or release?

We use a number of terms to describe software available on PyPI, like project, release, file, and package. Sometimes those terms are confusing because they're used to describe different things in other contexts. Here's how we use them on PyPI:

A project on PyPI is the name of a collection of releases and files, and information about them. Projects on PyPI are made and shared by other members of the Python community so that you can use them.

A release on PyPI is a specific version of a project. For example, the requests project has many releases, like requests 2.10 and requests 1.2.1. A release consists of one or more files.

A file, also known as a package, on PyPI is something that you can download and install. Because of different hardware, operating systems, and file formats, a release may have several files (packages), like an archive containing source code or a binary wheel.

How do I install a file (package) from PyPI?

To learn how to install a file from PyPI, visit the installation tutorial on the Python Packaging User Guide.

How do I package and publish my code for PyPI?

For full instructions on configuring, packaging and distributing your Python project, refer to the packaging tutorial on the Python Packaging User Guide.

I am having trouble using the PyPI website, can you help me?

We take accessibility very seriously and want to make the website easy to use for everyone.

If you are experiencing an accessibility problem, please report it to us on GitHub, so we can try to fix the problem, for you and others.

Where can I report a bug or provide feedback?

We welcome constructive feedback and bug reports via our issue tracker. Before writing a new issue, please first check that a similar issue does not already exist.

If you report a bug, please provide as much detail as you can. For example:

  • Your operating system
  • Your browser and browser version
  • Whether you can reproduce the bug (does it always happen, or just sometimes after certain actions?)
  • Steps to reproduce (if applicable)
  • Warning or error messages (if applicable)
  • What you expected to happen or your suggested fix (if you have one)

Please note: All users submitting feedback, reporting issues or contributing to Warehouse are expected to follow the PyPA Code of Conduct.

How can I help?

We have a huge amount of work to do to continue to maintain and improve PyPI (also known as the Warehouse project), and would love to see some new faces working on the project.

You do not need to be an experienced open-source developer to make a contribution - in fact, we'd love to help you make your first open source pull request!

If you have skills in Python, HTML, SCSS, or JavaScript, then please take a look at the issue tracker. If you're interested in working on a particular issue, leave a comment and we can guide you through the contribution process.

Please note: All users submitting feedback, reporting issues or contributing to Warehouse are expected to follow the PyPA Code of Conduct.

Resources

Looking for something not listed above? Perhaps these links will help:

Contact

The Python Packaging Authority (PyPA) is a working group who work together to improve Python packaging. If you'd like to get in touch with a core packaging developer, please use #pypa on IRC (freenode), or join the distutils-sig mailing list.

Supported By

WebFaction WebFaction Technical Writing Elastic Elastic Search Pingdom Pingdom Monitoring Dyn Dyn DNS Sentry Sentry Error Logging CloudAMQP CloudAMQP RabbitMQ Heroku Heroku PaaS Kabu Creative Kabu Creative UX & Design Fastly Fastly CDN DigiCert DigiCert EV Certificate Rackspace Rackspace Cloud Servers DreamHost DreamHost Log Hosting