Python uv inicio rápido: crea tu primer proyecto

Esta guía toma la ruta más corta para tener un proyecto Python funcional con uv.

Requisitos previos

uv --version

Si aparece versión, todo ok.

uv init my-app
cd my-app

uv crea automáticamente pyproject.toml, .python-version, main.py y README.md.

uv run main.py

Deberías ver Hello from my-app!.

uv add requests

Edita main.py:

import requests
r = requests.get("https://httpbin.org/get")
print(r.status_code)

Ejecuta:

uv run main.py

Si ves 200, la dependencia quedó instalada correctamente.

Síntoma	Revisar
`uv: command not found`	PATH no actualizado; reinicia terminal o `source ...`
`Permission denied`	Permisos en ruta de instalación (`~/.local/bin`)
Instalación lenta	Primera vez descarga más; luego usa caché

Entiende qué hacen pyproject.toml y uv.lock: 👉 Core Concepts