Install

Prerequisite: uv must be installed.

Install from PyPI:

uv tool install yumo2

Or run once without installing:

uv run --with yumo2 yumo2 gui --data field.plt --mesh mesh.stl

Ubuntu on WSL

Install the common X11 / OpenGL runtime packages first:

sudo apt update
sudo apt install -y libglu1-mesa mesa-utils x11-apps

Verify that GUI forwarding is available:

echo $DISPLAY
xeyes

If the GUI opens a black window briefly and then segfaults under WSL, run yumo2 with software OpenGL:

uv tool install yumo2
LIBGL_ALWAYS_SOFTWARE=1 yumo2 gui --data field.plt --mesh mesh.stl

Or run once without installing:

LIBGL_ALWAYS_SOFTWARE=1 uv run --with yumo2 yumo2 gui --data field.plt --mesh mesh.stl

mesa-utils is optional for diagnostics such as glxinfo, and x11-apps is useful for quickly verifying that X11/WSLg forwarding is working.