Deepnote research: our notes on building agents
Get started

Changelog

October 9, 2026

More powerful Deepnote Agent, enhanced project governance, new Runs page & more

More powerful Deepnote Agent, enhanced project governance, new Runs page & more.png

End-to-end workflows with Deepnote Agent

Deepnote Agent now works as a single agent from your first instruction to the finished notebook, keeping the same context the whole way through. You'll see clearer progress indicators and the tool calls it makes as it goes, and prompt caching has improved, which can lower AI credit usage.

deepnote-agent.gif

Auto AI is now part of Deepnote Agent

Auto AI has moved into the Agent sidebar. Open it from the new icon in the footer, or with Cmd + Shift + A, and ask the Agent to edit blocks or build new analyses from scratch.

auto-ai.png

Enhanced project governance

Private and shared projects can live in the same folder

Keep related work together, whether it’s just for you or shared with your team.

1-folder-private-projects.png
  • Keep private projects in place. Making a project private no longer moves it out of its folder. Each person only sees projects they have access to.
  • Reorganize without resharing. Moving a project to another folder keeps its existing sharing settings.
  • Delete folders without deleting someone else’s private work. Only projects you have permission to delete are removed. Other people’s private projects move to the workspace’s top level.
  • See what’s shared and with whom. The sharing icon shows who can access each project, while “Shared with me” lists only projects explicitly shared with you.

Set a default project permission per folder

Folder permissions callout-selection.png
  • Every new project in that folder is private until someone shares it, whether it's created in the UI, via API or MCP, or by import, duplicate, or template.
  • Existing projects keep their access.
  • Subfolders inherit the parent's default unless given their own.

Latest models, lower prices

All available models have been updated to their newest versions at a lower cost:

  • Luna 5.6 → Luna 6 (50% cheaper)
  • Sol 5.6 → Sol 6 (50% cheaper)
  • Sonnet 5 → Sonnet 5.5 (50% cheaper)
  • Opus 4.8 → Opus 5.5 (20% cheaper)
cheaper-models.png

API & MCP updates

  • Project environments: Let agents choose or switch project environments, including private Docker images.
  • Machine control: Check machine status and start, stop, or restart machines directly.
  • Machine types: Choose compute per run or session, and adjust editor machines and idle shutdown.
  • Write files: Let agents add or overwrite project files, from helper modules to configs and CSVs.
  • Fetch a single block: Retrieve one block's data and output without loading the whole notebook.
  • Delete projects and notebooks: Let agents delete either, with recovery through Trash or project history.

VS Code extension update

The latest Deepnote VS Code extension makes opening a .deepnote file work out of the box, with less setup than before. It now supports uv and poetry alongside pip, and shows a clearer indicator while the Deepnote toolkit installs.

Two more additions:

  • Reuse integrations from other projects or notebook files in a couple of clicks.
  • SQL query chaining is now supported.

Plus a round of fixes and quality-of-life improvements.

See all your notebook runs in one place

All runs now live in a single place, ordered chronologically. Filter them by status, trigger, or member, and open the corresponding run snapshot in one click. To open the Runs page, find the Runs section at the bottom of your workspace and click 'See more'. Run snapshots now also show when they'll expire, both in the UI and the API.

runs-page.gif

Python 3.14

Pick the latest Python environment in your project's environment settings.

Python 3.14.png

Build with Deepnote Agent, ship apps from the API, & more

Build with Deepnote Agent, ship apps from the API, & more.png

Use Deepnote Agent with 90% off GPT-5.6 Sol

Deepnote Agent is available in your workspace, with full context of your project’s integrations or notebooks. To mark this release, AI usage in Deepnote is discounted by 90% until September 8. Give it a try!

agent2.gif

API & MCP updates

  • Publish Streamlit apps

You can now build & publish Streamlit apps through the API via POST /v2/streamlit-apps.

  • Export and import entire projects

Two new endpoints make it easier to move, back up, and update complete projects:

GET /v2/projects/{projectId}/export downloads a project as a ZIP.

POST /v2/projects/{projectId}/import merges the ZIP into an existing project, including notebook changes, project renames, and integrations. You can revert changes thanks to conflict protection and an undo snapshot.

  • Work with folders

Look up folders through API or MCP via list_folders.Full details in the Deepnote API docs.

  • Rename notebooks programmatically

The new PATCH /v2/notebooks/{notebookId} endpoint lets users and agents rename notebooks without opening the Deepnote interface.

Build custom apps on top of notebooks

Introducing @deepnote/local-runner: an open-source toolkit for turning local or cloud Deepnote notebooks into simple custom apps. Let users enter inputs, run the notebook, and inspect outputs like tables and charts. Saves time from having to build the connection between a custom interface and a Deepnote notebook.

VS Code extension v1.6.0

Multi-notebook .deepnote files can now be split into separate files for each notebook. Files are grouped by project, making larger projects easier to navigate and manage in Git.

Introducing Deepnote Agent Workspace

Deepnote Agent Workspace is a shared place where people and agents work on the same data.

Skills, agents, and apps in one workspace

Agent Workspace has three building blocks, connected through Deepnote’s integrations and workspace permissions.

  • Skills capture knowledge and procedures, including the sources and permissions an agent can use.
  • Agents are notebooks with a runtime and instructions. Build them interactively, run them on a schedule, or trigger them through the API.
  • Apps deliver the result to people who do not need to open a notebook, using the workspace’s integrations and permissions.
Notebook_agents.gif Fraud Detection Pipeline.gif

Work with agents wherever the request starts

Agent Workspace is available from Deepnote and through the tools teams already use.

  • In Deepnote
  • From Codex, Claude Code, or any IDE via MCP
  • In Slack
  • From the terminal
  • Headlessly through the API
Fraud Alerts Proactive slack.gif

Each surface connects to the same workspace context. Agents can use the notebooks, integrations, and permissions the data team already maintains rather than starting from an empty conversation.

Project settings get a new home, @ mentions, Trash, & smarter schedules

Project settings get a new home, @ mentions, Trash, & smarter schedules.png

A new home for project settings

Project settings have moved, here's where to find what.

Before: project files, integrations, and the machine picker lived in the left side panel, always visible.

Now: they live in a panel on the right, which opens when you click Settings in the top right of the screen. The same panel includes a new Triggers section, which exposes ways to run a notebook automatically or remotely.

The goal is less clutter in the default view, so notebooks stay front and center.

A new home for project settings.gif

Self-pausing schedules

Scheduled notebooks can now pause themselves after a configurable number of consecutive failures, instead of failing forever and burning compute. It's on by default when you create a new schedule.

Self-pausing schedules.png

EU-hosted OpenAI models for Enterprise

Enterprise customers can now use OpenAI models hosted in the EU, served through Azure's Sweden Central region. If your compliance requirements mean AI processing has to stay in the EU, this one's for you.

EU hosted models.png

@ mentions in notebooks

You can now mention integrations and projects directly in text blocks. Type @ in a paragraph, list, or callout and a picker opens — with typeahead, so you can find the right resource fast.

mentions.gif
  • Project chips link straight to that project.
  • If a mentioned resource gets removed, its chip shows in red.
  • Every chip carries the resource ID, so AI agents know unambiguously which integration or project you're referring to.

Trash folder

When you accidentally delete a project, you no longer have to reach out to support. Just restore it from Trash.

Trash folder.pngmentions.gif

API & MCP updates

  • Duplicate notebooks programmatically — a new POST /notebooks/{notebookId}/duplicate endpoint in the v2 API, with a matching duplicate_notebook MCP tool.
  • Link generation for agents — a new generate_project_url MCP tool lets agents generate URLs for Deepnote projects and notebooks, so they can hand you a link to what they've built.

MCP tools & controls, Git directory sync, pivot tables, & more

MCP tools & controls, Git directory sync, pivot tables, & more.png

MCP updates: better controls and more tools

New MCP tools for integrations

MCP-connected agents can now manage integrations end-to-end with three new tools: create_integration, attach_integration, and detach_integration. An agent can now create an integration and wire it into a project without a human step in between.

Better MCP controls for workspace admins

You can now see every MCP OAuth grant issued for your workspace and revoke any of them from Settings > Security > MCP OAuth connections.

MCP OAuth connections.png

A new workspace setting on the same page turns external MCP client access on or off for the whole workspace.

MCP access.png

New block type: pivot tables

You can now summarize and cross-tabulate data with a dedicated pivot table block. Just drop in rows, columns, values, and an aggregation; no code required. It's a focused first version, and we'll expand it based on how people use it.

Pivot table.png

Git Directory Sync

A new Git integration flow that syncs each notebook to its own .deepnote file, so a project's notebooks show up as separate files in your repo instead of being bundled into a single multi-notebook .deepnote file. Existing projects on the old bundled format get a built-in migration path. More improvements are on the way.

Watch this walkthrough for a quick look at how the migration and sync work.

Collapsible sections in notebooks

Headings in notebooks are now collapsible, so you can fold away the parts you're not working on and move through a long notebook far more easily.

collapsible-sections.gif

Better agent context

The AI agent now has access to our documentation, so questions about setup, configuration, and product behavior come back grounded in the actual docs.

Better agent context.png

Pick your AI model

The AI model selector in your settings now offers more fine-grained selection of the latest publicly available models from OpenAI or Anthropic. You can also try Anthropic’s latest Sonnet 5 in Deepnote!

AI model picker.png

SQL blocks in R environments

SQL blocks now work in R-based environments (Deepnote iR with libs). Query any Deepnote integration from a SQL block, and results land in an R dataframe, the R equivalent of the pandas dataframe you'd get in a Python notebook. Downstream blocks (including DataFrame SQL) can consume it from there.

BigQuery OAuth in the VS Code extension

The Deepnote VS Code extension (v1.5.0) now supports OAuth-based BigQuery integrations, so each user signs in with their own Google account instead of sharing a service account. Short-lived tokens, MFA, and least-privilege access apply automatically.

Because the OAuth flow is proxied through Deepnote, the same integration config and redirect URLs work in both places: if you already use BigQuery OAuth in Deepnote Cloud, the integration carries over.

Install the latest version from the VS Marketplace or Open VSX.

Setup details in the docs.

Deepnote is now in OpenAI Codex

Deepnote is now in Codex.png

Codex now connects natively to your Deepnote workspace. The context your team has already built — notebooks, scheduled analyses, data apps, and integrations — is available to Codex directly, so any exploration starts from your real work.

Watch this demo, where we connect Codex to a live workspace and run a fraud detection project end to end — summarizing projects, serving a model, auto-running the card-cancellation workflow, and writing a new analysis back into Deepnote.

Codex connects via the Deepnote MCP and operates within your existing permissions: it can search for projects, read and run notebooks, write new ones, and inspect integrations.

Here's what that unlocks:

Your workspace as the context for every exploration

Most real questions cross team boundaries. Codex can now search and read across every project in your workspace, pulling from the marketing, sales, and product notebooks to compose a single answer across all three — built on how your team already defines and measures things.

01 _ Full workspace context.webp

Turn a Codex exploration into a published Deepnote app

An exploration doesn't have to end as a chat thread. Because Codex can write back to Deepnote, you can share its work as a notebook or a published app your team can open, rerun, and extend.

02 _ Exploration _ published Deepnote app.webp

Build and refine real workflows

Codex can interact with individual blocks in your notebooks, so you build persistent, production-ready workflows instead of one-off queries — adding features to a model, tuning thresholds, or dropping in monitoring over a few targeted prompts.

03 _alt_ _ Request in Codex_ built in Deepnote.webp

Connect Deepnote to Codex

  1. Open Codex
  2. Select Plugins and find Deepnote
  3. Click Enabled in Codex, then Connect
  4. Follow the OAuth flow and select a workspace

Deepnote is live in the Codex data analytics plugin today. The Deepnote MCP and public API behind this connection open up a lot more opportunities — more on that soon!

Run snapshots, Git sync, & AI usage visibility

Run snapshots.png

TL;DR

  • Run snapshots - every notebook run now saves an immutable record of blocks, outputs, and execution metadata, so you can jump back to any past run in a click.
  • Git sync - connect a Deepnote project to a Git repo and keep them in sync automatically.
  • AI usage visibility - workspace admins can now see every AI action taken, who triggered it, and the tokens it used.

Run snapshots

Every notebook run now automatically saves an immutable snapshot — a frozen record of all blocks, outputs, and execution metadata from the moment the run finished. Open any past run from the Runs sidebar, your project logs, or the Logs & Analytics modal.

Scheduled notebook broke overnight? A teammate's run produced an unexpected number? Want to see what a chart looked like last Tuesday? Until now, you'd re-run and hope. Now you've got the full historical record one click away, so debugging, auditing, and reviewing someone else's work just gets easier.

run-snapshots-sidebar 1.png

Full details in the docs.

Git sync

You can now connect a Deepnote project to a Git repo and keep them in sync automatically. That means you can:

  • Edit locally: take a project from Deepnote Cloud to your machine, work on it, and push changes back.
  • Put notebooks in your Git flow: pull requests, code review, proper history.
  • Actually review notebook diffs: the .deepnote format is human-readable, so changes are finally reviewable.
git-sync.png

Full details in the docs.

AI usage visibility

Workspace admins can now see a full breakdown of AI activity in the AI settings page:

  • Every AI action taken in the workspace.
  • Which user triggered it, and from which notebook.
  • Token usage per request, including cached tokens.
Screenshot 2026-02-24 at 16.09.43.png

Polars support, PDF export & a cleaner notebook

Polars support.png

TL;DR

  • Polars support - Polars DataFrames are first-class citizens in data tables and charts.
  • Export.ipynbor.deepnotefiles to PDF - turn any notebook into a PDF in a click, straight from the notebook menu.
  • A cleaner notebook & workspace - better table of contents, nested bullets in text blocks, tidier project sidebar, friendlier empty state, and simpler folder defaults.

Polars support

Deepnote now treats Polars DataFrames as first-class citizens:

  • They render in the interactive data table, with the same filtering and sorting you already get with pandas.
  • They work in charts, including server-side aggregation for large datasets.

SQL blocks still return pandas DataFrames for now. If you'd like that to be configurable, let us know.

CleanShot 2026-03-24 at 13.23.48.png

Export your.ipynbor.deepnotefile to PDF

You can now export any notebook, whether it’s as a .ipynb or a native .deepnote file, straight to PDF. Just pick **Export as →**choose PDF with code or PDF without code.

You'll find the full set of export options in the same place: .deepnote, PDF, .ipynb, and Project as.zip, in the project topbar menu and in the left sidebar.

export 1.png

Full details in the docs.

Cleaner notebook & workspace

  • Better table of contents

The table of contents now behaves the same way in notebooks and apps, and it lives on the notebook itself instead of being tucked into the left sidebar. Small change, but the inconsistency had been bugging us for a while.

better summary structure.png
  • Nested bullet points

You no longer need a markdown block to create nested bullet lists. Just hit Tab to indent and Shift + Tab to outdent, right in a text block.

  • A simpler project sidebar

We removed the separate Terminals section from the project sidebar. Terminals are still there when you need them, just without the dedicated sidebar slot.

How many KitKats to run your AI?

measure ai usage.webp

Last week, 12T of KitKat products disappeared somewhere between Italy and Poland. Following a thorough internal investigation, we have reason to believe our Deepnote Agent was responsible.

In its defense, AI is an energy-intensive process, and 413,793 KitKat bars amount to fewer than one bar per Deepnote user.

To take full accountability, your AI usage in Deepnote is now measured and visible to your workspace admins. Both in KitKat bars, and USD ($).

To view the usage, head to Settings → AI.

settings.webp

You’ll find a new subsection detailing feature usage, models called (remember, you can always bring your own custom model if you’re on our enterprise tiers), and how much the run costs you. Alongside these, you’ll find the new metric: KitKats consumed. The conversion is based on actual energy-per-token estimates for each model, mapped to the caloric content of a standard 4-finger KitKat bar (210 kcal, or 878,640 joules).

kitkat.webp

A single Deepnote Agent session burns roughly 1/50th of a KitKat. Across 500,000 users, it adds up. A more detailed breakdown:

EnergyKitKat equivalent
1 KitKat bar912 kJ1.0
1 simple AI query~1 kJ~0.001
1 agent session (20K tokens)~20 kJ~0.02
1 heavy agent session (100K tokens)~100 kJ~0.11

For folks who care about the dollar equivalent, we offer a separate measure:

kitkat2.webp

On another note, we believe that AI energy consumption deserves more visibility, and that the best unit of measurement is one everyone understands. It’s a KitKat.

Take a break and review your org’s AI usage in your workspace’s AI settings.

Interoperability with more notebook formats

Interoperability with more notebook formats.png

Convert more file formats to Deepnote projects and vice versa

The Deepnote convert CLI previously supported bi-directional conversion between Deepnote projects and Jupyter notebooks. Based on popular demand, we shipped bidirectional, lossless notebook conversions between Deepnote, Jupyter, Quarto, Percent, and Marimo.

We’ve also included a smarter CLI with automatic format detection and a new -- format flag to make the work more seamless. This helps increase interoperability across projects and reduce lock-in, in the true spirit of open-source!

Convert-any-supported-format-to-Deepnote.png

That means you can move work both ways:

  • Bring your previous projects back into Deepnote without losing momentum, and enjoy the extended functionality Deepnote offers!
  • Convert a Deepnote project into any of the above notebook formats when you need to share, archive, or run elsewhere
Convert-Deepnote-to-any-supported-format.png

You can now also export projects and notebooks directly from the VS Code extension.

Deepnote extension updates.png

We will continue working on .deepnote format portability to better integrate it with the ecosystem - let us know if you have any suggestions!

Git upgrades & GitLab support

Git upgrades.png

Git integration updates

On our Git integration front, we’ve reworked the three core actions: pull, commit, and push. Everything got a more polished UI, plus a set of improvements that make day-to-day collaboration smoother.

Support for merge conflict resolution

Previously, pull only supported fast-forward updates, which meant it worked only when branches weren’t divergent. Now you can pull even when branches diverge, and if Git can’t resolve conflicts automatically, Deepnote will show a conflict resolution modal where you can keep either your local changes or the incoming changes.

git_updates_deepnote.png

Pull with stash

No need to commit local changes just to pull anymore, even if they touch files updated on the remote. Deepnote can pull with stash, and if conflicts occur (between your local-only commits and remote, or between the stash and remote), you can resolve them in the same conflict resolution flow.

Commit and push

The commit and push modal got a big refresh:

  • Preview your changes in a clean diff editor
  • Exclude files from the commit
  • Switch to a new branch directly from the modal
  • Get prompted to open a PR after a successful push

We’ve also included a set of smaller improvements, including a clearer branch selector (with more intuitive new-branch creation) and a one-click shortcut to open your repository on GitHub directly from the integration menu.

Commit_push.png

GitLab support in Git integration

GitLab is now fully supported in Deepnote’s Git integration in the Files section - not just for exports.

You can now:

  • Connect GitLab repositories to folders
  • Pull changes from the remote
  • Commit and push local changes
  • Switch between branches

One key difference compared to GitHub: for GitLab, Deepnote performs Git actions on your behalf, whereas GitHub uses Deepnote’s GitHub App. As a result, the setup flow is slightly different. Full instructions are available in the new GitLab integration documentation.

Footer

Solutions

  • Python notebook
  • SQL notebook
  • R notebook
  • Data apps
  • Machine learning
  • Data teams

Product

Company

Comparisons

Resources

Tools

Footer

  • Privacy
  • Terms

© 2026 Deepnote. All rights reserved.