uv: gerenciador de pacotes Python

uv é um gerenciador de pacotes e projetos Python da Astral (mesma do Ruff). Escrito em Rust, substitui pyenv + pip + venv + poetry numa ferramenta só.

Instalação

# macOS
brew install uv

# Linux/macOS (script)
curl -LsSf https://astral.sh/uv/install.sh | sh

# Windows
winget install astral-sh.uv
# Ou: irm https://astral.sh/uv/install.ps1 | iex

Se instalar via script, adicionar ao PATH:

# Fish
fish_add_path ~/.local/bin

# Bash/Zsh
export PATH="${HOME}/.local/bin:$PATH"

Comandos essenciais

# Novo projeto
uv init meu-projeto && cd meu-projeto

# Dependências
uv add requests
uv add pytest --dev

# Sincronizar ambiente
uv sync

# Executar no venv (sem ativar)
uv run python script.py
uv run pytest

# Gerenciar versões Python
uv python install 3.12
uv python list

CLIs globais (substitui pipx)

uv tool install ruff

Migração

# De requirements.txt
uv init
uv add -r requirements.txt

# De poetry - uv lê pyproject.toml direto
uv sync

Compatibilidade pip

# Quando precisar de comandos pip tradicionais
uv pip install pacote
uv pip freeze

Links

• Documentação
• GitHub