IntelliJ IDEA 2021.2 Help

Configure a Conda virtual environment

IntelliJ IDEA supports creating virtual environments for Python with Conda. The following procedure applies to all supported operating systems. Use the platform switcher at the top of this page to view shortcuts specific to your operating system.

To create a Conda environment

  1. Ensure that Anaconda or Miniconda is downloaded and installed on your computer, and you're aware of a path to its executable file.

    Refer to the installation instructions for more details.

  2. Ensure that the Python plugin is installed and enabled.

  3. Navigate to File | Project Structure Ctrl+Alt+Shift+S.

    Adding a new SDK

  4. In the Project Structure dialog, select SDKs under the Platform Settings section, click Add a new SDK, and from the popup menu, choose Python SDK.

    Adding a new Python SDK

  5. In the left-hand pane of the Add Python Interpreter dialog, select Conda Environment. The following actions depend on whether the Conda environment existed before.

    Configuring a new Python SDK

    If New environment is selected:

    1. Specify the location of the new Conda environment in the text field, or click Conda environment location and find location in your file system. Note that the directory where the new Conda environment should be located, must be empty!

    2. Select the Python version from the list.

    3. Specify the location of the Conda executable file in the text field, or click Conda executable location and find location in the Conda installation directory. You're basically looking for a path that you've used when installing Conda on your machine.

    4. Select the Make available to all projects checkbox, if needed.

    If Existing environment is selected:

    1. Expand the Interpreter list and select any of the existing interpreters. Alternatively, click Select an interpreter and specify a path to the Conda executable in your file system, for example, C:\Users\jetbrains\Anaconda3\python.exe.

    2. Select the checkbox Make available to all projects, if needed.

  6. Click OK to complete the task.

IntelliJ IDEA can create a Conda environment for your project based on the environment.yml file.

For any of the configured Python interpreters (but Docker-based), you can:

Last modified: 19 March 2021