Pedro's dev blog

Instalando e Usando o uv

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

Instalando e Usando o uv

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

Escrito em Rust, o uv é extremamente rápido e unifica instalação de versões do Python, criação de ambientes virtuais e gerenciamento de dependências em uma única ferramenta.

1. Instale o uv

# Linux / macOS
curl -LsSf https://astral.sh/uv/install.sh | sh
 
# Windows (PowerShell)
powershell -c "irm https://astral.sh/uv/install.ps1 | iex"

Confirme:

uv --version

2. Inicie um projeto

uv init meu-projeto
cd meu-projeto

Isso cria pyproject.toml, .python-version e a estrutura inicial.

3. Adicione dependências

uv add requests fastapi
uv add --dev pytest ruff

Cada uv add atualiza o pyproject.toml, gera o uv.lock e cria/atualiza o .venv automaticamente.

4. Execute o código

uv run python script.py

O uv run garante que o ambiente está sincronizado com o lockfile antes de executar — sem precisar ativar nada manualmente.

5. Gerencie versões do Python

uv python install 3.12
uv python pin 3.12

Ele baixa e gerencia a versão do Python quando necessário, substituindo o pyenv.

O que o uv substitui

  • pyenv / asdf → uv python install
  • python -m venv / virtualenv → ambiente criado automaticamente
  • pip → uv add / uv pip
  • pipx → uvx <ferramenta>

Quando usar

É a melhor opção moderna para qualquer projeto novo. Se o projeto já usa Poetry, a migração é tranquila; se depende de binários científicos pesados, o Conda ainda pode fazer mais sentido.

Notas relacionadas

ConnectionsFull graph →