[GH-ISSUE #5] Linux wheel requires X11 on headless systems #1

New issue

Closed

opened 2026-10-26 22:27:36 +00:00 by bsakaguchi · 0 comments

bsakaguchi commented

2026-10-26 22:27:36 +00:00

Owner

Originally created by @Functionhx on GitHub (Jul 10, 2026).
Original GitHub issue: https://github.com/Comfy-Org/comfy-angle/issues/5

The Linux wheel cannot be loaded on systems without X11.\n\nThe comfy-angle 0.1.0 x86_64 wheel has these DT_NEEDED entries on comfy_angle/libs/libGLESv2.so:\n\n- libX11.so.6\n- libXext.so.6\n- libxcb.so.1\n\nThis causes ComfyUI/ComfyUI#14728 before ANGLE can select its headless Vulkan backend.\n\nThe current packaging script extracts ANGLE libraries from Electron, so the wheel inherits Electron's X11-enabled build.\n\nFor Linux, we should build ANGLE with its Vulkan backend and without window-system or desktop-GL backends:\n\n angle_use_x11 = false\n angle_use_wayland = false\n angle_enable_gl = false\n angle_enable_vulkan = true\n\nAcceptance criteria:\n\n- libEGL.so and libGLESv2.so have no X11, Xext, or xcb DT_NEEDED entries.\n- Both libraries load in a minimal Linux container without X11 packages.\n- An EGL display can be initialized through EGL_PLATFORM_ANGLE_TYPE_VULKAN_ANGLE.\n- x86_64 and aarch64 wheels retain their current manylinux_2_28 tags.

Originally created by @Functionhx on GitHub (Jul 10, 2026). Original GitHub issue: https://github.com/Comfy-Org/comfy-angle/issues/5 The Linux wheel cannot be loaded on systems without X11.\n\nThe comfy-angle 0.1.0 x86_64 wheel has these DT_NEEDED entries on comfy_angle/libs/libGLESv2.so:\n\n- libX11.so.6\n- libXext.so.6\n- libxcb.so.1\n\nThis causes ComfyUI/ComfyUI#14728 before ANGLE can select its headless Vulkan backend.\n\nThe current packaging script extracts ANGLE libraries from Electron, so the wheel inherits Electron's X11-enabled build.\n\nFor Linux, we should build ANGLE with its Vulkan backend and without window-system or desktop-GL backends:\n\n angle_use_x11 = false\n angle_use_wayland = false\n angle_enable_gl = false\n angle_enable_vulkan = true\n\nAcceptance criteria:\n\n- libEGL.so and libGLESv2.so have no X11, Xext, or xcb DT_NEEDED entries.\n- Both libraries load in a minimal Linux container without X11 packages.\n- An EGL display can be initialized through EGL_PLATFORM_ANGLE_TYPE_VULKAN_ANGLE.\n- x86_64 and aarch64 wheels retain their current manylinux_2_28 tags.

bsakaguchi closed this issue

2026-10-26 22:27:36 +00:00

bsakaguchi referenced this issue

2026-10-26 22:27:40 +00:00

[PR #1] [MERGED] ci: add CLA Assistant workflow #4