Manage your workspace
Whatever you do in DataSpell, you do that in the workspace. Your workspace can contain local notebooks and other files, attached directories, and attached projects.
Attach a directory
Do one of the following:
Click the Attach new of existing directory link in the Workspace tool window.
Selectfrom the main menu.
Click the icon on in the toolbar of the Workspace tool window.
Select the target directory in your systems. Click Ok to confirm your choice.
To attach a new directory to the workspace, select thefrom the main menu or right-click the workspace tree and select from the context menu. Then specify the directory name and its location.
DataSpell automatically configures a default virtual environment, so that you can execute notebooks and scripts. You can change it or create a new virtual evnironment.
If you want to work with any projects created in IntelliJ IDEA based IDE, you can open them from disk.
Open your project from disk
Press Ctrl+Alt+S to open the IDE settings and select Appearance and Behavior | System Settings.
Select Reopen projects on startup and Ask. Save you changes and close IDE settings.
From the main menu, select
In the Open File or Project dialog that opens, specify the location of the desired project directory.
Select the way DataSpell will open the project:
In the new window
In the current window replacing the default workspace
Attaching the project to the default workspace
Open a directory from Git
Do one of the following:
On the Welcome Screen, click the Get from Version Control link.
From the main menu, select.
Right-click the workspace tree or a directory and selectfrom the context menu
Select the version control system where your project is stored. Here it is Git:
Specify the path to the repository and select the directory to which a project will be cloned. Alternatively, you can select GitHub on the left, login using your credentials, and select any project you want to work with.
Once you cloned a Git directory, DataSpell create a Python virtual environment, so that you can work with your files.
If any of the attached directories requires a previously configured environment that is not currently available, DataSpell shows a warning and provides two options: select an environment that fits the previous configuration or configure another Python interpreter (environment):
Note, when you have an environment based on the outdated version of Python, the following message appears:
Click Configure Python interpreter to set up a valid one.
Detach a directory
Right-click the target directory and selectfrom the context menu.
Connect to a Jupyter server
Click the icon on the toolbar of the Workspace tool window to establish a connection to a Jupyter server.
In the New Jupyter Connection dialog, select the connection type:
Run local Jupyter server: run a Jupyter server in a local directory that will be attached to your workspace.
Connect to running Jupyter server: establish a connection to any locally run Jupyter server. The option is enabled if there is at least one active Jupyter server on your machine. Run
jupyter notebook listin the Terminal window to check if there are any.
Connect by URL: establish a connection to a remote Jupyter server. The target URL should contain a server name or its address, and the access token.
Once the connection has been established, the server and its structure are shown in the Workspace tool window.
Once you have connected to a remote server, you can open, edit, and run remote notebooks.