Sign inGet started

Getting started

Deepnote documentation

Security and privacy


Projects contain your notebooks, scripts, and other assets you need for analysis.

Getting started with projects

A project in Deepnote is a a special kind of container for resources such as notebooks, scripts, data files (e.g., CSVs, images, etc), folders, and more. It also comes with a configurable environment. You can share a project with others for real-time or asynchronous collaboration.

You can create a project from scratch by clicking the project folders in your workspaces as shown below. You can even drag and drop them into new project folders. Organize your workspace in the way that makes sense to you.

Marking a project as favorite using the star in the top right corner will pin it to the top of the left sidebar.

Deepnote can also create projects for you based on your .ipynb files or when you import from Github or Google Drive.

create project from ipynb files

Lastly, you can also create a project from pre-made notebooks that demonstrate common and interesting analytic use cases (ML with SQL, user retention, A/B testing, etc).

Project configuration and details

The right sidebar contains tabs that allow you to configure your project's environment as well as view other important project-level details. Here are a few of the core things you'll want to know about the right sidebar.

Project tab. The "project" tab contains many items that allow you to configure and navigate through your project. For example,

  • Notebooks, for all of your analysis.
  • The hosted filesystem for other files, python scripts or folders you need for your project.
  • Under Environment you can change your machine and configure your environment (e.g., switch to a different runtime or a stronger machine, set up a Dockerfile, etc).
  • The Table of Contents allows you to navigate through your notebooks based on Markdown headers.
  • Open up one or more terminals when you need a CLI.
  • Enable "incoming connections" if you need to make your project accessible over the web (e.g., exposing a port for to access a web server).

Integrations tab. The "integrations" tab allows you to enable any connected integrations you have so you project can make use of them.

Comments tab. The "comments" tab displays comments and allows you to navigate to any comment in the notebook. You can also use this tab to configure which comments you'd like to see.

History tab. The history tab is a view of everything that has happened in a project. You can see previous versions of your notebook and revert your work. For more information about History, please have a look at our versioning support article.