marimo-team/marimo-batch

O que marimo-batch faz?

Uma skill opinativa para preparar um notebook marimo para execução agendada.

Esta skill aplica transformações automatizadas em notebooks Marimo, removendo células interativas, configurando parâmetros externos e garantindo que o notebook possa ser executado sem supervisão humana. Ideal para pipelines de dados e jobs agendados.

Funcionalidades

• Converte células interativas do Marimo em células executáveis
• Define variáveis de ambiente ou argumentos de linha de comando para parâmetros
• Remove células de UI e marcação desnecessárias
• Preserva células de código essenciais e a ordem de execução
• Gera um script .py otimizado para execução batch

Como usar

A skill é acionada pelo agente (ex.: Claude Code, Cursor) ao receber um notebook Marimo (arquivo .py) e instruções para prepará-lo para execução agendada.

Exemplo de uso

# Comando para acionar a skill
prepare-marimo-batch notebook.py

Pré-requisitos

• Notebook Marimo salvo como arquivo .py (formato padrão do Marimo)
• Conexão com internet (para instalação de dependências, se necessário)

Como funciona

1. O agente lê o arquivo .py do notebook Marimo
2. Analisa a estrutura do notebook, identificando células de código, UI e marcação
3. Remove células que não são relevantes para execução batch (ex.: mo.ui.slider, mo.md sem conteúdo crítico)
4. Adiciona ou modifica células para aceitar parâmetros via sys.argv ou variáveis de ambiente
5. Reordena e limpa o código para garantir execução linear
6. Salva o notebook modificado como um novo arquivo .py (ou sobrescreve, conforme configurado)

Parâmetros de configuração

• --input-file: Caminho para o notebook Marimo original (obrigatório)
• --output-file: Caminho para o notebook processado (opcional; padrão: {input}_batch.py)
• --env-prefix: Prefixo para variáveis de ambiente a serem injetadas (opcional; padrão: MARIMO_)

Limitações

• Não suporta notebooks com múltiplos kernels ou células síncronas complexas
• Pode remover células interativas que são essenciais para a lógica de negócio se não forem explicitamente marcadas
• Requer que o notebook Marimo seja exportado no formato .py padrão (não HTML ou ipynb)

Licença

MIT