Skip to main content
This is a pre-production deployment of Warehouse. Changes made here affect the production instance of PyPI (
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.

What does pre-production mean?

This is mostly just a warning at this point that the UI might return funky results, some things might not be great yet and to discourage throwing the full force of people's production traffic at it.

The current hosting arrangement can't handle the full amount of traffic we get from pip install however uploads are fine and we're working on building on the new infrastructure with our future hosting arrangement that can handle the full production load.

Why isn't my desired Project name available?

When creating a new Project on PyPI, you may recieve an error from your publishing tool which indicates that a project is not able to be created with your desired name. In addition you may find that there are no associated project or release on, currently there are three primary reasons this may occur:

  • The project name conflicts with a Python Standard Library module from any major version from 2.5 to present.
  • The project name has been explicitly prohibitted by the PyPI administrators, for example pip install requirements.txt is a common typo for pip install -r requirements.txt, and should not surprise the user with a malicious package.
  • The project name has been registered by another user, but no releases have been created.

How do I claim an abandoned or previously registered Project name?

There is currently no established process for performing this administrative task that is explicit and fair for all parties. However, one is currently in development with PEP 541

When PEP 541 is accepted, the project will create a workflow, to be documented here.

Who maintains PyPI?

Warehouse is an open source project developed under the umbrella of the Python Packaging Authority (PyPA) and supported by the Python Packaging Working Group (PackagingWG).

The PyPA is an independent group of developers whose goal is to improve and maintain many of the core projects related to Python packaging.

The PackagingWG is a working group of the Python Software Foundation (PSF) whose goal is to raise and disburse funds to support the ongoing improvement of Python packaging.

What powers PyPI?

PyPI is powered by a variety of tools and services provided by our generous sponsors.


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