Configurar uv no Ubuntu

Objetivos #

• Instalar Python 3.13 e uv no Ubuntu 22.04 / 24.04 LTS
• Criar, gerenciar e sincronizar ambientes virtuais
• Saber onde os problemas costumam acontecer para resolver rápido

Pré-requisitos #

1. Instalar Python 3.13 #

Como o repositório padrão ainda não traz a 3.13, adicione o PPA deadsnakes:

sudo add-apt-repository ppa:deadsnakes/ppa
sudo apt update
sudo apt install -y python3.13 python3.13-venv python3.13-dev python3.13-distutils
python3.13 --version

Com Python 3.13.x na tela, está tudo ok.

2. Instalar o uv #

curl -LsSf https://astral.sh/uv/install.sh | sh
~/.local/bin/uv --version

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

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

3. Criar pasta e ambiente #

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

O (.venv) no prompt indica que o ambiente está ativo. Use deactivate para sair.

💡 Também dá para rodar uv run python script.py sem ativar manualmente.

4. Adicionar / sincronizar 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. Integrar com VS Code ou outros editores #

• No VS Code instale a extensão “Python”, depois Ctrl+Shift+P → Python: Select Interpreter → .venv/bin/python
• Em vim ou Neovim, abra o editor a partir de um shell com o ambiente ativado

6. Problemas comuns #

7. Limpeza #

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

Ubuntu pronto com Python 3.13 + uv. Agora siga para o próximo capítulo e aprofunde os fundamentos da linguagem.