Skip to main content
Version: 2026.06

Notebooks

Preview

Notebooks is a preview feature, available behind an opt-in toggle. Turn it on under Application Settings → Experimental Features → Notebooks. Behavior and labels may change before general availability.

A notebook is an interactive Python document that lives inside a system. Notebooks use the standard Jupyter .ipynb format and run in your browser, so you can write and execute code against the resources in a system without setting up a local environment. A notebook is made up of code cells (Python) and markdown cells (formatted text), and can reference other files in the same system through @-links.

Notebooks are files like any other resource in a system: they appear in the system's file tree, are versioned, and follow the same access control as the rest of the system's content.

Create a notebook​

  1. Open the system you want to add the notebook to.
  2. In the left panel file tree, click the + (Add files) control.
  3. In the Add Files modal, select the Notebook tab.
  4. Enter a name for the notebook.
  5. Click Create notebook.

A new notebook is created as a file in the system. Creating it captures a new commit, and you land on the notebook ready to edit.

Required access: Write access to the system.

A new notebook starts with a single markdown cell so you can describe what it does.

Open a notebook​

In the system file tree, click any .ipynb file. The notebook opens in the main content area as an editor, showing its cells in order with a toolbar across the top.

The header shows a kernel status indicator that reflects whether the in-browser Python environment is ready, running, or in an error state.

Work with cells​

A notebook is an ordered list of cells. Each cell is one of two types:

  • Code cells contain Python. They run in the notebook's in-browser kernel and display their output — text, tables, and images — directly beneath the cell. A run counter (for example, [1]) shows the order in which cells were executed.
  • Markdown cells contain formatted text. They render as headings, lists, links, tables, and math (LaTeX is supported), giving you a place to document your work.

Edit a cell​

Click inside a cell to edit it. Code cells provide Python syntax highlighting and autocompletion; markdown cells show a live preview of the rendered text.

Add a cell​

  • Click the + on the toolbar to add a cell, or
  • Click a divider between two cells to insert a new cell at that position and choose whether it is a code or markdown cell.

Move or delete a cell​

Hover over (or focus) a cell to reveal its toolbar, then:

  • Use the up / down arrows to move the cell within the notebook.
  • Click the trash icon to delete the cell.

Run code​

  • Run one cell: focus a code cell and click Run cell.
  • Run the whole notebook: click Run all cells (the play icon) in the header to execute every code cell from top to bottom.

While a cell runs, its run indicator shows [*]; when it finishes it shows its execution number. Output — including standard output, errors, and rendered results such as HTML or images — appears below the cell.

Reference other resources with @-links​

Notebooks can work directly with the other files in the same system. Inside a code or markdown cell, click Add link to open the resource picker and choose a file. This inserts an @-reference (for example, @my_model).

When the notebook runs, each @-link resolves to a live Python object for that resource, so you can load and operate on the system's models and artifacts in your code.

Save, discard, and download​

  • Save with Cmd + S / Ctrl + S, or click the Save button (it appears once you have unsaved changes). Saving stores a new version of the notebook.
  • Discard reverts the notebook to its last saved version.
  • Download the notebook as a standard .ipynb file using the download icon in the header — useful for running it in another Jupyter environment or sharing it outside the platform.

Required access: Write access to the system is needed to save changes. Read access is enough to open and view a notebook.

  • Systems — notebooks are files within a system.
  • Files and Content — manage versions and details of files, including notebooks.