Pedro's dev blog

Instalando e Usando o Poetry

Published on
Published on
/2 mins read/---

Instalando e Usando o Poetry

Nota prática da série sobre ambientes Python — veja o panorama completo em As 4 Formas de Gerenciar Ambientes Python.

O Poetry trata dependências de forma declarativa e reproduzível, centralizando tudo no pyproject.toml e travando versões no poetry.lock.

1. Instale o Poetry

O instalador oficial mantém o Poetry isolado do seu Python de projeto:

curl -sSL https://install.python-poetry.org | python3 -

Confirme a instalação (talvez seja preciso adicionar ~/.local/bin ao PATH):

poetry --version

2. Crie ou inicialize um projeto

poetry new meu-projeto      # cria a estrutura do zero
# ou, em um projeto existente:
poetry init

3. Adicione dependências

poetry add requests
poetry add --group dev pytest ruff

Cada poetry add atualiza o pyproject.toml e regenera o poetry.lock.

4. Instale e execute

poetry install                    # instala tudo do lockfile
poetry run python script.py       # roda dentro do ambiente
poetry shell                      # abre um shell com o ambiente ativo

5. Reproduza em outra máquina

Basta versionar pyproject.toml e poetry.lock e rodar:

poetry install

Isso garante exatamente as mesmas versões — o fim do clássico "funciona na minha máquina".

Quando usar

Ótimo para bibliotecas publicadas no PyPI e projetos em equipe que exigem reprodutibilidade rigorosa. Se quer algo ainda mais rápido e unificado para projetos novos, considere migrar para uv.

Notas relacionadas

ConnectionsFull graph →