Install Hermes Agent step by step

Use the official installer, choose a supported environment, and complete the first-run setup on macOS, Linux, WSL2, or Termux.

Official Docs GitHub

Official Installer

Run the official installer

curl -fsSL https://raw.githubusercontent.com/NousResearch/hermes-agent/main/scripts/install.sh | bash

Works on Linux, macOS, WSL2, and Android via Termux.

Reload your shell after install before launching Hermes.

Use the official docs for contributor or edge-case setup.

Before you run the installer

Before you begin, confirm your environment, model provider, and install path.

Use a supported host

Hermes officially supports Linux, macOS, WSL2, and Android via Termux.

Route Windows through WSL2

Native Windows is not the primary path; WSL2 is the recommended route.

Bring a model provider key

Bring an API key or compatible endpoint before you configure your first model.

Start with the official installer

The official installer is the recommended path unless you are doing contributor setup.

Choose a supported environment

Choose the machine or runtime where Hermes will run, then follow the official install path from that environment.

macOS

Strong fit for a personal always-on machine. Install with the official script, reload your shell, and start with `hermes`.

Good default for a dedicated Mac mini or workstation assistant.

Pair well with terminal-first usage, local files, and long-lived sessions.

Linux

The most natural target for VPS, homelab, and cloud setups where Hermes runs continuously in the background.

Best for remote server deployments and gateway-first messaging workflows.

Strong fit when you want Hermes living on infrastructure instead of your laptop.

WSL2

If you are on Windows, use WSL2 as the supported path and keep Hermes inside the Linux environment.

Avoids the rough edges of native Windows support.

Useful if your daily machine is Windows but you still want the official install path.

Termux / Android

Hermes can run on Android through Termux with a curated extra set rather than the full dependency bundle.

Useful for lightweight personal setups and experimentation.

Follow the official Termux guide when you need the mobile path.

Run the first commands

After installation, use these commands to launch Hermes, configure models, enable gateways, run diagnostics, and update the runtime.

Reload your shell after install.

source ~/.zshrc

Start the interactive terminal UI.

hermes

Choose your provider and model.

hermes model

Run the full configuration wizard for a complete setup flow.

hermes setup

Enable messaging platforms and remote conversations.

hermes gateway

Troubleshoot configuration, dependency, or runtime issues.

hermes doctor

Move to the latest released version.

hermes update

Continue after the install

After the initial setup is complete, continue with integrations, use cases, FAQ, and official project resources.

Integrations Map

Understand how Hermes connects to messaging platforms, providers, MCP servers, runtime backends, and voice workflows.

Open

Use Cases

See how Hermes fits coding, remote operations, messaging workflows, research, and scheduled automation.

Open

FAQ

Answers on cost, privacy, supported platforms, model choices, and how Hermes differs from standard chat tools.

Open

Blog

Guides and notes on installation, ecosystem comparisons, and practical Hermes workflows.

Open