IntelliJ IDEA 2017.1 Help

Installing, Uninstalling and Upgrading Packages

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 /help/img/idea/2017.1/arrow_right.png.

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.

    /help/img/idea/2017.1/python_manage_packages.png

    Note that outdated packages are marked with the blue arrows /help/img/idea/2017.1/arrow_right.png.

Installing packages

To install a package

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

    /help/img/idea/2017.1/python_available_packages.png
  3. 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.
  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 /help/img/idea/2017.1/new.png, and then, in the Available Packages dialog box, click Manage Repositories.
  2. In the Manage Repositories dialog box that opens, click /help/img/idea/2017.1/new.png 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 /help/img/idea/2017.1/refresh.png to reload the list of packages. As a result, the packages that exist on the local server appear.

Uninstalling packages

To uninstall a package

  • Click /help/img/idea/2017.1/delete.png. The selected packages are removed from disk.

Upgrading packages

To upgrade a package

  • Click /help/img/idea/2017.1/arrowUp.png. The selected package is upgraded to the latest available version.

See Also

Last modified: 18 July 2017