overthinkos/hermes-playwright

hermes-playwright -- Playwright Chromium for Hermes

Layer Properties

| Property | Value | |----------|-------| | Dependencies | hermes | | Security | shm_size: 1g | | Install files | layer.yml, package.json, tasks: | | RPM packages | alsa-lib, at-spi2-core, cups-libs, gtk3, libdrm, libxkbcommon, nss, mesa-dri-drivers, vulkan-loader, libXcomposite, libXdamage, libXrandr, pango, cairo |

Environment Variables

| Variable | Value | |----------|-------| | PLAYWRIGHT_BROWSERS_PATH | /tmp/.cache/ms-playwright |

Architecture

This is a Tier 1 layer (no pixi.toml) that adds Playwright + Chromium on top of the hermes layer.

Fedora Compatibility

Playwright's npx playwright install --with-deps does not support Fedora -- it falls back to Ubuntu and tries apt-get, which fails. The workaround:

1. rpm packages in layer.yml install all Chromium system library dependencies manually
2. A root-phase cmd: task runs npx playwright install chromium (without --with-deps) to download only the browser binary

Browser Location

Browsers are installed to /tmp/.cache/ms-playwright/ during the build (the cmd runs as root with HOME=/tmp). The PLAYWRIGHT_BROWSERS_PATH env var ensures Playwright finds them at runtime.

Using Playwright from Node.js

The Playwright npm package is installed globally via the npm builder (from package.json). To require('playwright') in Node.js, set NODE_PATH:

NODE_PATH=~/.npm-global/lib/node_modules node -e "const { chromium } = require('playwright'); ..."

Or use the npx CLI directly:

npx playwright --version

Usage

# image.yml
hermes-playwright:
  base: fedora
  layers:
    - agent-forwarding
    - hermes
    - hermes-playwright
    - dbus
    - ov

Used In Images

• /ov-images:hermes-playwright -- hermes with Playwright Chromium

Related Layers

• /ov-layers:hermes -- base hermes agent (required dependency)
• /ov-layers:chrome -- similar pattern for Chrome system deps
• /ov-layers:playwright -- OpenClaw's Playwright layer (npm only, no Chromium binary)

When to Use This Skill

MUST be invoked when the task involves Playwright browser automation in hermes containers, Chromium system dependencies on Fedora, or the hermes-playwright layer. Invoke this skill BEFORE reading source code or launching Explore agents.

Related

• /ov:layer — layer authoring reference (layer.yml schema, task verbs, service declarations)
• /ov:test — declarative testing (tests: block, ov image test, ov test)