DataSpell 2022.3 Help

Run DataSpell for the first time

Running DataSpell depends on the operating system:

To run DataSpell, find it in the Windows Start menu or use the desktop shortcut. You can also run the launcher batch script or executable in the installation directory under bin.

Run the DataSpell app from the Applications directory, Launchpad, or Spotlight.

Run the dataspell.sh shell script in the installation directory under bin. You can also use the desktop shortcut if it was created during installation.

Once you launch DataSpell, you will see the Welcome screen, the starting point to your work with the IDE, and configuring its settings. This screen also appears when you close all opened projects. Use the tabs on the left side to switch to the specific welcome dialog.

Customize the IDE appearance

Click Customize and select another color theme or select the Sync with OS checkbox to use your system default theme. Here you can also configure accessibility settings or select another keymap.

Select the UI theme

Disable unnecessary plugins

DataSpell includes plugins that provide integration with different version control systems and application servers, add support for various frameworks and development technologies, and so on. To increase performance, you can disable plugins that you do not need.

Plugin tab on the Welcome screen
If necessary, you can enable them later in the Settings dialog Ctrl+Alt+S under Plugins. For more information, see Install plugins.

You can click the Disable All link for each group of plugins to disable them all, or Customize to disable individual plugins in the group.

Learn DataSpell

Welcome screen: learn DataSpell

Configure an environment for the workspace

When you run DataSpell for the very first time, it suggests configuring an environment for the default workspace. Conda is the recommended option, as it has Jupyter and data science libraries (like pandas) available out of the box.

If you have any Conda environment installed on your machine, DataSpell will suggest it. If no Conda has been detected, you'll be provided with the Conda download link, so that you can download and install it first.

welcome screen

The workspace is a directory that contains all your notebooks and local datasets. You can attach other directories and projects to the workspace.

An environment is required to execute local notebooks.

  1. The following steps depend on your choice:

    Select any of the existing Conda 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.

    • 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 new Conda environment target directory must be empty!

    • Select the Python version from the list.

    • 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, for example, C:\Users\jetbrains\Anaconda3\python.exe.

    Select any of the existing interpreters. Alternatively, click Select an interpreter and specify a path to the Python executable in your file system, for example, C:\Python36\python.exe.

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

    • Choose the base interpreter from the list, or click Choose the base interpreter 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).

    Using a system Python interpreter

    In the Interpreter field, type the fully-qualified path to the required interpreter executable, or click the Browse button and in the Select Python Interpreter dialog that opens, choose the desired Python executable and click OK.

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

    Downloading Python when installing the system interpreter

    You will need administrator privileges to install, remove, and upgrade packages for the system interpreter. When attempting to install an interpreter package through an intention action, you might receive the following error message:

    System Interpreter warning message

    As prompted, consider using a virtual environment for your project.

  2. Once you configure an environment, click Launch DataSpell. DataSpell creates a workspace so that you can start your work.

Last modified: 11 January 2023