How to fix: hermes: command not found
hermes: command not found almost always means your shell hasn't reloaded PATH: run source ~/.bashrc or source ~/.zshrc, or open a new terminal. The installer adds ~/.local/bin to PATH.
Who this is for:Anyone whose first hermes command fails right after installation.
Steps
-
Reload your shell config
bash users load .bashrc; zsh users (macOS default) load .zshrc.
source ~/.bashrc # or source ~/.zshrc -
Or open a new terminal window
A fresh window picks up the updated PATH.
-
Still failing? Check PATH
The installer places the binary in ~/.local/bin; make sure it is on PATH.
echo $PATH | tr ':' '\n' | grep local -
Full diagnostics
hermes doctor
How to verify
- hermes opens the chat interface in a new terminal
FAQ
I use fish or another shell?
Official FAQ: Hermes sources ~/.bashrc by default; add your init files in config.yaml under terminal.shell_init_files.
Tools from nvm/pyenv also missing?
Add their init scripts (e.g. ~/.nvm/nvm.sh) to terminal.shell_init_files in config.yaml.
Related pages
- Download and Install Hermes Agent on macOS
- Download and Install Hermes Agent on Windows (Desktop / PowerShell / WSL2)
- Download and Install Hermes Agent on Linux
- Install Hermes Agent on WSL2 (Advanced Windows Path)
- Hermes Agent Model Provider and API Key Setup
- Migrate from OpenClaw to Hermes Agent (official hermes claw migrate)
- How to fix: API key not set / invalid API key
- How to fix: Hermes requires Python 3.11 or newer
- How to fix: context length exceeded
- Telegram + Hermes Agent: Known Pitfalls and Fixes
- Curated official issues
- School solution cards