Pyzed

Interfaces modernas y rápidas en Python, renderizadas por Iced (Rust). Incluye componentes listos para usar inspirados en el editor Zed.

📖 Documentación: albakore.github.io/pyzed · Novedades

Esta captura es una app de Python (examples/zed_editor.py): panel de proyecto, pestañas, editor con resaltado de sintaxis, marcadores de git, barra de estado, paleta de comandos y temas. Todo se dibuja con Iced.

Por qué Pyzed

• Rendimiento nativo. Python solo describe la interfaz. El layout, el texto y el dibujado (wgpu, con tiny-skia como respaldo por software) los hace Iced 0.14 en Rust, mediante PyO3.
• Sencillo. Sigue la arquitectura Elm de Iced (estado, update y view). Un botón puede llamar directamente a un método: on_press=self.guardar.
• Componentes listos. Unos 40 componentes al estilo Zed (botones, pestañas, árbol de archivos, paleta de comandos, editor de código, terminal, menús, notificaciones…), todos personalizables.
• Temas. Incluye las familias One, Ayu y Gruvbox importadas de Zed, puede leer cualquier tema de Zed, generar uno a partir de tres colores y seguir el modo claro/oscuro del sistema.
• Async y varias ventanas. async def, generadores y streams en update, temporizadores con pz.every y tantas ventanas como quieras con pz.Window.
• Multiplataforma. Linux, macOS y Windows. Las fuentes (IBM Plex) y los iconos (Lucide, ~2000) van incluidos.
• Capturas sin ventana. app.screenshot("ui.png") renderiza fuera de pantalla, sin GPU ni display. Sirve para tests y documentación (así se generaron todas estas imágenes).

Instalación

Por ahora se instala desde el código fuente. Necesitas Rust estable y Python 3.9 o superior.

pip install git+https://github.com/albakore/pyzed

Para desarrollar:

git clone https://github.com/albakore/pyzed && cd pyzed
python -m venv .venv && source .venv/bin/activate
pip install maturin
maturin develop --release   # usa --release: la build debug es mucho más lenta

Inicio rápido

import pyzed as pz
from pyzed import ui


class Counter(pz.App):
    title = "Counter"
    size = (360, 220)

    def __init__(self):
        self.count = 0

    def update(self, message):          # los mensajes pueden ser cualquier valor de Python
        if message == "increment":
            self.count += 1
        elif message == "decrement":
            self.count -= 1

    def view(self):
        return pz.center(
            pz.column([
                ui.heading(str(self.count)),
                pz.row([
                    ui.button("-1", "decrement", icon="minus"),
                    ui.button("+1", "increment", icon="plus", variant="solid"),
                    # ...o un callable, que se llama directamente
                    ui.icon_button("rotate-ccw", lambda: setattr(self, "count", 0), tooltip="Reset"),
                ], spacing=8),
            ], spacing=16, align="center"),
            bg=self.theme.editor,
        )


pz.run(Counter)

Crear un proyecto nuevo

pyzed new mi-app      # crea mi-app/main.py con barra de título, sidebar, estado y paleta de comandos
cd mi-app && python main.py
pyzed icons folder    # busca nombres de iconos

Conceptos

Widgets base (pyzed)

text, column, row, container, center, button, text_input, scrollable, space, hspace, vspace, rule, mouse_area, stack, opaque, hover, tooltip, checkbox, toggler, slider, vertical_slider, progress_bar, code_editor, svg, icon, image e image_viewer (PNG, JPEG… o píxeles RGBA), canvas (dibujo 2D con pyzed.draw), markdown, rich_text + span, qr_code, pick_list, radio, split, grid, pin y responsive. Los contenedores aceptan gradient=(ángulo, [colores]).

Los tamaños aceptan píxeles, "fill", "shrink" o "fill:2" (proporción). El padding acepta 8, (v, h) o (arriba, derecha, abajo, izquierda). Los colores aceptan "#rrggbb[aa]" o tuplas (r, g, b[, a]).

Componentes (pyzed.ui)

Todos leen sus colores del tema actual y aceptan theme= u otros parámetros para cambiarlos.

Temas

class MiApp(pz.App):
    theme = "Ayu Dark"                     # cualquier nombre de pz.themes.names()
    # theme = pz.themes.auto("One Light", "One Dark")   # sigue al sistema

oceano = pz.themes.ONE_DARK.derive(name="Océano", syntax={"keyword": "#ff79c6"}).with_accent("#4fb3ff")
propio = pz.Theme.generate("Propio", background="#1b1d23", text="#e6e6e6", accent="#ff8a65")
de_zed = pz.Theme.from_zed("catppuccin.json", name="Catppuccin Mocha")   # temas de Zed

Cambiar self.theme en update cambia el estilo de toda la interfaz al momento.

One Light + terminal + outline	Paleta de comandos
Buscador de archivos (Gruvbox)	Componentes (One Light)

Ejemplos

Cómo funciona

Python                         Rust (pyzed._core, PyO3)                 Iced 0.14
App.view() ──► árbol de Widget ──► render.rs: Widget → iced::Element ──► layout + wgpu/tiny-skia
App.update() ◄── mensajes ◄────── app.rs: Message, Command → Task ◄──── eventos (ratón, teclado)

• Los nodos Widget son objetos inmutables de Rust, así que construir la vista desde Python es barato.
• El estado interno de cada editor (texto, cursor, deshacer) vive en Rust y se identifica por id.
• El resaltado usa syntect (gramáticas de two-face) con los colores del tema de Pyzed.
• El GIL se libera mientras corre el bucle de eventos, así que otros hilos de Python siguen funcionando.

Estado y limitaciones

Es la versión 0.2. Limitaciones conocidas:

• pz.run() solo puede llamarse una vez por proceso (limitación de winit); usa pz.Window para más ventanas.
• Con wrap=True, el editor numera la primera fila de cada línea ajustada, como Zed.

Licencia

MIT. Las fuentes incluidas son IBM Plex (SIL Open Font License) y Lucide (ISC); sus licencias están en assets/fonts. Los temas One, Ayu y Gruvbox vienen del repositorio de Zed (MIT); ver python/pyzed/zed_themes/LICENSE.