PyCharm 2016.2 Help

Installing, Uninstalling and Upgrading Packages

In this section:

Basics

PyCharm provides a dedicated tool for installing, uninstalling, and upgrading Python packages. So doing, if a packaging tool is missing, PyCharm suggests to install it.

PyCharm smartly tracks the status of packages and recognizes outdated versions by showing the number of the currently installed package version (column Version), and the latest available version (column Latest). When a newer version of a package is detected, PyCharm marks it with the arrow sign arrow_right.

Installing packages

To install a package

  1. In the Project Interpreter page of the project settings, select the desired Python interpreter or virtual environment.
    py_install_packages
  2. Click add.
  3. In the Available Packages dialog box that opens, select the desired package from the list.

    If necessary, use the Search field, where you can enter any string. So doing, the list of packages shrinks to show the matching packages only.

    py_install_packages_search
  4. If required, select the following check boxes:
    • Specify version: if this check box is selected, you can select the desired version from the drop-down list of available versions. By default, the latest version is taken.
    • Options: If this check box is selected, you can type the options in the text field.
  5. Click Install Package.

You can use the various packaging tools, including devpi or PyPi.

To specify a custom repository, follow these steps

  1. In the Project Interpreter page of the project settings, click add, and then, in the Available Packages dialog box, click Manage Repositories.
  2. In the Manage Repositories dialog box that opens, click add to add a URL of a local repository, for example, something like http://somehost/alice/dev.
  3. In the Manage Repositories dialog box, click OK.
  4. Back in the Available Packages dialog box, click refresh to reload the list of packages. As a result, the packages that exist on the local server appear.

Uninstalling packages

To uninstall a package

  1. On the Project Interpreter page, in the list of packages, select the ones to be deleted.
  2. Click delete. The selected packages are removed from disk.

Upgrading packages

To upgrade a package

  1. On the Project Interpreter page, in the list of packages, select the packages to be upgraded.
  2. Click arrowUp. The selected package is upgraded to the latest available version.

See Also

Last modified: 23 November 2016