Yanked

This release has been yanked by its maintainers, and will be ignored by installers, except when explicitly specified.
Consider using release 1.2.1 instead.
Reason given by maintainers: metadata bug

Elysium UI

Python UI without the rectangles.

Status: 1.0 — production / stable. The public API follows strict semver; see the CHANGELOG.

A GPU-accelerated framework for borderless, shaped, animated Python desktop applications. Skia + wgpu hybrid rendering, designer-and- developer split via .esk skin files, animation as a first-class citizen, and a dedicated authoring app (Elysium Designer).

It targets Qt/PySide6 parity for desktop UI while deliberately staying focused on the UI layer — see the scope statement for what's in and what's left to the Python ecosystem.

Documentation

Both sites build from this repo: docs/ and docs-designer/.

Quick start

pip install elysium-ui

Run the minimum borderless ellipse window:

import elysium as ely

ELLIPSE = "M 0,180 A 180,180 0 1 0 360,180 A 180,180 0 1 0 0,180 Z"

app = ely.App(title="Hello", identifier="dev.example.hello")
window = app.window(transparent=True, title_bar=False,
                    resizable=False, initial_size=(360, 360))
window.set_hit_test_path(ELLIPSE)
app.run()

A 360 by 360 transparent ellipse window appears with no chrome, clipping clicks to the ellipse.

Four lead demos

The Getting Started tutorials walk through four flagship apps:

Demo Time What you build
Aurora Clock 30 min Borderless transparent ellipse clock with breathing aurora glow
Pomodoro Timer 25 min Rounded-rect Pomodoro with radial progress + popover settings
Stylized Music Player 90 min Late-1990s-style irregular faceplate music player skin
Butterfly Banner 20 min The Elysium logo: a butterfly descends and unfurls the wordmark

Together they exercise the entire public API: App, Window, shaped windows, skins, signals, effects, Tweens, Springs, Timelines, themes, components, brush, PBR, AI, marketplace.

The Designer

The companion authoring app ships as a signed standalone executable per OS:

  • macOS: Elysium Designer.app
  • Windows: ElysiumDesigner.exe
  • Linux: Elysium-Designer.AppImage

Download from releases, or build from source (see the build-from-source guide).

The Designer's lead tutorial is the Blue Morpho to Monarch butterfly texture-transfer workflow, which produces the same .esk the Butterfly Banner framework demo loads.

Architecture

Layer Crate / Package
Pure-Rust primitives (geometry, display list, color, time) ely-core
Windowing + input + a11y (winit) ely-platform
Skia paint + wgpu compositor + WGSL effects ely-render
.esk parser + naga shader sandbox + Ed25519 signatures ely-skin
Hot-reload IPC ely-ipc
PyO3 bindings (the _native module) ely-py
Pure-Python framework python/elysium/
Standalone visual designer elysium-designer/

Build from source

# Native + Python in one command:
maturin develop --release

# Rust workspace tests:
cd elysium-native && cargo test --workspace

# Python suite:
pytest python/elysium/

# Live-window end-to-end test (gated on a display):
ELYSIUM_RUN_WINDOW_TEST=1 pytest tests/test_smoke.py::test_phase0_live_window_end_to_end

Contributors: see CONTRIBUTING.md and the contributing guide on the docs site.

Where the artifacts land

What Where For
Framework elysium-native/target/wheels/ pip install consumers (developers building apps with the library)
Designer (Mac) dist/macos/ElysiumDesigner.app End-users on macOS
Designer (Win) dist/windows/ElysiumDesigner.exe End-users on Windows

The framework directory holds the pip-installable wheel + universal sdist produced by maturin build --release --sdist. The Designer directories hold the single-file PyInstaller bundles produced by scripts/build-designer.sh (or .ps1 on Windows) — no Python install required to run, since each bundle ships its own interpreter and the compiled native extension.

Cross-platform wheels + Designer binaries also come out of CI: trigger release-library.yml for wheels (Win/Mac arm64+x86_64/Linux), or build-binaries.yml for the Designer matrix.

Examples

Folder Purpose
examples/hello/ Minimum-viable app; smoke test
examples/butterfly/ Blue Morpho reference + Monarch model used by both lead tutorials
examples/components/ Single-window showcase of every built-in component
examples/agent-cursor/ Aether-driven borderless cursor companion
examples/snapshot-relay/ Headless /snapshot HTTP relay for tests

License

Permissive. See LICENSE.

Links

Project links

Data verified by PyPI on Jul 4, 2026
Data provided by the project maintainers, verified at the time the release was uploaded to PyPI.

Key dates

PyPI data
Data sourced directly from PyPI's database.
  • Released:
  • Yanked:
Newer release available (1.2.1)

1 maintainer

PyPI data
Data sourced directly from PyPI's database.
Avatar for lamautelabs from gravatar.com lamautelabs

Credits

Author: Elysium UI Contributors

GitHub Statistics

Data verified by PyPI on Jul 4, 2026
The GitHub source repository was provided by the project maintainers and verified by PyPI at the time of upload. Stars, forks, and open issues/PRs are derived from that repository and have not been independently verified.

License

Apache Software License (Apache-2.0)

Requires

Python >=3.10

Provides Extra

ai build dev

Tags

ui gui skia wgpu desktop python

Classifiers

Report project as malware

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

elysium_ui-1.1.3.tar.gz (606.8 kB view details)

Uploaded Source

Built Distributions

If you're not sure about the file name format, learn more about wheel file names.

elysium_ui-1.1.3-cp310-abi3-win_amd64.whl (10.8 MB view details)

Uploaded CPython 3.10+Windows x86-64

elysium_ui-1.1.3-cp310-abi3-manylinux_2_28_x86_64.whl (13.6 MB view details)

Uploaded CPython 3.10+manylinux: glibc 2.28+ x86-64

elysium_ui-1.1.3-cp310-abi3-macosx_11_0_arm64.whl (9.7 MB view details)

Uploaded CPython 3.10+macOS 11.0+ ARM64

elysium_ui-1.1.3-cp310-abi3-macosx_10_12_x86_64.whl (9.9 MB view details)

Uploaded CPython 3.10+macOS 10.12+ x86-64

File details

Details for the file elysium_ui-1.1.3.tar.gz.

File metadata

  • Download URL: elysium_ui-1.1.3.tar.gz
  • Upload date:
  • Size: 606.8 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/6.1.0 CPython/3.13.12

File hashes

Hashes for elysium_ui-1.1.3.tar.gz
Algorithm Hash digest
SHA256 cf97981cb5cb00a6f9fb88538b2fd3434753286625e56a9c362cea95d9941986
MD5 e25d6e85e2c4daf7f767beb9a19301ec
BLAKE2b-256 10b00b379c7cb8d9f51e121f37bdea4e4e72b186e5795e2655200fe8a475f550

See more details on using hashes here.

Provenance

The following attestation bundles were made for elysium_ui-1.1.3.tar.gz:

Publisher: release-library.yml on elysiumui/elysium

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

File details

Details for the file elysium_ui-1.1.3-cp310-abi3-win_amd64.whl.

File metadata

  • Download URL: elysium_ui-1.1.3-cp310-abi3-win_amd64.whl
  • Upload date:
  • Size: 10.8 MB
  • Tags: CPython 3.10+, Windows x86-64
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/6.1.0 CPython/3.13.12

File hashes

Hashes for elysium_ui-1.1.3-cp310-abi3-win_amd64.whl
Algorithm Hash digest
SHA256 8ae7bdd1e49722cd96a21ed056c96756bf9340ee600e6f9891f7bc1b2ec0e425
MD5 dc7c140a023a00ea4166074320e51278
BLAKE2b-256 5e6d3dad49cfc20f66770649108e97ceb0b2fb74335ac7145f975e0471267d63

See more details on using hashes here.

Provenance

The following attestation bundles were made for elysium_ui-1.1.3-cp310-abi3-win_amd64.whl:

Publisher: release-library.yml on elysiumui/elysium

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

File details

Details for the file elysium_ui-1.1.3-cp310-abi3-manylinux_2_28_x86_64.whl.

File metadata

File hashes

Hashes for elysium_ui-1.1.3-cp310-abi3-manylinux_2_28_x86_64.whl
Algorithm Hash digest
SHA256 d340249506307fc66a0d20445f81ee2d178f0db6978f7f43e2d341fb3780177d
MD5 8a0c725d03ad6487494269989fd1a8f5
BLAKE2b-256 2b059409b7a3135f5f616e8194450d2d30341aca0c1c5589aee950842a982c87

See more details on using hashes here.

Provenance

The following attestation bundles were made for elysium_ui-1.1.3-cp310-abi3-manylinux_2_28_x86_64.whl:

Publisher: release-library.yml on elysiumui/elysium

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

File details

Details for the file elysium_ui-1.1.3-cp310-abi3-macosx_11_0_arm64.whl.

File metadata

File hashes

Hashes for elysium_ui-1.1.3-cp310-abi3-macosx_11_0_arm64.whl
Algorithm Hash digest
SHA256 7eefd7a59030cf3422349e4ad1e3ee3c67f3659e42ef796ba0f8430d4f2fb0a9
MD5 0f881912fc4f7ca505b0202610b70efa
BLAKE2b-256 8de37df689a70dad6275618a23432168744edf326407edc1985e520b244d9a39

See more details on using hashes here.

Provenance

The following attestation bundles were made for elysium_ui-1.1.3-cp310-abi3-macosx_11_0_arm64.whl:

Publisher: release-library.yml on elysiumui/elysium

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

File details

Details for the file elysium_ui-1.1.3-cp310-abi3-macosx_10_12_x86_64.whl.

File metadata

File hashes

Hashes for elysium_ui-1.1.3-cp310-abi3-macosx_10_12_x86_64.whl
Algorithm Hash digest
SHA256 408433d56aa87917993e5f6f63dabe5dc202ff6eb0c6db3382b447f72bd2a264
MD5 04c19168d6905e836bfc9cef4a026438
BLAKE2b-256 6417dc8ddf847073b4e5649107b95f74c13221938b63a5e942fa92a2fbf785c4

See more details on using hashes here.

Provenance

The following attestation bundles were made for elysium_ui-1.1.3-cp310-abi3-macosx_10_12_x86_64.whl:

Publisher: release-library.yml on elysiumui/elysium

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page