Crear un proyecto

Pyzed instala el comando pyzed. Crea un proyecto completo con uv, una herramienta que instala paquetes de Python y mantiene cada proyecto en su propio entorno (las pestañas pip y python instalan uv por ti):

uvx --from pyzed-ui pyzed new mi-app     # uvx ejecuta pyzed sin instalarlo
cd mi-app
uv run pyzed design     # abre el form principal en el diseñador visual
uv run pyzed run        # ejecuta la app

pip install pyzed-ui uv     # con tu .venv activado
pyzed new mi-app
cd mi-app
source .venv/bin/activate           # el .venv propio del proyecto
pyzed design         # abre el form principal en el diseñador visual
pyzed run            # ejecuta la app

pip install pyzed-ui uv     # con tu .venv activado
pyzed new mi-app
cd mi-app
.venv\Scripts\Activate.ps1           # el .venv propio del proyecto
pyzed design         # abre el form principal en el diseñador visual
pyzed run            # ejecuta la app

python3 -m pip install pyzed-ui uv
python3 -m pyzed new mi-app
cd mi-app
.venv/bin/python -m pyzed design     # abre el form principal en el diseñador visual
.venv/bin/python -m pyzed run        # ejecuta la app

py -m pip install pyzed-ui uv
py -m pyzed new mi-app
cd mi-app
.venv\Scripts\python -m pyzed design     # abre el form principal en el diseñador visual
.venv\Scripts\python -m pyzed run        # ejecuta la app

Esto genera un proyecto de uv estándar:

mi-app/
├── pyproject.toml     # dependencias (pyzed-ui; ruff y ty para desarrollo) + [tool.pyzed]
├── uv.lock
├── .venv/
├── .git/
├── src/mi_app/        # backend
└── ui/                # forms (.pzform) y sus handlers de eventos (.py)

La carpeta de UI separa la interfaz del resto del código, y sus handlers pueden importar el backend, cualquier módulo del proyecto y todas las dependencias. ¿Ya tienes un proyecto creado con uv init? Ejecuta pyzed init dentro. Consulta Proyectos con uv para la estructura, los comandos de dependencias y la pestaña Project del diseñador, y Compilar y distribuir para empaquetar la app en cada plataforma.

Una app de un solo archivo

Para empezar desde código en lugar del diseñador, --script crea un único main.py sin uv:

uvx --from pyzed-ui pyzed new mi-app --script
cd mi-app
uv run --with pyzed-ui main.py

pyzed new mi-app --script     # con tu .venv activado
cd mi-app
python main.py

python3 -m pyzed new mi-app --script
cd mi-app
python3 main.py

py -m pyzed new mi-app --script
cd mi-app
py main.py

La plantilla ya incluye:

Un ui.workspace con barra de título, panel izquierdo y barra de estado.
Navegación entre páginas con ui.list_item.
Una paleta de comandos que se abre con Ctrl+Shift+P y se cierra con Esc.
Un botón para alternar entre tema claro y oscuro.

Buscar iconos

Pyzed incluye los ~2000 iconos de Lucide. Para buscar nombres:

uv run pyzed icons folder
# folder, folder-open, folder-git, folder-plus, ...

pyzed icons folder
# folder, folder-open, folder-git, folder-plus, ...

python3 -m pyzed icons folder
# folder, folder-open, folder-git, folder-plus, ...

py -m pyzed icons folder
# folder, folder-open, folder-git, folder-plus, ...

Úsalos con pz.icon("folder") o con el parámetro icon= de los componentes.

Ejecutar como módulo

python -m pyzed es equivalente al comando pyzed:

uv run python -m pyzed new otra-app

python -m pyzed new otra-app

python3 -m pyzed new otra-app

py -m pyzed new otra-app