Configurar uv no macOS

Objetivos #

• Instalar Python 3.13 e uv no macOS Ventura / Sonoma
• Criar ambientes virtuais e atualizar bibliotecas por conta própria
• Integrar o setup com editores como o VS Code

Pré-requisitos #

1. Instale o Python 3.13 #

brew update
brew install python@3.13
brew link python@3.13
python3.13 --version

Se aparecer Python 3.13.x, deu certo. Caso outro link esteja ativo, execute brew unlink python@3.x.

2. Instale o uv #

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

Depois confira:

uv --version

Se o comando não existir, inclua ~/.local/bin no PATH:

echo 'export PATH="$HOME/.local/bin:$PATH"' >> ~/.zshrc
source ~/.zshrc

3. Crie a pasta e o ambiente #

mkdir -p ~/Projects/my-app
cd ~/Projects/my-app
uv venv --python 3.13 .venv
source .venv/bin/activate

Com (.venv) no prompt o ambiente está ativo. Use deactivate para sair.

💡 Preferir sem ativar? Rode uv run python script.py e o uv aplica o ambiente automaticamente.

4. Gerencie as bibliotecas #

uv pip install numpy pandas
uv pip list
uv pip sync requirements.txt

• uv pip install: adiciona pacotes
• uv pip list: mostra o que está instalado
• uv pip sync: replica requirements.txt

5. Integração com VS Code #

1. VS Code → Command Palette (⇧⌘P) → Python: Select Interpreter
2. Escolha .venv/bin/python para amarrar autocomplete e debug ao ambiente
3. Recomendamos extensões “Python”, “Pylance”, “Black Formatter”, “Flake8 / Ruff”

6. Problemas frequentes #

7. Limpeza #

• Sair: deactivate
• Apagar o ambiente: rm -rf .venv
• Salvar dependências: uv pip freeze > requirements.txt

Pronto, o macOS está preparado com Python 3.13 + uv. Siga para a próxima lição e mergulhe nos fundamentos da linguagem.