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 --version2. Inicie um projeto
uv init meu-projeto
cd meu-projetoIsso cria pyproject.toml, .python-version e a estrutura inicial.
3. Adicione dependências
uv add requests fastapi
uv add --dev pytest ruffCada 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.pyO 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.12Ele baixa e gerencia a versão do Python quando necessário, substituindo o pyenv.
O que o uv substitui
pyenv/asdf→uv python installpython -m venv/virtualenv→ ambiente criado automaticamentepip→uv add/uv pippipx→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.
