🤖 Hermes Agent
Guided Docs

Installation

A shorter, operator-first installation guide that helps you decide whether your environment is a clean fit before you start pasting commands.

Who this is for

Use this page if you want to decide whether Hermes is worth installing on this machine right now, and you want the shortest credible path to a working setup.

Supported environments

  • macOS
  • Linux
  • Windows through WSL2
  • Android through Termux

Do not waste time on

  • Native Windows as your first install path
  • Multiple provider setups before one baseline provider works
  • Broad messaging rollout before local setup is stable

Before you run the installer

  • Confirm you are on macOS, Linux, WSL2, or Termux.
  • Keep at least 2GB of available RAM as a practical baseline.
  • Make sure you can reach the internet and your chosen model provider.
  • Treat the install as phase one only. The actual goal is finishing hermes setup afterward.

Install command

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

hermes setup

The important part is not just getting the installer to run. The meaningful finish line is completing hermes setup with one working provider path.

What to do immediately after install

  1. Run hermes setup.
  2. Pick one provider, not several.
  3. Verify Hermes can respond in the terminal.
  4. Only then decide whether you want Telegram, migration, or additional tools next.
Next: Quickstart Related: First 30 Minutes
Source: Official Installation docs
Official References

If you want the original docs, release notes, and repository pages, start here.

Repo Releases Docs