959c7649fd
click-session flake (#97982): a bare scrollIntoView() smooth scroll could be dropped under load, and the script slept a fixed 3000ms before reading state. Extract click-session-helpers.mjs: instant centered scroll, a bounded poll-for-composer loop instead of the fixed sleep, and correct nested CDP envelope unwrapping (the old read logged undefined). Intel-Mac installer docs (#99033): the Hermes-Setup.dmg bootstrap installer is built for Apple Silicon only, so Intel Macs hit "not supported on this Mac". The desktop release pipeline already builds a native darwin-x64 bundle, so the docs now scope the arm64 limit to the bootstrap installer and name the darwin-x64 bundle (or the CLI plus `hermes desktop`) as the Intel path, in the desktop README and the platform-support build-targets section. cua-driver autostart opt-in (#97389): Windows installs registered the cua-driver-serve scheduled task on every install, with no opt-out, and treated the task as an install-readiness requirement. Gate the install-ready check and _repair_cua_driver_autostart_windows on the new computer_use.autostart config key (default false = on-demand, fails closed), extract the registration PowerShell into a testable helper, and document the opt-in (EN + zh-Hans). Windows-only code path: unit tests cover the registration args and the config gate; live Windows verification pending.
5.0 KiB
sidebar_position, title, description
| sidebar_position | title | description |
|---|---|---|
| 2.5 | Platform Support | Which operating systems, distribution methods, and features Hermes Agent supports. |
Platform Support
Hermes Agent maintains support for many platforms and distribution methods, but we can't support every possible install method.
Tier 1
We strive to never break installations and updates for these. Issues & regressions in Tier 1 are our first priority and take precedence over other platforms.
| OS / Architecture | Installation methods | Notes |
|---|---|---|
| macOS (Apple Silicon) | Hermes Desktop, install.sh |
|
| Windows 10 / 11 (x86_64, aarch64) | install.ps1, MSIX desktop |
The MSIX package requires Windows 11 22H2 or later. Optional dependencies have architecture limits. |
| Linux / WSL2 (x86_64, aarch64) | install.sh |
We test on the latest Ubuntu and WSL2. If your distro has glibc, systemd, and follows the Filesystem Hierarchy Standard, it's likely to work pretty well. |
| Docker Container (x86_64, aarch64) | docker pull |
Docker installs do not support hermes update. Updating is done by running a new image. |
Tier 2
These platforms are maintained in-tree only as a best effort. Releases may break them, and we can't promise we'll fix them promptly when they break.
PRs will be accepted to fix issues with them, but they will take precedence below fixing issues with Tier 1 platforms.
| OS / Architecture | Installation methods | Notes |
|---|---|---|
| Nix (macOS, Linux, NixOS) | Nix flake and modules | Nix owns runtime installation and updates. |
| Android / Termux (aarch64) | Signed APT repository, then pkg install hermes-agent |
Prerelease package with Python, Node, and TUI. Run the gateway in a Termux session; Android can terminate background processes. |
Build targets and support priority
The native bundle pipeline includes Intel macOS (x64) as well as Apple Silicon.
It also defines signed-package update acceptance for both architectures.
That coverage does not change the Tier 1 priority assigned to Apple Silicon.
The Hermes-Setup.dmg bootstrap installer is the exception: it is built for
Apple Silicon (arm64) only, so on an Intel Mac it reports "not supported on
this Mac". Intel Macs use the darwin-x64 desktop bundle instead, or install
the CLI and run
hermes desktop.
Linux desktop packaging is disabled in the release workflow, although local
AppImage builds and native Linux PM bundle checks exist.
Unsupported
These platforms and distribution methods are not supported. We suggest that you migrate to a supported distribution method or platform. They may be broken right now, they may break more in the future. PRs to fix them will not be accepted, and any code that keeps compatibility with them may be removed at any point.
- Android / Termux on non-aarch64 devices (aarch64 is supported via our APT package)
- installs via the AUR (we might upstream patches if it helps out <3)
- 32-bit x86 macOS. Intel x86_64 has native bundle build and package-update acceptance lanes; this does not change the Tier 1 priority for Apple Silicon.
- installs via
pypi(e.g.uv tool install hermes-agent,pip install hermes-agent, etc.) - installs via
brew(brew install hermes-agent)
If you are using an unsupported distribution method, please read the the installation guide to learn how to switch to a supported one.