Learn

Tutorials

Learn by building real apps, one step at a time. Start by drawing a window without code, then add Python, data, shaders, games, a backend, and ship it.

Every tutorial ends with a program you can run, and its full source is in the examples folder of the repository. Each one says what you will build, how long it takes, what you need to know first and what you will learn.

flowchart LR
    B["Basic<br/>draw a window · a form · layout · themes · Python basics"] --> I["Intermediate<br/>data binding · pages · tables · dialogs · components · threads · shaders"]
    I --> A["Advanced<br/>editor · games · shader graphs · backends · packaging · AI agent"]

Basic

From an empty canvas to your first apps, with the designer and in code.

Start hereYour first window in Pyzed DesignDrag controls, set their properties, anchor them and run with F5. No code.A form that does somethingA contact form: inputs, a Send button wired to Python, a live counter and the console.Layout basicsRows, columns, fill, spacing and grids, in code and with the designer's flex containers.Change the themeBundled themes, accent colors, light/dark from the system and your own theme.5-step tutorialFrom an empty window to a notes app with Markdown, async work and a second window, in pure Python.To-do listYour first complete app in code: state, a form, a list, filters and shortcuts.

Intermediate

Real data, several screens and your own reusable pieces.

DesignerData binding and validationBind controls to form.data and add rules in the designer; validate in one line.A multi-view appA sidebar that switches pages, tabs, breadcrumbs and shortcuts.Lists and tables with dataSearch, sort, select a row and show its details.Dialogs, notifications and validationField errors, a confirmation dialog and toasts that go away on their own.DesignerA custom componentDraw a reusable star rating with properties, bindings and a custom event.Background tasksDownloads with progress, blocking work in a thread and notifications.GPUA shader effect from the Shader viewA glowing GPU background made of nodes, behind a form whose buttons change it.

Advanced

Whole applications, games and shipping them.

A mini code editorA workspace with a file tree, tabs, syntax highlighting and a command palette.GameA game loopDodge: a frame loop, held keys, collisions, glow, particles and screen shake.GameMake games: the learning pathEight game tutorials, from your first loop to a platformer, Asteroids, 2048, menus and saves.GPUA custom shader graphAn aurora built node by node in Python, with sliders for its variables.Connecting a backendA repository class over SQLite, queries in threads, a spinner and friendly errors.Package your appA double-clickable app for Windows, macOS and Linux, and builds for all three from CI.AIBuild an app with the AI agentDescribe an app, follow the agent's plan, review its changes and keep improving it.

Running the examples

Clone the repository (or download it as a zip) and run any example from its folder with the tool you use. uv creates the environment for you; with pip, create and activate a virtual environment first. Every tutorial has a block like this one with its own file:

uv run --with pyzed-ui python examples/todo.py

python3 -m venv .venv
source .venv/bin/activate
python -m pip install pyzed-ui
python examples/todo.py

py -m venv .venv
.venv\Scripts\Activate.ps1
python -m pip install pyzed-ui
python examples\todo.py

python3 examples/todo.py

py examples\todo.py

Forms made with the designer (.pzform) run with pyzed run instead of python:

uv run --with pyzed-ui pyzed run examples/tutorial/designer/hello.pzform

python3 -m venv .venv
source .venv/bin/activate
python -m pip install pyzed-ui
pyzed run examples/tutorial/designer/hello.pzform

py -m venv .venv
.venv\Scripts\Activate.ps1
python -m pip install pyzed-ui
pyzed run examples\tutorial\designer\hello.pzform

python3 -m pyzed run examples/tutorial/designer/hello.pzform

py -m pyzed run examples\tutorial\designer\hello.pzform