IntelliJ IDEA 2018.1 Help

Installing, Uninstalling and Upgrading Packages

IntelliJ IDEA provides methods for installing, uninstalling, and upgrading Python packages for a particular Python SDK.

To manage Python packages, navigate to File | Project Structure, select SDKs under the Platform Settings section, and select the target Python SDK from the list of the available SDKs. Switch to the Packages tab to preview the list of the available packages.

Installing a Python package

If you select a Python SDK with the configured Conda environment, the Use Conda Package Manager toggle appears in the Packages tab toolbar.

Using the Conda package manager

Use this toggle to manage packages from the Conda environment repository. By default, this toggle is switched off and you can manage only the packages available with the selected Python interpreter.

To install a package

  1. Click Install (Install a package).
  2. In the dialog box that opens, preview the list of the available packages.
    Show available packages
    To specify a custom repository, including devpi or PyPi, click Manage Repositories.
    In the Manage Repositories dialog box that opens, click Add a repository to add a URL of a local repository, for example,http://localhost:3141/root/pypi/+simple/, then click OK. In the Available Packages dialog, click Update the list of packages to reload the list of the packages.
  3. Type the name of the package to install in the Search field. The list shrinks to show the matching packages only.
    Search for a particular package
  4. 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.
    • Install to user's site packages directory <path>: If this checkbox is left cleared (by default), then the packages will be installed into the current interpreter package directory. If the checkbox is selected, the packages will be installed into the specified directory. This option is not available for Conda environments.
  5. Select the target package and click Install Package.

To uninstall a package

  1. In the Packages tab, select the packages to be removed.
  2. Click Uninstall (Uninstall a package). The selected packages are removed from disk.

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 New version is available and suggests to upgrade it.

To upgrade a package

  1. In the Packages tab, select the package to be updated.
  2. Click Upgrade (py upgrade package icon). Note that clicking Apply doesn't lead to package upgrading. This button only utilizes all performed package changes.
    Upgrading Python packages
    The selected packages are upgraded to the latest available versions.
Last modified: 26 June 2018

See Also