Files
nousresearch--hermes-agent/website/docs/getting-started/platform-support.md
T
wehub-resource-sync b4fbd6fe9f
Deploy Site / deploy-vercel (push) Has been skipped
Deploy Site / deploy-docs (push) Has been skipped
Build Skills Index / build-index (push) Has been skipped
CI / Deny unrelated histories (push) Has been skipped
CI / Detect affected areas (push) Successful in 27m35s
CI / OSV scan (push) Failing after 4s
CI / Build&Test Docker image (push) Successful in 9s
CI / Supply-chain scan (push) Has been skipped
CI / Lint Docker scripts (push) Failing after 5m13s
CI / Check contributors (push) Failing after 12m8s
CI / Docs Site (push) Failing after 12m8s
CI / TypeScript (push) Failing after 12m8s
CI / Python lints (push) Failing after 12m9s
CI / Python tests (push) Failing after 12m9s
CI / Check uv.lock (push) Failing after 23m22s
CI / CI timing report (push) Has been cancelled
Build Skills Index / trigger-deploy (push) Has been cancelled
CI / All required checks pass (push) Has been cancelled
chore: import upstream snapshot with attribution
2026-07-13 11:56:03 +08:00

4.2 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) Hermes Desktop, install.ps1 A few features are not available.
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
Android (Termux) (aarch64) install.sh A few features are not available.
Nix (MacOS, Linux, NixOS) install.sh Breaks often due to node.js packaging woes. Best of luck~! <3

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.

  • installs via the AUR (we might upstream patches if it helps out <3)
  • macOS on x86 (Intel) processors
  • installs via pypi (e.g. uv tool install hermes-agent, pip install hermse-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.