yaoyao-webui/packages/desktop

Hermes Studio

Electron desktop distribution for Hermes Studio.

Install

Download the latest macOS, Windows, or Linux installer for your CPU architecture from the project GitHub Releases.

The desktop app bundles the Web UI runtime and launches it locally from the native shell app.

Command shims

After the packaged desktop app starts, it installs managed command shims:

Command	Description
hermes-studio	Open the Hermes Studio desktop app
hermes-studio cli ...	Run the bundled Hermes Agent CLI
hermes-studio web ...	Run the bundled hermes-web-ui command
hermes-studio -h	Show wrapper help
hermes-studio-mcp	Run the managed Web UI MCP bridge

Use hermes-studio cli -h for Hermes Agent CLI help and hermes-studio web -h for Web UI CLI help.

Data directories

Hermes Agent data is stored in the same platform-specific location as native Hermes installs:

• Windows: %LOCALAPPDATA%\hermes (falls back to %APPDATA%\hermes)
• macOS/Linux: ~/.hermes

The desktop wrapper's own Web UI state is stored separately in ~/.hermes-web-ui unless HERMES_WEB_UI_HOME is set.

China mirror environment

These mirrors are optional and are not required in CI:

export NPM_CONFIG_REGISTRY=https://registry.npmmirror.com
export ELECTRON_MIRROR=https://npmmirror.com/mirrors/electron/
export ELECTRON_BUILDER_BINARIES_MIRROR=https://npmmirror.com/mirrors/electron-builder-binaries/

If GitHub release downloads are slow, fetch-python.mjs can also use a compatible python-build-standalone release mirror:

export PBS_BASE_URL=https://github.com/astral-sh/python-build-standalone/releases/download