PyCharm 2022.3 Help

Install, uninstall, and upgrade packages

PyCharm provides methods for installing, uninstalling, and upgrading Python packages for a particular Python interpreter. It means that each project has its own set of packages, which is considered a best practice for Python dependency management. By default, PyCharm uses pip to manage project packages. For Conda environments you can use the conda package manager.

In PyCharm, you can preview and manage packages in the Python Packages tool window and in the Python interpreter Settings.

Manage packages in the Python Packages tool window

The Python Packages tool window provides the quickest and neat way to preview and install packages for the currently selected Python interpreter. This window is enabled by default, and you can find it in the lower group of the tool windows. At any time you can open it using the main menu: View | Tool Windows | Python Packages.

The Python Packages tool window shows installed packages and the packages available in the PyPI and Conda package repositories. Use the Search field to filter out the list of the available packages.

Python Packages tool window

You can preview package documentation in the documentation area, or you can click the Documentation link and open the corresponding resource in a browser.

To delete an installed package, click More actions for an installed package in the upper-right corner of the Python Package tool window.

Install packages from repositories

  1. Start typing the package name in the Search field of the Python Package tool window. You should be able to see the number of the matching packages.

    Install a package in the Python Packages tool window
  2. Expand the list of the available versions in the upper-right corner of the tool window. Select the required version or keep it the latest.

  3. Click the Install with pip or Install with conda button next to the version list. Once PyCharm notifies you about successful installation, you should see the package in the list of the installed packages.

    Installed package
  4. If needed, click repository settings and provide a path to any custom repository you want to install from.

Manage package repositories

  1. To specify a custom repository, including devpi or PyPi, click Custom repositories on the Python Packages toolbar.

    The icon to set custom repoitories
  2. In the Python Packages Repositories dialog, click Add a repository to add a new repository. If no authorization is required, for example, in the case of a local repository, type the target URL and click OK.

    Adding a Python repository: No Authorization
  3. If you want to install Python packages from a repository that requires HTTP authorization, click Basic HTTP and type the repository URL and the login credentials. Click OK to complete the task.

    Adding a Python repository: Basic HTTP Authorization

Once the repository is added, it appears in the list of the repositories in the Python Packages tool window.

Install packages from Version Control System

  1. Click the Add Package link on the Python Packages toolbar and select From Version Control.

  2. Specify a path to the target git repository. Refer to pip documentation for more information about supported path formats.

    Install from Version Control

  3. Select Install as editable (-e) if you want to install a project in editable mode (for example, setuptools develop mode).

Install packages from a local machine

  1. Click the Add Package link on the Python Packages toolbar and select From Disk.

    Install package from disc
  2. Specify a path to the package directory or an archive (zip or whl).

Manage packages in the Python interpreter settings

To manage Python packages for the Python interpreter, select the Python Interpreter page in the project Settings or select Interpreter Settings in the Python Interpreter selector on the Status bar.

Viewing the installed Python packages

If you select a Python interpreter with the configured Conda environment, the Use Conda Package Manager toggle appears in the packages area toolbar.

Using the Conda package manager

Use this toggle to install and upgrade packages from Conda package repositories. This toggle is enabled by default for Conda environments.

Install a package

  1. Click the Install a package button on the package toolbar.

    Add a package
  2. In the Available Packages dialog that opens, preview the list of the available packages and type the name of the package to install in the Search field.

    Show available packages
  3. If required, select the following checkboxes:

    • Specify version: if this checkbox is selected, you can select the desired version from the list of available versions. By default, the latest version is taken.

    • Options: If this checkbox is selected, you can type the pip install command-line 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.

  4. Select the target package and click Install Package.

Uninstall a package

  1. In the list of the packages, select the packages to be removed.

  2. Click Uninstall (Uninstall a package). The selected packages are removed from the interpreter.

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

By default, the Latest version column shows only stable versions of the packages. If you want to extend the scope of the latest available versions to any pre-release versions (such as beta or release candidate), click Show early releases.

Show latest available versions including beta and release candidates

Upgrade a package

  1. In the list of the packages, select the package to be upgraded.

  2. Click Upgrade ( Upgrade).

    Upgrading Python packages

    The selected packages are upgraded to the latest available versions.

  3. Click OK to complete upgrading.

If you're accustomed to installing packages from the command line, you can proceed with your workflow using the Terminal.

Reuse installed packages

Last modified: 11 January 2023