Set up a working environment

Change Conda with Anaconda CLI

1. In the Terminal window, run the ls command in the <Conda Home>/envs directory (for example, /Users/jetbrains/.conda/envs) and select the target environment.

2. Navigate to the bin directory of your anaconda installation (for example, anaconda3/bin).

3. Execute the conda activate <env name> command (for example, conda activate my-conda-env).

Change the environment with the Python interpreter selector

• The environment selector is located in the lower-right corner of the DataSpell UI. Click it and select the target environment from the list.

  

1. Press Ctrl+Alt+S and go to Project <workspace> | Python Interpreter. Click and select Add.

   

2. In the Add Python Interpreter dialog, enter the name of the new environment and select the type of environment:

   

   • If New environment is selected:

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

     • Select the Python version from the list.

     • Specify the location of the Conda executable file in the text field, or click 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.

     • 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 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.

   

   • If New environment is selected:

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

     2. Choose the base interpreter from the list, or click and find a Python executable in the your file system.

        If DataSpell detects no Python on your machine, it provides two options: to download the latest Python versions from python.org or to specify a path to the Python executable (in case of non-standard installation).

        

     3. Select the Inherit global site-packages checkbox if you want to inherit your global site-packages directory. This checkbox corresponds to the --system-site-packages option of the virtualenv tool.

     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 and specify a path to the Python executable in your file system, for example, C:\Python36\python.exe.

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

   

   • If you have added the user base’s binary directory to your PATH environmental variable, you don't need to set any additional options: the path to the pipenv executable will be autodetected.

     If you see the Pipenv executable is not found error message, follow the pipenv installation procedure to discover the executable path and add it to the Pipenv executable field.

   

   1. Select the base Python interpreter from the list, or click and find its location in your file system.

   2. If DataSpell has not discovered the Poetry path, click near Poetry executable and navigate to its location. Then click OK in the explorer window to add it to the field.

   3. If Existing environment is selected.

      Expand the Interpreter list and select any of the existing Poetry environments. Alternatively, click and specify a path to it.

Install packages using the environment settings

1. In the Python interpreter selector, select Interpreter Settings.

2. Select the target environment from the Python Interpreter list.

3. Click + to add a new package. Click the Conda package manager button () to manage packages from the Conda repository. Otherwise, DataSpell will be using pip.

4. Type a package name in the search field and locate the target package. If needed, specify a package version. Then press Install

   

5. Close the window on the task completion. If needed, press the Manage Repositories button and add a custom repository from which you install packages.

Install packages in the Terminal window

1. Open the Terminal window.

2. To install a package from pip, execute: pip install <package name> (for example, pip install plotly).

3. To install packages from the Conda repository:

   • Navigate to the bin directory of your anaconda installation (for example, anaconda3/bin)

   • Execute the following command: conda install <package name> (for example, conda install tensorflow).

Upgrade packages

1. In the Python interpreter selector, select Interpreter Settings.

2. Mind the in the Latest version column. Select the corresponding package and click the Upgrade button ().