Direct answer Official install routes, as listed at hermes-agent.nousresearch.com on 2026-11-15: desktop packages for macOS (Apple Silicon only) and Windows from the official site; a command-line installer (curl -fsSL https://hermes-agent.nousresearch.com/install.sh | bash on Linux/macOS/WSL2, iex (irm https://hermes-agent.nousresearch.com/install.ps1) in PowerShell); or a Termux APT package on aarch64 Android. Then hermes setup --portal covers model plus Tool Gateway in one login. Unofficial compilation; each step links to the official page.
Skip to content
BotClawAgent ObserverTracking personal agents: progress and limits
2026.11.16
TASK PAGE · UNOFFICIAL COMPILATION

Hermes Agent install: scripts, desktop packages, Termux

Unofficial compilation of official sources · information collected 2026-11-15. Every step and every number links to the official page it was taken from.

Official install routes, as listed at hermes-agent.nousresearch.com on 2026-11-15: desktop packages for macOS (Apple Silicon only) and Windows from the official site; a command-line installer (curl -fsSL https://hermes-agent.nousresearch.com/install.sh | bash on Linux/macOS/WSL2, iex (irm https://hermes-agent.nousresearch.com/install.ps1) in PowerShell); or a Termux APT package on aarch64 Android. Then hermes setup --portal covers model plus Tool Gateway in one login. Unofficial compilation; each step links to the official page.

Official sources used:

  • Hermes Agent docs — Installation (https://hermes-agent.nousresearch.com/docs/getting-started/installation)
  • Hermes Agent official site

Steps, each linked to its source

  1. Desktop packages: Windows opens the .appinstaller download with Windows App Installer (signed MSIX); macOS opens the DMG and copies Hermes.app to Applications (Apple Silicon only; Intel macOS is not supported). Bundles contain the agent, Python and prebuilt interfaces. source ↗

  2. Command-line install: curl -fsSL https://hermes-agent.nousresearch.com/install.sh | bash on Linux/macOS/WSL2; in PowerShell run iex (irm https://hermes-agent.nousresearch.com/install.ps1). To add the desktop app afterwards: hermes desktop. source ↗

  3. Android: on aarch64 devices configure the signed Termux repository, then pkg install hermes-agent. The desktop/server scripts are not the Termux path. source ↗

  4. What the installer does: clones the source, bootstraps uv, and a package manager provides pinned Python, Node.js, ripgrep, FFmpeg, a pinned Chromium and the computer-use driver; a failed extra download does not abort the install and prints a retry command. source ↗

  5. After install: reload the shell (source ~/.bashrc), run hermes to start chatting. Configure with hermes model, hermes tools, hermes gateway setup, or the full wizard hermes setup; hermes doctor diagnoses what is missing. source ↗

  6. Fastest working setup per the official docs: hermes setup --portal — one OAuth covers a model plus the Tool Gateway tools (web search, image generation, TTS, browser). source ↗

Questions

Does Hermes Agent need an API key to run?

The official docs show two paths: hermes setup --portal (one subscription login covers a model plus Tool Gateway) or configuring a provider key with hermes model / hermes config set.

Is this page official?

No — an unofficial compilation of the official installation guide, checked 2026-11-15; the guide links above are the authority.