Website • Docs • Changelog • X • Examples • Community

Deepnote in VS Code, Cursor, Windsurf, and Antigravity

A powerful Visual Studio Code, Cursor, Windsurf, and Antigravity extension that brings Deepnote notebook capabilities directly into your favorite editor. Work with sleek AI notebooks featuring SQL blocks, database integrations, and reactive blocks - all within your IDE.

Run Deepnote locally inside your IDE and unlock the next generation of data workflows:

• Rich block types: Combine Python, Markdown, data visualizations, tables, and more — all in one place
• SQL blocks: Run SQL queries out of the box, no extensions needed
• Native database connections: Securely connect to Snowflake, BigQuery, Postgres, and 60+ other sources via VS Code’s encrypted SecretStorage API
• Init notebooks: Auto-run setup code (dependencies, env setup) before execution
• Smart requirements: Generate requirements.txt automatically for reproducible runs
• Deepnote kernel: Fully .ipynb compatible, tuned for modern data workflows
• Cloud collaboration: Switch between local VS Code and Deepnote Cloud to collaborate live on the same file with your team

Getting started

1. Open the extensions tab and Search for Deepnote
2. Or alternatively, press Cmd+P or Ctrl+P to open the command palette.
3. Type ext install Deepnote.vscode-deepnote
4. Press Enter

Or install from the VS Code Marketplace

Requirements

• Visual Studio Code 1.95.0 or higher
• Python 3.10 or higher (for running notebooks)

Opening your first Deepnote notebook

1. Open a folder containing .deepnote project files
2. Look for the Deepnote icon in the Activity Bar (sidebar)
3. Click on a notebook in the Deepnote Explorer to open it
4. Select a Python kernel when prompted
5. Start coding!

Usage

Command palette

Open the Command Palette (Cmd+Shift+P or Ctrl+Shift+P) and type Deepnote to see all available commands:

Database integrations

Configure database connections for SQL blocks:

1. Open Command Palette
2. Run Deepnote: Manage Integrations
3. Add your database credentials (PostgreSQL, BigQuery, etc.)
4. Use SQL blocks in your notebooks with the configured integrations

Credentials are securely stored using VS Code's encrypted storage and never leave your machine.

Working with SQL Blocks

SQL blocks allow you to query databases directly from your notebooks:

-- Query your PostgreSQL database
SELECT * FROM users WHERE created_at > '2024-01-01'

Results are displayed as interactive tables that you can explore and export.

Snapshot mode

Snapshot mode gives you a historical, portable record of all notebook executions without polluting your main project files. This makes it easier to work with Git since outputs are stored separately from your source code.

How it works:

• Execution outputs are saved to a snapshots/ folder alongside your project
• Your main .deepnote file stays clean (no outputs), making diffs readable
• Each "Run All" execution creates a timestamped snapshot for historical tracking
• Running individual cells updates only the latest snapshot

To enable:

1. Open Command Palette (Cmd+Shift+P or Ctrl+Shift+P)
2. Run Deepnote: Enable Snapshots

Once enabled, snapshots are automatically created when you execute notebooks. You can add the snapshots/ folder to .gitignore to keep outputs local, or commit them to share execution history with your team.

Need help?

• Join our Community!
• Open an Issue for bug reports or feature requests
• Have a look at Architecture for technical and design decisions
• Visit Deepnote kernel implementation for the custom Jupyter kernel
• Learn how database integrations work in Integrations & credentials

Contributing

Want to contribute? Check out our Contributing guide for detailed setup instructions.

Third-party licenses

This project includes the following third-party packages with notable licenses:

• tar - Licensed under the Blue Oak Model License 1.0.0

Built with 💙