Run DataSpell for the first time

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.

note

Try the new DataSpell user interface.

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.

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.

When you run DataSpell for the first time, you can choose one of the following options:

• Quick Start

  DataSpell workspace is opened. You can add directories and projects, as well as Jupyter connections to the workspace.

  For more information, refer to Quick Start.

• Projects

  Select this option if you want to work with projects. You can either open an existing project from disk or VCS, or create a new project.

  For more information, refer to Work with projects in DataSpell.

If you want to start working with DataSpell workspace, select Quick Start on the welcome screen.

You need to configure the default environment for the workspace. An environment consists of a Python interpreter with a set of installed packages. DataSpell uses the default environment to run Jupyter notebooks and Python scripts. You can later configure separate environments for specific projects or directories.

First of all, select the environment type. Conda is the recommended option, as it has Jupyter and data science libraries (like pandas) available out of the box.

The following steps depend on your choice:

Existing environment

New environment

Configure later

conda

Virtualenv

System interpreter

1. If you have conda installed on your machine, DataSpell will fill the Conda Executable field with the detected path to conda executable. If no conda is detected, you'll be provided with the conda download link, so that you can download and install it first.

   Alternatively, you can specify the path to the conda executable manually, or click to browse for it.

2. In the Conda environment drop-down, select any of the existing conda environments.

• Select any of the existing interpreters in the Interpreter field.

• Alternatively, click and browse for a Python executable within an existing virtual environment, for example, /Users/jetbrains/DataspellProjects/MyProject/venv/bin/python (macOS, Linux) or C:\Users\jetbrains\DataspellProjects\MyProject\venv\Scripts\python.exe (Windows).

1. In the Interpreter drop-down, select the desired Python executable.

   

2. If it's not on the list, click to browse for the desired Python executable.

If DataSpell detects no Python on your machine, it will let you download and install the latest stable Python version from python.org.

conda

Virtualenv

1. If you have conda installed on your machine, DataSpell will fill the Conda Executable field with the detected path to conda executable. If no conda is detected, you'll be provided with the conda download link, so that you can download and install it first.

   Alternatively, you can specify the path to the conda executable manually, or click to browse for it.

2. Specify the name of the environment in the Environment name field.

1. Specify the location for the new environment on the Location field. You can click to browse for the desired directory. Note that the directory must be empty.

2. In the Base interpreter drop-down, select the desired Python executable.

   

3. If it's not on the list, click to browse for the desired Python executable.

If DataSpell detects no Python on your machine, it will let you download and install the latest stable Python version from python.org.

Select the Inherit global site-packages checkbox if you want all packages installed in the global Python on your machine to be added to the virtual environment you're going to create. This checkbox corresponds to the --system-site-packages option of the virtualenv tool.

No default environment will be configured for the workspace. In order to run Jupyter notebooks or Python scripts, you'll need to configure it later. Alternatively, you can configure separate environments for directories and projects within the workspace.

When you are ready, click Launch DataSpell.

On the Projects tab of the welcome screen, you can do the following:

• Create a new project

• Open an existing project

• Get a project from a version control system