Prices checked October 14, 2026
Hermes Agent setup guide (the easiest path)
Part of the Hermes Agent beginner track · Nous Research (open source, MIT license).
What you need:
- A Mac with Apple Silicon (macOS 12+), a Windows 10/11 PC, or Linux. Intel Macs aren't supported by the Mac installer.
- An account for a model provider. The easiest is a free Nous Portal account.
- Optional: Telegram on your phone.
Simplest setup path (no terminal):
- Download Hermes Desktop from hermes-agent.nousresearch.com.
- Install it. Mac: open the DMG and copy Hermes.app to Applications. Windows: open the .appinstaller file.
- Open Hermes and follow the setup steps.
- Pick "Quick Setup (Nous Portal)." It logs you in, picks a model, and turns on web tools. No API keys.
- Have one normal chat. Ask it something simple.
- Only then add Telegram (see How-to 1).
Terminal path (if you're comfortable): The website's one-line installer is curl -fsSL https://hermes-agent.nousresearch.com/install.sh | bash (Mac/Linux/WSL2). Then run hermes setup --portal. Only run install commands from the official site.
Minimal-risk option: Choose Blank Slate setup. Almost everything starts off, and you turn on only what you need.
First-run checklist:
- ☐ One normal chat works.
- ☐ Approvals mode is smart (default) or manual. Never off.
- ☐ Messaging is limited to my own user ID (allowlist).
- ☐ I use a separate email account for Hermes, not my personal one.
- ☐ I know how to stop it (Ctrl+C in the terminal, or /stop in chat).
- ☐ I wrote down which model I'm paying for.
Get the free safety checklist
7 rules for letting an agent act for you, plus a note when prices or features change. We re-check every month. Read the 7 rules.