deepnote

Deepnote é uma plataforma colaborativa de notebooks de ciência de dados projetada para a era da IA. O repositório de código aberto fornece as ferramentas para trabalhar com notebooks Deepnote localmente antes de escalar para o Deepnote Cloud. ## Principais Recursos - **Formato legível por humanos**: Usa arquivos YAML `.deepnote` em vez do `.ipynb` baseado em JSON do Jupyter, tornando o controle de versão e a colaboração mais limpos com diffs focados - **Arquitetura em blocos**: Vai além das células de código com blocos para SQL, entradas (texto, caixa de seleção, slider, arquivo, data), visualizações, botões, números grandes, imagens e texto/markdown - **Execução reativa**: Reexecuta automaticamente blocos dependentes quando entradas ou dados mudam, garantindo consistência sem intervenção manual - **Conversão bidirecional**: Converte entre Deepnote e múltiplos formatos de notebook, incluindo Jupyter (`.ipynb`), Quarto (`.qmd`), Percent (`.py` com `# %%`) e Marimo - **Integração com IDE**: Disponível como extensões para VS Code, Cursor e Windsurf ## Estrutura do Repositório **@deepnote/blocks** — Tipos e utilitários TypeScript para blocos de notebook: - Definições de tipos de bloco: Code, SQL, Text, Markdown, Input, Visualization, Button, Big Number, Image, Separator - Geração de código Python a partir de blocos - Conversão de Markdown para blocos de texto - Suporte a blocos de entrada para vários tipos de widget **@deepnote/convert** — CLI e biblioteca para conversão de formato: - Comando CLI `deepnote-convert` para conversões em lote - API programática para Node.js/TypeScript - Preservação de metadados de plataforma durante conversão de ida e volta do Google Colab, Amazon SageMaker, Kaggle e Azure ML ## Começando ```bash npx @deepnote/convert notebook.ipynb ``` Isso converte um notebook Jupyter existente e cria um arquivo `notebook.deepnote`. Abra o arquivo `.deepnote` no VS Code, Cursor ou Windsurf com a extensão Deepnote. ## Deepnote vs Jupyter | Recurso | Deepnote | Jupyter | |---|---|---| | Configuração | Zero configuração via nuvem ou instalação local | Instalação local necessária | | Recursos de IA | Agente de IA nativo e completação de código | Extensões de terceiros | | Controle de versão | Integração Git incorporada | Fluxo de trabalho Git manual | | Compartilhamento | Compartilhar com um link | Exportar arquivos manualmente | | Computação | Computação em nuvem gerenciada disponível | Apenas recursos locais | | Integrações | Conexões nativas com banco de dados e API | Configuração manual | ## Formatos de Arquivo O repositório documenta os formatos de arquivo `.deepnote` e `.snapshot.deepnote` em FILES.md. Os snapshots separam as saídas do código-fonte para um histórico Git mais limpo, enquanto `contentHash` fornece proveniência de código para verificar qual código produziu cada saída. ## Contribuindo Contribuições são bem-vindas. Consulte CONTRIBUTING.md para diretrizes. Repositórios relacionados incluem a extensão VS Code e o Deepnote Toolkit. ## Citação Se usado em pesquisa: ``` @misc{deepnote, title = {Deepnote: the data notebook for the AI era}, author = {Deepnote Team}, year = {2025}, url = {https://github.com/deepnote/deepnote} } ```