Legacy Notebook Editor

Use the Code OSS based notebook editor for a notebook experience that seamlessly integrates with the Positron IDE.

You can create and edit .ipynb files in Positron just as you would in other editors.

For a general introduction to working with Jupyter Notebooks, see the VS Code Jupyter Notebooks documentation.

Tip

Looking for integrated AI assistance, data exploration, and improved data science workflows? Try the Positron Notebook Editor, currently in public alpha. Give it a try and share your feedback to help us build the best experience together!

Setting up your environment

Positron comes bundled with Jupyter kernel support for R and Python. Once you’ve configured a Python or R environment for Positron, you do not need to install any additional dependencies into your environment before using a notebook.

If an environment installed on your computer isn’t available in Positron, you may want to read more about how Positron discovers Python installations and R installations.

Selecting a notebook kernel

When you first open a Jupyter Notebook, Positron will automatically select an interpreter based on the notebook’s language, the current workspace, and your configuration. The interpreter used by the notebook is visible in the Kernel Selector in the notebook editor action bar.

Note

We recommend matching the notebook interpreter to the active interpreter of the IDE, however, they can be controlled separately. See Managing Interpreters to learn more.

The Legacy Notebook Editor action bar with the kernel selector highlighted, showing Python 3.12.8 as the selected interpreter.

The Legacy Notebook Editor action bar with the kernel selector highlighted, showing Python 3.12.8 as the selected interpreter.

You can manually select a different interpreter for the notebook by clicking the Kernel Selector button in the notebook editor action bar or by running the Notebook: Select Notebook Kernel command from the Command Palette.

Customization

To set the default working directory for a notebook, use the notebook.workingDirectory setting.