skills.rest
hafley66
hafley66COMMUNITY
Explore all skills by this author →
GitHub

wgpu-headless-testing

Configure wgpu Rust tests for headless software rendering in CI.

1|Updated Mar 15, 2026
Search Tags:#headless#ci#visual-regression#xvfb#wgpu#egui#llvmpipe
One-click install
npx skills add https://github.com/hafley66/claude-research --skill wgpu-headless-testing
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: wgpu-headless-testing
Source: https://github.com/hafley66/claude-research/tree/main/skills/wgpu-headless-testing
Command: npx skills add https://github.com/hafley66/claude-research --skill wgpu-headless-testing

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Running GPU-bound Rust applications (wgpu, egui, eframe) in CI environments without a GPU is challenging. This Skill enables software rendering backends and virtual displays to validate rendering and visual regression.

Core Features & Use Cases

  • Headless rendering: render to textures without a display server.
  • Visual regression: compare snapshots across CI runs.
  • CI compatibility: works in Linux with Mesa llvmpipe and xvfb, and macOS runners with a real display.

Quick Start

Run the CI job with xvfb-run and set WGPU_BACKEND=gl to enable headless rendering tests.

Frequently Asked Questions about wgpu-headless-testing

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I run wgpu and egui tests in a CI pipeline without a GPU?▼

To run wgpu and egui tests in CI without a GPU, enable software rendering backends like Mesa llvmpipe and use xvfb-run for headless displays. Set WGPU_BACKEND=gl to configure the environment for rendering to textures during test execution.

What does headless rendering to texture mean for Rust graphics testing?▼

Headless rendering to texture means rendering wgpu and egui graphics outputs directly to textures without a physical display server. This allows visual regression testing to validate rendering pipelines in automated Linux CI environments lacking GPU hardware.

Can I use llvmpipe and xvfb for visual regression testing of eframe applications?▼

Yes, you can use Mesa llvmpipe and xvfb for visual regression testing of eframe applications. This combination provides a CPU-based software rendering backend and a virtual display to compare rendering snapshots across CI runs without needing physical GPU hardware.

Does wgpu testing on CPU backends work on macOS CI runners?▼

Wgpu testing on CPU backends works on macOS CI runners by utilizing the real display available on macOS environments. This cross-platform compatibility ensures visual regression tests can run on both Linux with llvmpipe and macOS runners.

Why do my wgpu visual regression tests fail in Linux CI environments?▼

Wgpu visual regression tests fail in Linux CI environments because the pipeline lacks a physical GPU and display server. Fix this by enabling WGPU_BACKEND=gl, configuring Mesa llvmpipe for software rendering, and running tests with xvfb-run.

Related Skills

Explore More Software Engineering Skills→
nebiusnebius
17

genesis

Run headless GPU-accelerated RL teacher training on Nebius with Genesis.

Official
Intermediate
az9713az9713

test-regression

Compare current page state against stored baselines to detect UI regressions.

Community
Intermediate
AreteDriverAreteDriver
4

cicd-pipeline

Implements CI/CD pipelines using Batcomputer for automated code review and deployment gating.

Community
Advanced
uneezaismailuneezaismail
2

sim-to-real

Bridge sim-to-real transfer for robotics control and perception on physical hardware.

Community
Advanced