This is a pre-production deployment of Warehouse, however changes made here WILL affect the production instance of PyPI.

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, 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.

If you would like to suggest an improvement, then please use our feedback form. Common feedback will be transferred to our issue tracker to be addressed by the development team.

If you would like to report a bug, then please log an issue directly on our issue tracker.

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

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.


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


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