Skip to content

Commit fe922dc

Browse files
committed
docs: update readme and assets
1 parent 4e1645d commit fe922dc

File tree

3 files changed

+31
-47
lines changed

3 files changed

+31
-47
lines changed

README.md

Lines changed: 31 additions & 47 deletions
Original file line numberDiff line numberDiff line change
@@ -1,45 +1,33 @@
1-
![Deepnote VS Code cover image](deepnote-vscode-cover-image.png)
1+
<div align="center">
2+
3+
![Deepnote Toolkit cover image](./assets/deepnote-vscode-cover-image.png)
24

35
[![CI](https://github.com/deepnote/vscode-deepnote/actions/workflows/ci.yml/badge.svg?branch=main)](https://github.com/deepnote/vscode-deepnote/actions/workflows/ci.yml)
46
[![codecov](https://codecov.io/gh/deepnote/vscode-deepnote/graph/badge.svg?token=NH066XG7JC)](https://codecov.io/gh/deepnote/vscode-deepnote)
5-
[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
67
[![VS Code Marketplace](https://img.shields.io/badge/VS%20Code-Marketplace-blue)](https://marketplace.visualstudio.com/items?itemName=Deepnote.vscode-deepnote)
78

8-
A powerful [Visual Studio Code](https://marketplace.visualstudio.com/items?itemName=Deepnote.vscode-deepnote), [Cursor](https://open-vsx.org/extension/Deepnote/vscode-deepnote) and [Windsurf](https://open-vsx.org/extension/Deepnote/vscode-deepnote) extension that brings [Deepnote](https://deepnote.com/) notebook capabilities directly into your favorite editor. Work with sleek AI notebooks featuring SQL blocks, database integrations, and reactive blocks - all within VS Code.
9-
10-
---
11-
12-
![Deepnote Projects](./images/deepnote-projects.png)
9+
[Website](https://deepnote.com/?utm_source=github&utm_medium=github&utm_campaign=github&utm_content=readme_main)[Docs](https://deepnote.com/docs?utm_source=github&utm_medium=github&utm_campaign=github&utm_content=readme_main)[Changelog](https://deepnote.com/changelog?utm_source=github&utm_medium=github&utm_campaign=github&utm_content=readme_main)[Examples](https://deepnote.com/explore?utm_source=github&utm_medium=github&utm_campaign=github&utm_content=readme_main)[Community](https://github.com/deepnote/deepnote/discussions)[X](https://x.com/DeepnoteHQ)
1310

14-
---
15-
16-
# 🚀 Deepnote in VS Code, Cursor and Windsurf - data notebook for AI era
17-
18-
Run Deepnote locally inside VS Code, Cursor and Windsurf — not Jupyter — and unlock the next generation of data workflows:
19-
20-
- 🧠 **SQL in VS Code** — Run SQL queries out of the box, no extensions needed
21-
- 🧩 **Rich block types** — Combine Python, Markdown, data visualizations, tables, and more — all in one place
22-
- 🔐 **Native database connections** — Securely connect to Snowflake, BigQuery, Postgres, and 60+ other sources via VS Code’s encrypted SecretStorage API
23-
- ⚙️ **Init notebooks** — Auto-run setup code (dependencies, env setup) before execution
24-
- 📦 **Smart requirements** — Generate `requirements.txt` automatically for reproducible runs
11+
</div>
2512

26-
🐍 **Jupyter kernel, upgraded**
13+
# Deepnote in VS Code, Cursor and Windsurf
2714

28-
-**Deepnote kernel** — Fully `.ipynb-compatible`, tuned for modern data workflows
29-
- 🔁 **Kernel control** — Restart, interrupt, and switch seamlessly
15+
A powerful [Visual Studio Code](https://marketplace.visualstudio.com/items?itemName=Deepnote.vscode-deepnote), [Cursor](https://open-vsx.org/extension/Deepnote/vscode-deepnote) and [Windsurf](https://open-vsx.org/extension/Deepnote/vscode-deepnote) extension that brings [Deepnote](https://deepnote.com/) notebook capabilities directly into your favorite editor. Work with sleek AI notebooks featuring SQL blocks, database integrations, and reactive blocks - all within VS Code.
3016

31-
🌐 **Deepnote ecosystem integrations**
17+
![Deepnote Projects](./assets/deepnote-projects.png)
3218

33-
- 🔃 **Auto-refresh** — Instantly detects file and data changes
34-
- 🧮 **Multi-notebook support** — Work across multiple notebooks in one unified project
35-
-**Cloud collaboration** — Switch between local VS Code and Deepnote Cloud to collaborate live on the same file with your team
3619

37-
## 📋 Requirements
20+
Run Deepnote locally inside your IDE and unlock the next generation of data workflows:
3821

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

42-
## 🎯 Getting started
30+
## Getting started
4331

4432
1. Open the extensions tab and Search for Deepnote
4533
2. Or alternatively, press `Cmd+P` or `Ctrl+P` to open the command palette.
@@ -48,6 +36,11 @@ Run Deepnote locally inside VS Code, Cursor and Windsurf — not Jupyter — and
4836

4937
Or install from the [VS Code Marketplace](https://marketplace.visualstudio.com/items?itemName=Deepnote.vscode-deepnote)
5038

39+
### Requirements
40+
41+
- **Visual Studio Code** 1.95.0 or higher
42+
- **Python** 3.10 or higher (for running notebooks)
43+
5144
### Opening your first Deepnote notebook
5245

5346
1. Open a folder containing `.deepnote` project files
@@ -56,7 +49,7 @@ Or install from the [VS Code Marketplace](https://marketplace.visualstudio.com/i
5649
4. Select a Python kernel when prompted
5750
5. Start coding!
5851

59-
## 📖 Usage
52+
## Usage
6053

6154
### Command palette
6255

@@ -96,27 +89,18 @@ SELECT * FROM users WHERE created_at > '2024-01-01'
9689

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

99-
## 🛠️ Quick start for developers
100-
101-
Want to contribute? Check out our [Contributing Guide](CONTRIBUTING.md) for detailed setup instructions.
92+
## Quick start for developers
10293

103-
- Setting up your development environment
104-
- Running tests
105-
- Building the extension
106-
- Submitting pull requests
94+
Want to contribute? Check out our [Contributing guide](CONTRIBUTING.md) for detailed setup instructions.
10795

108-
## 📚 Documentation
96+
## Documentation
10997

11098
- **[Architecture](architecture.md)** - Technical architecture and design decisions
111-
- **[Deepnote Kernel Implementation](DEEPNOTE_KERNEL_IMPLEMENTATION.md)** - Details on the custom Jupyter kernel
112-
- **[Integrations & Credentials](INTEGRATIONS_CREDENTIALS.md)** - How database integrations work
113-
- **[Contributing Guide](CONTRIBUTING.md)** - How to contribute to the project
114-
115-
## 📄 License
116-
117-
This project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.
99+
- **[Deepnote kernel implementation](DEEPNOTE_KERNEL_IMPLEMENTATION.md)** - Details on the custom Jupyter kernel
100+
- **[Integrations & credentials](INTEGRATIONS_CREDENTIALS.md)** - How database integrations work
101+
- **[Contributing guide](CONTRIBUTING.md)** - How to contribute to the project
118102

119-
## 🐛 Issues & support
103+
## Issues & support
120104

121105
- **Bug reports**: [GitHub issues](https://github.com/deepnote/vscode-deepnote/issues)
122106
- **Feature requests**: [GitHub discussions](https://github.com/deepnote/deepnote/discussions)
@@ -126,6 +110,6 @@ This project is licensed under the MIT License - see the [LICENSE](LICENSE) file
126110

127111
<div align="center">
128112

129-
**Built with 💙 by the Deepnote team**
113+
Built with 💙 by the data driven team
130114

131115
</div>
File renamed without changes.
1.45 MB
Loading

0 commit comments

Comments
 (0)