Files
Hermes-ui/packages/desktop
sir1st 96bdf8d1af fix Windows desktop startup readiness (#1167)
* fix desktop startup readiness on windows

* add manual desktop build workflow

* hide Windows desktop server process window

* hide Windows Python bridge worker windows

* use no-window Python for Windows desktop CLI calls

---------

Co-authored-by: xingzhi <chuzihao.czh@alibaba-inc.com>
2026-05-31 09:17:49 +08:00
..

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.

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