Configurar Python 3.13 e uv no Windows

Basic python

Configurar Python 3.13 e uv no Windows

Objetivos #

  • Instalar o Python 3.13 no Windows 11 / 10
  • Criar e gerenciar um ambiente virtual com uv e venv
  • Conhecer os problemas frequentes e como resolvê-los

Pré-requisitos #

ItemDetalhes
PermissõesConta padrão é suficiente (liberamos scripts temporariamente com Set-ExecutionPolicy)
ShellWindows PowerShell (busque por “PowerShell” no menu Iniciar)
Pasta de trabalhoUsaremos C:\projects\my-app como exemplo (mude se quiser)

1. Instalar Python 3.13 #

  1. Baixe o Windows installer (64-bit) da página oficial

  2. Rode o instalador e marque “Add python.exe to PATH”, depois clique em Install Now

  3. Confirme a versão no PowerShell

    py -3.13 --version
    

    Se aparecer Python 3.13.x, tudo certo. Caso py não seja reconhecido, feche e abra o PowerShell.

💡 Também dá para usar winget install Python.Python.3.13, mas confira o PATH.

2. Instalar o uv #

uv é um gerenciador de pacotes rápido. Execute:

Set-ExecutionPolicy -Scope Process Bypass
iwr https://astral.sh/uv/install.ps1 -UseBasicParsing | iex
uv --version

Se o número da versão aparecer, deu certo. Caso contrário, reabra o PowerShell ou cheque se $Env:USERPROFILE\.local\bin está no PATH.

3. Criar a pasta do projeto e o ambiente virtual #

mkdir C:\projects\my-app
cd C:\projects\my-app
uv venv --python 3.13 .venv

O ambiente ficará na pasta .venv. Ative-o com:

.\.venv\Scripts\Activate.ps1

Quando o prompt mostrar (.venv), o ambiente está ativo. Use deactivate para sair.

✁ENão quer ativar? Use uv run python script.py que o ambiente é aplicado automaticamente.

4. Gerenciar bibliotecas #

uv pip install numpy pandas
uv pip list
uv pip sync requirements.txt
  • uv pip install: adiciona pacotes
  • uv pip list: lista o que está instalado
  • uv pip sync: replica o conteúdo de requirements.txt

5. Configurar o Visual Studio Code (opcional) #

  1. Abra o VS Code e selecione o interpretador Python na barra inferior
  2. Aponte para .venv\Scripts\python.exe para ter autocomplete e debugging dentro do ambiente
  3. Instale extensões como “Python”, “Pylance” e “Black Formatter” para facilitar o fluxo

6. Problemas comuns #

ProblemaSolução
Set-ExecutionPolicy negadoVerifique permissões ou abra o PowerShell como administrador
uv não encontradoAbra um novo PowerShell / adicione $Env:USERPROFILE\.local\bin ao PATH
Não consigo apagar .venvFeche VS Code ou outros apps que estejam usando a pasta e tente novamente

7. Limpeza #

  • Sair do ambiente: deactivate
  • Remover o ambiente: exclua a pasta .venv
  • Registrar pacotes: uv pip freeze > requirements.txt

Com Python 3.13 + uv prontos no Windows, siga para a próxima lição e mergulhe nos fundamentos da linguagem.