marimo

marimo é um revolucionário notebook Python de código aberto que reinventa a computação interativa para a era moderna da ciência de dados e inteligência artificial. Ao contrário dos notebooks tradicionais que armazenam conteúdo em arquivos JSON propensos a erros, os notebooks marimo são scripts Python puros (arquivos .py). Essa escolha fundamental de design os torna reprodutíveis, amigáveis ao Git, testáveis e reutilizáveis como módulos Python padrão. marimo introduz um modelo de execução reativo, onde a atualização de uma única célula aciona automaticamente a execução de todas as células dependentes, eliminando o estado oculto e a tarefa manual tediosa de reexecutar o código para garantir a consistência. Isso cria um ambiente de desenvolvimento fluido, intuitivo e resistente a erros.

Desenvolvido por uma equipe com vasta experiência do Google, Palantir e do ecossistema PyData, o marimo foi construído para preencher a lacuna entre a prototipagem experimental e as aplicações prontas para produção. Ele capacita desenvolvedores e cientistas de dados a construir aplicações web complexas e interativas diretamente de seus notebooks, sem escrever nenhum código de frontend. Esses notebooks podem ser compartilhados sem problemas como arquivos HTML interativos alimentados por WebAssembly ou implantados como aplicativos web robustos usando a interface de linha de comando do marimo.

Como usar marimo

Começar a usar o marimo é simples e projetado para uma experiência de desenvolvedor tranquila. Primeiro, instale-o usando o pip:

$ pip install marimo

Uma vez instalado, você pode iniciar o tutorial introdutório para se familiarizar com seu paradigma reativo:

$ marimo tutorial intro

Para criar ou editar um notebook, basta executar o comando marimo com um arquivo Python:

$ marimo edit my_notebook.py

Dentro do editor baseado na web, você pode escrever código Python em células, assim como em outros notebooks. No entanto, o poder do marimo reside em seus recursos especiais. Você pode vincular elementos de UI como sliders e dropdowns diretamente a variáveis Python. Quando um usuário interage com um widget, a variável correspondente é atualizada e todas as células a jusante que usam essa variável são reexecutadas reativamente. Você também pode escrever consultas SQL diretamente em células SQL dedicadas para interagir com bancos de dados como DuckDB, SQLite, Postgres e outros. Para compartilhar seu trabalho, você pode executá-lo como um aplicativo somente leitura ou exportá-lo para um arquivo HTML autocontido:

# Executar como um aplicativo interativo
$ marimo run my_notebook.py

# Exportar para HTML
$ marimo export my_notebook.py --to html

O assistente de IA integrado pode ser usado para gerar código, explicar conceitos e depurar problemas, suportando modelos da OpenAI, Anthropic, Google Gemini e modelos locais via Ollama.

Recursos principais do marimo

• Execução Reativa: Código e saídas permanecem perfeitamente sincronizados. A modificação de uma célula atualiza automaticamente todas as células dependentes, eliminando o estado oculto e garantindo a reprodutibilidade.
• Formato Amigável ao Git: Os notebooks são salvos como arquivos Python padrão (.py), não como JSON complexo. Isso resulta em diffs limpos e legíveis, tornando o controle de versão com o Git perfeito.
• Editor Nativo de IA: Possui assistência de IA integrada, incluindo autocompletar no estilo GitHub Copilot, chat ciente do contexto e edições em linha. Suporta os principais modelos de IA para acelerar o desenvolvimento.
• Células SQL Integradas: Consulte bancos de dados e dataframes nativamente usando SQL. Os resultados podem ser transformados e visualizados sem problemas usando todo o poder do Python.
• Elementos de UI Interativos: Crie UIs interativas com um rico conjunto de widgets como sliders, dropdowns e GUIs de dataframe interativas sem precisar de nenhuma experiência em frontend.
• Implantação Contínua: Transite sem esforço de um notebook protótipo para uma ferramenta de nível de produção. Implante notebooks como aplicativos web somente leitura, execute-os como scripts Python em pipelines ou exporte-os como arquivos HTML autocontidos.
• Ambientes Reprodutíveis: o marimo pode serializar os requisitos de pacotes dentro do arquivo do notebook e criar automaticamente ambientes virtuais efêmeros, garantindo que os notebooks sejam executados de forma consistente em qualquer lugar.
• Experiência Rica para Desenvolvedores: O editor inclui recursos modernos como atalhos de teclado do vim, formatação de código, painéis de depuração, atalhos extensivos e uma extensão para o VS Code.

Casos de uso para marimo

A versatilidade do marimo o torna adequado para uma ampla gama de aplicações em diferentes domínios:

• Desenvolvimento de IA e Machine Learning: Prototipar e testar rapidamente modelos de IA. Construir interfaces interativas para LLMs, como chatbots e ferramentas de UI generativas. Criar painéis personalizados de rotulagem de dados e avaliação para ajustar e comparar modelos.
• Exploração e Visualização de Dados: Explore conjuntos de dados interativamente usando gráficos reativos e GUIs de dataframe. As seleções feitas em um gráfico podem atualizar automaticamente as análises e visualizações a jusante, criando um fluxo de trabalho dinâmico e exploratório.
• Pesquisa Científica e Educação: Comunique os resultados da pesquisa por meio de aplicações tangíveis e interativas. Desenvolva materiais educacionais envolventes que permitam aos alunos experimentar conceitos em tempo real, como simular processos físicos ou explorar funções matemáticas.
• Ferramentas Internas e Dashboards: Construa e mantenha ferramentas internas como calculadoras financeiras, painéis de comparação de modelos de PNL ou interfaces de rotulagem de dados usando apenas Python. Isso elimina a complexidade de gerenciar serviços de frontend e backend separados.

Vantagens do marimo

O marimo oferece vantagens significativas sobre ambientes de notebook tradicionais como o Jupyter:

• Reprodutibilidade por Design: O gráfico de fluxo de dados acíclico e reativo garante que os notebooks sejam executados em uma ordem determinística, evitando os problemas comuns de "execução fora de ordem" que assolam outros sistemas.
• Controle de Versão Simplificado: Ao usar um formato Python puro, o marimo resolve o pesadelo de resolver conflitos de mesclagem em arquivos JSON de notebook, permitindo a verdadeira colaboração via Git.
• Do Notebook ao App, Instantaneamente: o marimo unifica o processo de desenvolvimento e implantação. O que você constrói no notebook é o aplicativo, reduzindo drasticamente o tempo e o esforço necessários para compartilhar seu trabalho.
• Cadeia de Ferramentas Moderna e Integrada: Combina o melhor das práticas de desenvolvimento modernas, incluindo assistência de IA integrada, suporte de primeira classe a SQL e componentes interativos poderosos, tudo dentro de um único ambiente coeso.
• Código Aberto e Impulsionado pela Comunidade: Como uma ferramenta gratuita e de código aberto com uma comunidade vibrante no GitHub e no Discord, o marimo está em constante evolução com contribuições e feedback de seus usuários.

Preços e planos

O marimo é fundamentalmente um projeto gratuito e de código aberto. A biblioteca principal do notebook marimo e sua interface de linha de comando estão disponíveis para qualquer pessoa usar sem custo. Você pode instalá-lo e executá-lo em sua máquina local ou em seus próprios servidores. Além disso, o projeto oferece o molab, uma plataforma baseada em nuvem para executar e compartilhar notebooks marimo, que também está atualmente disponível gratuitamente. Isso posiciona o marimo como uma ferramenta altamente acessível para indivíduos, estudantes e equipes profissionais.