IntelliJ IDEA 2017.3 Help

Installing, Uninstalling and Upgrading Packages

The following is only valid when Python Plugin is installed and enabled!

In this section:

Basics

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

IntelliJ IDEA 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, IntelliJ IDEA marks it with the arrow sign arrow right.

Invoking 'Manage Python Packages' dialog box

To invoke the 'Manage Python Packages' dialog box

  • On the main menu, choose Tools | Manage Python Packages. The Manage Python Packages dialog box opens.

Installing packaging tools

To install packaging tools

  1. In the Manage Python Packages dialog box, choose the desired Python interpreter from the drop-down list of available Python interpreters.
  2. If no distribute package management tool has been detected for the selected interpreter, click the Install 'distribute' link that appears in the lower part of the dialog box.
  3. If no pip packaging tool has been detected for the selected interpreter, click the Install 'pip' link that appears in the lower part of the dialog box.

    With the packaging tools installed, the existing packages are detected and shown in the dialog box.

    python manage packages

    Note that outdated packages are marked with the blue arrows arrow right.

Installing packages

To install a package

  1. In the Manage Python Packages dialog box, click Install
  2. In the 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.

    python available packages
  3. If required, select the following checkboxes:
    • Specify version: if this checkbox 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 checkbox is selected, you can type the options in the text field.
  4. 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 dialog box that opens, 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. In the Available Packages dialog, 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. In the Packages column of the Manage Python Packages dialog box, select the packages to be uninstalled.
  2. Click delete. The selected packages are removed from disk.

Upgrading packages

To upgrade a package

  1. In the Packages column of the Manage Python Packages dialog box, select the package to be upgraded.
  2. Click arrowUp.
    py upgrade packages
    The selected package is upgraded to the latest available version.
Last modified: 6 March 2018

See Also