Tesserae Engine
A GPU-rendered retained-mode UI engine for Python, written in Rust.
Tesserae Engine (imported as tre) gives Python the building blocks of a desktop UI — nodes, flexbox
and grid layout, paint, animation, input and events, text, accessibility, layers,
and threading — and renders them on the GPU, redrawing only what changed, with
vello_gpu, laid out by
taffy, shaped by
parley, and exposed to screen
readers through AccessKit.
It has no widgets and no theme of its own. A UI library or application built on it turns the blocks into buttons, dialogs, and design systems.
from tre import App, Window
window = Window(width=320, height=120, title="Hello")
button = window.create("box", width=120, height=40, corner_radius=20,
fill=(0x67, 0x50, 0xA4, 0xFF), role="button",
label="Say hello", focusable=True)
button.on("click", lambda: print("hello"))
window.root.add_child(button)
app = App()
app.add_window(window)
app.run()
Installing
pip install tesserae-engine
On PyPI it's tesserae-engine (the name tre there is another
project's); you still import tre. Wheels cover CPython 3.12+ on Linux
(x86_64), macOS (arm64), and Windows (x64); other platforms build from
source. See
Installation for the
details.
Documentation
The guide, API reference, and migration notes are at
mindderivative.github.io/tre, and
their source is in docs/,
built with MkDocs:
pip install mkdocs mkdocs-material
mkdocs serve # http://127.0.0.1:8000
Start with Getting Started, then the guide's page for each building block; Building a Widget puts them together. Upgrading from 0.4.x? See Upgrading to 0.5.x; from 0.3.5, Upgrading to 0.4.x; from 0.3.4, Migrating to 0.3.5.
Building from source
python -m venv .venv
source .venv/bin/activate # .venv\Scripts\activate on Windows
pip install maturin
maturin develop --release -m crates/engine-py/Cargo.toml
python examples/switch.py
Each script in examples/ is a small, runnable demonstration
of one building block.
Development
cargo test --workspace --release
cargo clippy --workspace --all-targets --release -- -D warnings
cargo fmt --all --check
pytest tests/
mkdocs build --strict
mypy --strict python/tre
python -m mypy.stubtest tre --allowlist tools/stubtest_allowlist.txt
cargo +1.90 check --workspace --all-targets # MSRV
Every rendering capability has a headless, GPU-backed pixel test under
crates/engine-render/tests/, and the Python suite drives input and time
headlessly through window.simulate and window.advance.
ARCHITECTURE.md is the design reference, and
the GitHub project Tesserae Rendering Engine tracks the work from 0.5.0 on; the 0.4.x line is in
BUILD_TRACKER_ARCHIVE_0.4.md, and the
milestone-by-milestone history through v0.3.5.2 is in
BUILD_TRACKER_ARCHIVE_0.3.md.
Tesserae Engine is a from-scratch second iteration of an earlier Vulkan engine,
archived under archive/ with its lessons learned.
1 maintainer
Metadata
1 maintainer
Release files for tesserae-engine 0.5.2
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | |
|---|---|---|---|
| tesserae_engine-0.5.2.tar.gz | 2.4 MB | Details |
Built distributions (wheels)
Total release size: 116.6 MB
Release files / tesserae_engine-0.5.2.tar.gz
| Download URL | tesserae_engine-0.5.2.tar.gz |
|---|---|
| Size | 2.4 MB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
efa703f839472d3d8cf434cdf90aacbb8b6c038caf953b7fbbae7be888f9bfb0
|
|
BLAKE2b-256 checksum How to use checksums |
d88fe98206a0627d0f6db7f814739ef4d4c0d8498e9d44c67c4fd5f31c487860
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.14
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Oct 3, 2026.
Transparency logRelease files / tesserae_engine-0.5.2-cp315-cp315t-manylinux_2_17_x86_64.manylinux2014_x86_64.whl
| Download URL | tesserae_engine-0.5.2-cp315-cp315t-manylinux_2_17_x86_64.manylinux2014_x86_64.whl |
|---|---|
| Size | 11.8 MB |
| Tags | CPython 3.15 CPython 3.15 free-threading Linux glibc 2.17+ x86-64 |
|
SHA-256 checksum How to use checksums |
127fea4bc5a9d731cac6b8154fdb017419d3d0a1b0bf993dca0844cbacd8d14a
|
|
BLAKE2b-256 checksum How to use checksums |
7603b8b80459e3513ce4d3e71b18e7079519f7c4fcd2754933256f651a0685a4
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.14
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Oct 3, 2026.
Transparency logRelease files / tesserae_engine-0.5.2-cp315-cp315-manylinux_2_17_x86_64.manylinux2014_x86_64.whl
| Download URL | tesserae_engine-0.5.2-cp315-cp315-manylinux_2_17_x86_64.manylinux2014_x86_64.whl |
|---|---|
| Size | 11.8 MB |
| Tags | CPython 3.15 Linux glibc 2.17+ x86-64 |
|
SHA-256 checksum How to use checksums |
f64d4424930c9782a4c09c59eed968eb4e0277a37e8bc9a2bc8c4fe320a43fe7
|
|
BLAKE2b-256 checksum How to use checksums |
1fba07516eb997cb4973176ef6a47a2a3b1ae584df5c6dbbbcb57b994671485b
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.14
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Oct 3, 2026.
Transparency logRelease files / tesserae_engine-0.5.2-cp314-cp314t-manylinux_2_17_x86_64.manylinux2014_x86_64.whl
| Download URL | tesserae_engine-0.5.2-cp314-cp314t-manylinux_2_17_x86_64.manylinux2014_x86_64.whl |
|---|---|
| Size | 11.8 MB |
| Tags | CPython 3.14 CPython 3.14 free-threading Linux glibc 2.17+ x86-64 |
|
SHA-256 checksum How to use checksums |
a2b242fe31bf029811688e4c51e091e1b2abf107af9f458470ca2a5a84b37e37
|
|
BLAKE2b-256 checksum How to use checksums |
8c64bcac74a8c7549e4b7fed72c678f6648c45fdcb18026b1cece3bb7abf0c95
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.14
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Oct 3, 2026.
Transparency logRelease files / tesserae_engine-0.5.2-cp314-cp314-win_amd64.whl
| Download URL | tesserae_engine-0.5.2-cp314-cp314-win_amd64.whl |
|---|---|
| Size | 7.5 MB |
| Tags | CPython 3.14 Windows x86-64 |
|
SHA-256 checksum How to use checksums |
83dd9ec40dbe3633b36e38fc23f52a751622e189c320051b61bf873b685851f0
|
|
BLAKE2b-256 checksum How to use checksums |
1d8ecd82d9f80ca027f421045bfc194727ad4895df1a8eb873ed3082f2983e15
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.14
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Oct 3, 2026.
Transparency logRelease files / tesserae_engine-0.5.2-cp314-cp314-manylinux_2_17_x86_64.manylinux2014_x86_64.whl
| Download URL | tesserae_engine-0.5.2-cp314-cp314-manylinux_2_17_x86_64.manylinux2014_x86_64.whl |
|---|---|
| Size | 11.8 MB |
| Tags | CPython 3.14 Linux glibc 2.17+ x86-64 |
|
SHA-256 checksum How to use checksums |
f0d15e7fd42e8e91683c38195ae7366399abd426a4f3aef372ceb62e46f17295
|
|
BLAKE2b-256 checksum How to use checksums |
5ebb8485bd37f961ec99be01596f852a85afedbf76f26a3944f2c3ba0d5c63c0
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.14
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Oct 3, 2026.
Transparency logRelease files / tesserae_engine-0.5.2-cp314-cp314-macosx_11_0_arm64.whl
| Download URL | tesserae_engine-0.5.2-cp314-cp314-macosx_11_0_arm64.whl |
|---|---|
| Size | 7.0 MB |
| Tags | CPython 3.14 macOS 11.0+ ARM64 |
|
SHA-256 checksum How to use checksums |
0fb4005abc91326050121bc467afa39cc1809df38252e5ff25240cb46e2d3972
|
|
BLAKE2b-256 checksum How to use checksums |
c3acfa50b09a4205b80c4b15649f0f05a7f86ddb7f27d09983fdda6e440f739d
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.14
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Oct 3, 2026.
Transparency logRelease files / tesserae_engine-0.5.2-cp313-cp313-win_amd64.whl
| Download URL | tesserae_engine-0.5.2-cp313-cp313-win_amd64.whl |
|---|---|
| Size | 7.5 MB |
| Tags | CPython 3.13 Windows x86-64 |
|
SHA-256 checksum How to use checksums |
f3aa468549b4b443b6310ec6ff4dca32f86a81ca6382caef7a6326ea2bc555fa
|
|
BLAKE2b-256 checksum How to use checksums |
01340a8b32bdff685e38b281d273296dfe3b71a348906a41121b5add54dc72cd
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.14
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Oct 3, 2026.
Transparency logRelease files / tesserae_engine-0.5.2-cp313-cp313-manylinux_2_17_x86_64.manylinux2014_x86_64.whl
| Download URL | tesserae_engine-0.5.2-cp313-cp313-manylinux_2_17_x86_64.manylinux2014_x86_64.whl |
|---|---|
| Size | 11.8 MB |
| Tags | CPython 3.13 Linux glibc 2.17+ x86-64 |
|
SHA-256 checksum How to use checksums |
d3eed7f319cb001e35345b9e04eb0ed12ef7c48d38c8b1cdb37706ac30f301df
|
|
BLAKE2b-256 checksum How to use checksums |
72c501132cb993a72274e3409852ec641d411b53232ed04365121b7d3d4515b5
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.14
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Oct 3, 2026.
Transparency logRelease files / tesserae_engine-0.5.2-cp313-cp313-macosx_11_0_arm64.whl
| Download URL | tesserae_engine-0.5.2-cp313-cp313-macosx_11_0_arm64.whl |
|---|---|
| Size | 7.0 MB |
| Tags | CPython 3.13 macOS 11.0+ ARM64 |
|
SHA-256 checksum How to use checksums |
35e581d709ca53a00b2ad9b7321315b73746d5702b5732c96e92b342e8f70cd4
|
|
BLAKE2b-256 checksum How to use checksums |
b8bd0bcc8ecc2dcdbc54ce4bee55ba8dcd49a25152e957c86e27ff2da5cfb710
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.14
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Oct 3, 2026.
Transparency logRelease files / tesserae_engine-0.5.2-cp312-cp312-win_amd64.whl
| Download URL | tesserae_engine-0.5.2-cp312-cp312-win_amd64.whl |
|---|---|
| Size | 7.5 MB |
| Tags | CPython 3.12 Windows x86-64 |
|
SHA-256 checksum How to use checksums |
f304c94d52d0e1cdb3bae933bc4f576d34789e876db47800932a56d3f9bc2f86
|
|
BLAKE2b-256 checksum How to use checksums |
c3ca46c09403b6f1a0c87e9b5f5ddb14153cc06a8da19795f27aa982d3d63ed6
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.14
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Oct 3, 2026.
Transparency logRelease files / tesserae_engine-0.5.2-cp312-cp312-manylinux_2_17_x86_64.manylinux2014_x86_64.whl
| Download URL | tesserae_engine-0.5.2-cp312-cp312-manylinux_2_17_x86_64.manylinux2014_x86_64.whl |
|---|---|
| Size | 11.8 MB |
| Tags | CPython 3.12 Linux glibc 2.17+ x86-64 |
|
SHA-256 checksum How to use checksums |
e5569f93266aec5520810daae5d6e2f41d1709851e537c8bc9e3b84bb929dcda
|
|
BLAKE2b-256 checksum How to use checksums |
ed9c823d545b7e49a6512e77c6b6f42d6b520e2e78381d4ff27236cb89fcfcc1
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.14
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Oct 3, 2026.
Transparency logRelease files / tesserae_engine-0.5.2-cp312-cp312-macosx_11_0_arm64.whl
| Download URL | tesserae_engine-0.5.2-cp312-cp312-macosx_11_0_arm64.whl |
|---|---|
| Size | 7.0 MB |
| Tags | CPython 3.12 macOS 11.0+ ARM64 |
|
SHA-256 checksum How to use checksums |
efff04fd9620c9899093873a0a16c1b1df0a32b04f16f7d15426fed8aece8be2
|
|
BLAKE2b-256 checksum How to use checksums |
7de78a503efff02172427c5d5e19461fb7509da0110b9a585cddad017289485c
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.14
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Oct 3, 2026.
Transparency log
