https://github.com/deepnote/deepnote
Deepnote is a drop-in replacement for Jupyter with an AI-first design, sleek UI, new blocks, and native data integrations. Use Python, R, and SQL locally in your favorite IDE, then scale to Deepnote cloud for real-time collaboration, Deepnote agent, and deployable data apps. https://deepnote.com/
https://github.com/deepnote/deepnote
artificial-intelligence data data-analysis data-science data-visualization deepnote eda jupyter jupyterhub jupyterlab machine-learning notebooks python r sql
Last synced: 15 days ago
JSON representation
Deepnote is a drop-in replacement for Jupyter with an AI-first design, sleek UI, new blocks, and native data integrations. Use Python, R, and SQL locally in your favorite IDE, then scale to Deepnote cloud for real-time collaboration, Deepnote agent, and deployable data apps. https://deepnote.com/
- Host: GitHub
- URL: https://github.com/deepnote/deepnote
- Owner: deepnote
- License: apache-2.0
- Created: 2025-09-29T15:24:25.000Z (2 months ago)
- Default Branch: main
- Last Pushed: 2025-11-10T18:44:21.000Z (23 days ago)
- Last Synced: 2025-11-10T20:31:12.977Z (23 days ago)
- Topics: artificial-intelligence, data, data-analysis, data-science, data-visualization, deepnote, eda, jupyter, jupyterhub, jupyterlab, machine-learning, notebooks, python, r, sql
- Language: TypeScript
- Homepage: https://deepnote.com/?utm_source=github&utm_medium=github&utm_campaign=github&utm_content=readme_main
- Size: 16.1 MB
- Stars: 1,734
- Watchers: 9
- Forks: 102
- Open Issues: 11
-
Metadata Files:
- Readme: README.md
- Contributing: CONTRIBUTING.md
- License: LICENSE
- Codeowners: .github/CODEOWNERS
- Security: SECURITY.md
- Support: docs/support.md
Awesome Lists containing this project
- awesome-data-analysis - Deepnote - AI native data science notebook platform compatible with Jupyter, featuring real-time collaboration, environment management, and integrations. (⚡ Productivity / Resources)
README
[](https://github.com/deepnote/deepnote/actions/workflows/ci.yml)
[](https://codecov.io/gh/deepnote/deepnote)
[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) • [X](https://x.com/DeepnoteHQ) • [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)
# Deepnote is a data notebook for the AI era
Deepnote is used by 500,000+ data professionals at companies like Estée Lauder, SoundCloud, Statsig, Gusto, and beyond.
Get started with Deepnote in seconds:
```bash
npx @deepnote/convert notebook.ipynb # This will convert the notebook and create notebook.deepnote
```
Then open your `.deepnote` file in [VS Code](https://marketplace.visualstudio.com/items?itemName=Deepnote.vscode-deepnote), [Cursor](https://open-vsx.org/extension/Deepnote/vscode-deepnote), [Windsurf](https://open-vsx.org/extension/Deepnote/vscode-deepnote), or [JupyterLab](https://pypi.org/project/jupyterlab-deepnote/)!
## What is Deepnote?
Deepnote is a successor of Jupyter. It uses the Deepnote kernel which is more powerful but still backwards compatible so you can seamlessly move between both, but adds an AI agent, sleek UI, new block types, and native data integrations. **Deepnote Open Source** offers you everything you'd need to work locally before you scale your workflows in a team with **Deepnote Cloud**.
Why Deepnote Open Source?
- **Human-readable format:** The `.deepnote` YAML format replaces `.ipynb`'s messy JSON with clean, version-control and human-friendly structure for projects and notebooks. You can organize multiple notebooks, integrations, and settings into a single `.deepnote` project for better structure and collaboration.
- **Block-based architecture:** Extend notebooks beyond code cells with blocks for SQL, inputs, charts, and much more — all defined and validated through the open `@deepnote/blocks` package.
- **Work wherever:** Run notebooks locally in VS Code, JupyterLab, or anywhere else with the open-source Deepnote Toolkit. Once you want to work in a team on the same notebook with beefier compute - drag and drop your project into Deepnote Cloud.
- **Reactive notebook execution:** Automatically re-runs dependent blocks when inputs or data change, ensuring notebooks stay consistent and reproducible without manual execution.
- **Open and extendable:** Built on the Jupyter kernel for full compatibility with your existing notebooks.
- **Effortless conversion:** Convert .ipynb notebooks into .deepnote projects and back again using the open `@deepnote/convert` CLI and API.
## What can you do right now?
This open-source repository lets you, edit and run Deepnote notebooks directly in your favorite AI-native code editors:
- **[VS Code extension](https://marketplace.visualstudio.com/items?itemName=Deepnote.vscode-deepnote)** - Full Deepnote support in Visual Studio Code
- **[Cursor extension](https://open-vsx.org/extension/Deepnote/vscode-deepnote)** - AI-powered notebook editing in Cursor
- **[Windsurf extension](https://open-vsx.org/extension/Deepnote/vscode-deepnote)** - Collaborative development in Windsurf
- **[JupyterLab extension](https://pypi.org/project/jupyterlab-deepnote/)** - Read `.deepnote` files in JupyterLab with backwards compatibility
## Roadmap
You'll soon be able to:
- Take the UI you're used to from **Deepnote Cloud** and run it locally
- Edit notebooks with a local AI agent
- Bring your own keys for AI services
- Run your own compute
## Deepnote vs. Jupyter
Deepnote extends Jupyter in a number of ways. Here are the key differences:
| Feature | Deepnote | Jupyter |
| ------------------- | ------------------------------------------ | --------------------------- |
| **Setup** | Zero setup via cloud or local installation | Local installation required |
| **AI features** | Native AI agent and AI code completion | Third-party extensions |
| **Version control** | Built-in Git integration | Manual Git workflow |
| **Sharing** | Share with a link | Export files manually |
| **Compute** | Managed cloud compute | Local resources only |
| **Integrations** | Native database & API connections | Manual configuration |
## What's inside this repository
Reusable packages and libraries powering Deepnote's notebook, runtime, and collaboration features.
**[@deepnote/blocks](./packages/blocks)** TypeScript types and utilities for working with Deepnote notebook blocks.
- **Block type definitions**: Code, SQL, Text, Markdown, Input, Visualization, Button, Big Number, Image, Separator
- **Python code generation**: Convert blocks to executable Python code
- **Markdown conversion**: Convert text blocks to/from markdown format
- **Input block support**: Text, textarea, checkbox, select, slider, file, date, and date-range inputs
**[@deepnote/convert](./packages/convert)** CLI tool and library to convert Jupyter notebooks (`.ipynb`) to Deepnote format (`.deepnote`).
- **CLI tool**: `deepnote-convert` command for batch conversions
- **Programmatic API**: Use in Node.js/TypeScript applications
- **Directory support**: Convert entire folders of notebooks
- **Custom projects**: Set metadata during conversion
## Deepnote for academia
Deepnote Cloud is **free for students and educators**! Get unlimited access to all core features, cloud compute, and real-time collaboration for your research and teaching.
If you use Deepnote in your research, please cite Deepnote using:
```latex
@misc{deepnote,
title = {Deepnote: the data notebook for the AI era},
author = {Deepnote Team},
year = {2025},
url = {https://github.com/deepnote/deepnote},
note = {Open-source collaborative data science notebook platform}
}
```
**Learn more:** [deepnote.com/education](https://deepnote.com/education?utm_source=github&utm_medium=github&utm_campaign=github&utm_content=readme_main)
## Need help?
- Join our [Community](https://github.com/deepnote/deepnote/discussions)!
- [Open an issue](https://github.com/deepnote/deepnote/issues/new) for bug reports or feature requests
- Check out source code of related repositories: [Deepnote VS Code extension](https://github.com/deepnote/vscode-deepnote), [Deepnote JupyterLab extension](https://github.com/deepnote/jupyterlab-deepnote) and [Deepnote Toolkit](https://github.com/deepnote/deepnote-toolkit).
- Check out our [documentation](https://deepnote.com/docs?utm_source=github&utm_medium=github&utm_campaign=github&utm_content=readme_main)
- Want a low-code experience? Visit [Deepnote Cloud](https://deepnote.com/?utm_source=github&utm_medium=github&utm_campaign=github&utm_content=readme_main) together with Deepnote AI agent
## Contributing
We love external contributors! Whether you're fixing bugs, adding features, or improving documentation, your contributions are welcome, please see [CONTRIBUTING.md](CONTRIBUTING.md), or join [our team](https://deepnote.com/join-us)
## Acknowledgements
We owe a huge thank-you to the Jupyter community and everyone who has contributed to open notebooks over the past decade. Jupyter set the standard for how the world explores data and shares ideas through code when it launched in 2013. Deepnote builds directly on that legacy — and extends it into the AI-native, collaborative future. None of this would exist without the foundations Jupyter created, and we’re proud to keep contributing back to the same open ecosystem.
---
Built with 💙