d84e11af4d
Removes Homebrew and PyPI wheel/sdist as Hermes distribution paths while
preserving the supported source, Docker, and Nix workflows.
Changes:
- Removes the Homebrew formula, PyPI publish workflow, sdist manifest
(MANIFEST.in), and wheel/sdist release-attachment logic from scripts/release.py.
- Keeps setuptools metadata and entry points required by editable installs
and Docker/Nix builds, but adds a setup.py guard that rejects wheel/sdist
builds outside a sealed Nix derivation (HERMES_NIX_BUILD=1).
- Removes pip/Homebrew install detection, PyPI update checks, the pip
self-update path, the deprecation-banner state, the postinstall subcommand,
wheel data-directory fallbacks in agent/i18n.py and hermes_constants.py,
and the ACP Registry manifest/version-lockstep release logic.
- Adds /nix/store/ path detection so `nix run` / `nix profile install`
installs (which don't set HERMES_MANAGED) are correctly identified as
"nix" rather than falling through to "git"/"unknown".
- Retired install-method values ("pip", "homebrew") in existing
.install_method stamps (both code-scoped and home-scoped) are ignored by
the allowlist reader and fall through to "unknown" instead of resurrecting
a retired enum value.
- Updates Nix packaging to ship bare runtime data (locales, optional-mcps)
through store symlinks and wrapper env vars instead of wheel data-files.
- Removes the ACP Registry manifest/icon and their version-lockstep tests.
- Deletes or rewrites packaging, pip-update, Homebrew, and ACP Registry
tests; adds parametrized coverage for the packaging build guard covering
BOTH sdist and wheel paths (the guards live in separate cmdclass entries
— a passing sdist test proves nothing about the wheel path).
- Updates installation/platform documentation and related user-facing copy.
- Adjusts the supply-chain scan so deleted install-hook files do not trigger
a finding, while additions or modifications still require the existing
ci-reviewed label gate.
Supported installation paths (unchanged):
- git installer (install.sh)
- Docker
- Nix/NixOS
- editable development installs (uv sync, uv pip install -e ., pip install -e .)
4.2 KiB
| 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 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.