IntelliJ IDEA 2023.3 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.

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.

    For more information, refer to the installation instructions.

  2. Navigate to File | Project Structure or press Ctrl+Alt+Shift+S.

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

    Adding a new Python SDK
  4. In the left-hand pane of the Add Python Interpreter dialog, select Conda Environment.

    New Conda environment
  5. The following actions depend on whether you want to create a new conda environment or to use an existing one.

    New conda environment
    • Specify the location of the new conda environment in the Location field, or click Conda environment location and browse for the desired location in your file system. The directory for the new conda environment should be empty.

    • Select the Python version from the list.

    • Normally, IntelliJ IDEA will detect conda installation.

      Otherwise, specify the location of the conda executable, or click Conda executable location to browse for it.

    • Select the Make available to all projects checkbox if you want to reuse this environment when creating Python interpreters in IntelliJ IDEA.

    Existing conda environment
    • Select the environment from the list.

    • If the desired interpreter is not on the list, click, and then browse for the Python executable within the previously configured conda environment.

    • If necessary, specify the location of the conda executable, or click to browse for it.

    • Select the Make available to all projects checkbox if you want to reuse this environment when creating Python interpreters in IntelliJ IDEA.

    The selected conda environment will be reused for the current project.

  6. Click OK to complete the task.

If the directory with your source files contains an environment.yml file, IntelliJ IDEA can create a conda environment based on it.

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

Last modified: 22 February 2024