Ir para o conteúdo

Preparação de um ambiente de desenvolvimento Python (2026)

TLDR

Atualização da postagem sobre Preparação de um ambiente de desenvolvimento Python através do uso de ferramentas mais modernas como o uv e marimo.

Como a ideia agora é criar postagens mais curtas e tutoriais, vamos direto ao ponto. Iremos criar um ambiente com as seguintes ferramentas:

  • linux: ambiente mais próximo de ambientes de produção;
  • uv: gerencia ambientes virtuais, diferentes versões do Python e dependências de tais ambientes;
  • git: sistema colaborativo e descentralizado de controle de versões.
  • marimo: um alternativa moderna aos jupyter notebooks.

Como a postagem antiga já dá suporte aos passos: Instalar o WSL e o Ubuntu e Configurar o git. Essa postagem irá cobrir:

  • Instalar o uv;
  • Instalar o marimo;

Instalar o uv

Antes de instalar o uv, você precisa instalar o WSL e o Ubuntu. Já com o linux instalado, basta utilizar o seguinte comando para instalar o uv usando o curl ou o wget:

1
curl -LsSf https://astral.sh/uv/install.sh | sh

1
wget -qO- https://astral.sh/uv/install.sh | sh

Você também pode instalar utilizando o pip. Com estes comandos você instala o uv e o uvx. Essas duas ferramentas tem funcões diferentes de acordo com o contexto.

  • uv é o executável principal para tarefas específicas do projeto, como gerenciar ambientes virtuais (venv), instalar dependências (pip) e executar código dentro do contexto do projeto.
  • uvx é um alias de conveniência para executar a ferramenta uv. Ele é usado para executar ferramentas de linha de comando independentes em ambientes isolados e temporários, sem instalá-las no seu projeto atual. Iremos utilizar mais trarde para executar o marimo sem a necessidade de instalá-lo no projeto.

Depois de instalar, é interessante aplicar o recurso de autocompletar. Para isso, utilize:

1
echo 'eval "$(uv generate-shell-completion bash)"' >> ~/.bashrc

1
echo 'eval "$(uv generate-shell-completion zsh)"' >> ~/.zshrc

Para ativar o recurso de autocompletar do shell para uvx, execute um dos seguintes comandos:

1
echo 'eval "$(uvx --generate-shell-completion bash)"' >> ~/.bashrc

1
echo 'eval "$(uvx --generate-shell-completion zsh)"' >> ~/.zshrc

Antes de seguir para o próximo passo, vamos aprender a configurar o git no post anterior. Depois de configurar, volte aqui para instalar o marimo.

Instalar o marimo

Irei criar um post específico sobre o marimo e suas características, então por hora, o que você precisa saber é que o marimo é um ambiente de notebook reativo de código aberto que resolve muitas das limitações dos notebooks tradicionais, como o Jupyter, garantindo que o código, as saídas e o estado do programa sejam sempre consistentes.

Na verdade, você não precisa "instalar o marimo" para conseguir utilizar, você pode utilizá-lo, junto com o uv, de duas maneiras diferentes: (1) como uma ferramenta independente ou (2) dentro de um projeto1.

Utilizando o Marimo como uma ferramenta independente

Aqui você não precisa instalar o marimo, apenas iniciar um servidor a qualquer momento em um ambiente isolado com:

1
uvx marimo edit

ou ainda, iniciando em um notebook específico:

1
uvx marimo edit meu_notebook.py

Utilizando o Marimo em um projeto

Se você estiver trabalhando em um projeto, pode iniciar um notebook marimo com acesso ao ambiente virtual do projeto através do seguinte comando:

1
uv run marimo edit my_notebook.py
Para usar o comando acima o marimo precisa ser dependência do projeto. Como usamos uv, precisamos antes adicionar o marimo as dependências usando:

1
uv add marimo

Usar dessa forma permite que as dependências instaladas pela interface de instalação de pacotes integrada do marimo sejam adicionadas ao pyproject.toml e consequentemente ao uv.lock e o .venv/.

Pronto, agora você tem um ambiente atualizado para desenvolvimento e/ou ciência de dados para o ano de 2026. Nos próximos posts eu começo a falar sobre as funcionalidades do marimo e as suas comparações com notebooks atuais, como o Jupyter. Até mais.

  1. Existem outras formas, você pode encontrar na documentação oficial do uv, mas aqui abordaremos somente estas. ↩

Se você notar erros ou enganos nesta publicação, não hesite em me contatar pelo e-mail madsonddias@gmail.com e terei o maior prazer em corrigi-los imediatamente!