Platform Support
الأنظمة المدعومة وحدود كل نظام
What this page is, and what it holds.
This page covers Platform Support. About 3 minutes to read. Read what the installer does before running it, then run hermes doctor to see what is missing.
Which operating systems, distribution methods, and features Hermes Agent supports.
Outcomes taken from this page, not a template.
- Understand what التثبيت is and when you need it.
- Read the table and take only the row that applies to you.
- Know the common mistake before you hit it.
Jump to the part you need.
Nothing summarised away.
The documentation body below is reproduced from the official source so commands and identifiers stay exact. Each section carries a short note describing what it contains.
Hermes Agent maintains support for many platforms and distribution methods, but we can't support every possible install method.
---
Tier 1
A lookup table. Do not read it all; find the row that applies to you.
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
Explains the idea itself. Read it slowly; the later sections build on it.
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
Explains the idea itself. Read it slowly; the later sections build on it.
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.
2 questions answered by this page alone.
Every option is a real identifier from the Hermes documentation. The wrong ones are real too, just from other pages.