Skip to content
OpenCharly

hermes-playwright-layer

Recipe card from the charly-hermes plugin (Images — the deployable catalog).

hermes-playwright – Playwright Chromium for Hermes

Section titled “hermes-playwright – Playwright Chromium for Hermes”

Candy Properties

Section titled “Candy Properties”
Property Value
Dependencies hermes
Security shm_size: 1g
Install files charly.yml, package.json, task:
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

Section titled “Environment Variables”
Variable Value
PLAYWRIGHT_BROWSERS_PATH /tmp/.cache/ms-playwright

Architecture

Section titled “Architecture”

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

Fedora Compatibility

Section titled “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 charly.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

Section titled “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

Section titled “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:

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

Or use the npx CLI directly:

Terminal window
npx playwright --version

Usage

Section titled “Usage”
charly.yml
hermes-playwright:
  base: fedora
  candy:
    - agent-forwarding
    - hermes
    - hermes-playwright
    - dbus
    - charly

Used In Boxes

Section titled “Used In Boxes”
Section titled “Related Candies”

When to Use This Skill

Section titled “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 candy. Invoke this skill BEFORE reading source code or launching Explore agents.

Section titled “Related”
  • /charly-image:layer — candy authoring reference (charly.yml schema, task verbs, service declarations)
  • /charly-check:check — declarative testing (check: block, charly check box, charly check live)