Python Interpreter

When you configure a Python interpreter, you need to specify the path to the Python executable in your system. So, before configuring a Python interpreter, you need to ensure that you've downloaded Python and installed it in your system and you're aware of a path to it. You can create several Python interpreters based on the same Python executable. This is helpful when you need to create different virtual environments for developing different types of applications. For example, you can create one virtual environment based on Python 3.6 to develop Django applications and another virtual environment based on the same Python 3.6 to work with scientific libraries.

Use this page to configure and assign a Python interpreter for each of the projects opened in the same window.

Interpreters

Item	Description
Python Interpreter	For the project, selected in the Projects pane, choose Python interpreter from the list. The interpreters in the list are configured using the button, as described in the section Viewing list of available Python interpreters. When PyCharm stops supporting any of the outdated Python versions, the corresponding Python interpreter is marked as unsupported.
Path mappings	This field is only available for the remote interpreters! This field shows read-only mappings between the desired local path and the corresponding remote path. PyCharm allows configuring paths by clicking next to the field. In the dialog that opens, click or buttons to change the path mappings as desired.
	Click this button to configure an interpreter: From the list, choose the one to be added: Add: choose this option to add a locally residing Python interpreter. This includes also virtual environments and Conda environments. Also, choose this option to add a Python interpreter that resides remotely. Show all: choose this option to open the list of all interpreters, available to the current project.

Item

Description

Python Interpreter

For the project, selected in the Projects pane, choose Python interpreter from the list.

The interpreters in the list are configured using the button, as described in the section Viewing list of available Python interpreters.

Path mappings

This field is only available for the remote interpreters!

This field shows read-only mappings between the desired local path and the corresponding remote path. PyCharm allows configuring paths by clicking next to the field. In the dialog that opens, click or buttons to change the path mappings as desired.

Click this button to configure an interpreter:

Add an interpreter or show the list of available interpreters

From the list, choose the one to be added:

Add: choose this option to add a locally residing Python interpreter. This includes also virtual environments and Conda environments. Also, choose this option to add a Python interpreter that resides remotely.
Show all: choose this option to open the list of all interpreters, available to the current project.

Packages

This table shows the packages installed locally.

Item	Description
Package	This column shows the list of packages residing in the accessible remote repositories. For each package you can view its name and repository. Additional information is displayed at the tooltip.
Version	This column shows the currently installed version of a package.
Latest	This column shows the latest available versions of the packages. If a version is outdated and the package can be upgraded, mark appears in this column.

Packages toolbar

Item	Tooltip and shortcut	Description
	Install `Alt+Insert`	Click this button to install a new package from the accessible remote repositories.
	Uninstall `Alt+Delete`	Click this button to uninstall the selected local package.
	Upgrade	Click this button to install the latest available version of a package. This button is only available for the outdated package versions.
	Show earlier releases	Click this button if you want to extend the scope of the latest available versions to any pre-release versions (such as beta or release candidate).
	Use Conda Package Manager	This button appears for Conda interpreters ONLY! If this button is pressed, the Conda package manager is used. If this button is released, than pip is used.

Last modified: 14 September 2021