Configura Python 3.13 y uv en Windows

Objetivos de esta página #

Instalar Python 3.13 en Windows 11 / 10
Crear y administrar un entorno virtual con uv y venv
Conocer los problemas habituales y cómo resolverlos

Requisitos previos #

Elemento	Detalles
Permisos	Usuario estándar es suficiente (permitiremos temporalmente scripts con `Set-ExecutionPolicy`)
Shell	Windows PowerShell (búscalo en el menú Inicio)
Carpeta de trabajo	Usaremos `C:\projects\my-app` como ejemplo (puedes cambiarla)

1. Instalar Python 3.13 #

Descarga Windows installer (64-bit) desde la página oficial
Ejecuta el instalador y marca “Add python.exe to PATH” en la primera pantalla → haz clic en Install Now
Verifica la versión en PowerShell
```
py -3.13 --version
```
Si aparece Python 3.13.x, todo está listo. Si py no se reconoce, cierra y vuelve a abrir PowerShell.

💡 También puedes ejecutar winget install Python.Python.3.13, pero revisa el PATH después.

2. Instalar uv #

uv es un gestor de paquetes muy rápido. Ejecuta los siguientes comandos en PowerShell:

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

Si se muestra la versión, la instalación fue exitosa. De lo contrario, reinicia PowerShell o asegúrate de que $Env:USERPROFILE\.local\bin esté en el PATH.

3. Crear la carpeta del proyecto y el entorno virtual #

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

Esto crea la carpeta .venv. Activa el entorno con:

.\.venv\Scripts\Activate.ps1

Cuando veas (.venv) en el prompt, el entorno está activo. Usa deactivate para salir.

✅ También puedes ejecutar comandos sin activarlo: uv run python script.py usa automáticamente el entorno.

4. Gestionar librerías #

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

uv pip install: agrega paquetes
uv pip list: consulta lo instalado
uv pip sync: recrea el entorno a partir de requirements.txt

5. Configurar Visual Studio Code (opcional) #

Abre VS Code y elige el intérprete de Python desde la barra de estado
Selecciona .venv\Scripts\python.exe para aprovechar autocompletado y depuración dentro del entorno
Instala extensiones como “Python”, “Pylance” o “Black Formatter” para un flujo más cómodo

6. Problemas comunes y soluciones #

Problema	Solución
`Set-ExecutionPolicy` es rechazado	Confirma con el administrador o ejecuta PowerShell “como administrador”
El comando `uv` no existe	Reinicia PowerShell / añade `$Env:USERPROFILE\.local\bin` al PATH
No se puede borrar `.venv`	Asegúrate de que VS Code u otras apps no lo estén usando; reinicia y vuelve a intentarlo

7. Limpieza #

Salir del entorno: deactivate
Eliminar el entorno: borra la carpeta .venv
Guardar los paquetes: uv pip freeze > requirements.txt

Listo, ya tienes Python 3.13 + uv funcionando en Windows. Cuando quieras continuar, revisa también las guías de otros sistemas:

Cuando est?s listo, contin?a con la siguiente lecci?n para empezar a aprender Python.

Siguiente paso: Empieza a aprender Python