What do I need before installing Hermes?

A Mac, Linux, WSL2, or Termux machine with Git. The installer provisions Python, Node.js, and the hermes binary itself, so there is little to prepare beyond that.

How do I know Hermes setup worked?

The setup flow connects your model access and drops you into chat. If the agent answers and can list its MCP servers, the install is good and you can move on to adding tools.

How do I add Locus Pro to Hermes?

Add the hosted MCP server with one command, approve access with hermes mcp login, and reload tools inside chat. From then on the agent discovers paid tools by outcome and every call settles from one prepaid balance.

Is Locus Pro required to use Hermes?

No. Hermes works with free MCP servers and its own belajar loop on its own. Locus Pro is the step that adds paid capabilities — specialist search, enrichment, finance, voice, and verification — without a separate account at each provider.

What do I need before installing Hermes?

A Mac, Linux, WSL2, or Termux machine with Git. The installer provisions Python, Node.js, and the hermes binary itself, so there is little to prepare beyond that.

How do I know Hermes setup worked?

The setup flow connects your model access and drops you into chat. If the agent answers and can list its MCP servers, the install is good and you can move on to adding tools.

How do I add Locus Pro to Hermes?

Add the hosted MCP server with one command, approve access with hermes mcp login, and reload tools inside chat. From then on the agent discovers paid tools by outcome and every call settles from one prepaid balance.

Is Locus Pro required to use Hermes?

No. Hermes works with free MCP servers and its own belajar loop on its own. Locus Pro is the step that adds paid capabilities — specialist search, enrichment, finance, voice, and verification — without a separate account at each provider.

Guide

How to set up the Hermes agent

Published 2026-09-15 · Updated 2026-09-15 · By Locus

Hermes is the self-improving agent from Nous Research, with MCP support for outside tools built in. Setup takes six steps: install, first run, and connect your tools — including Locus Pro for paid APIs. Work through them in order.

Setup, step by step

Step 1
Install Hermes
On macOS, Linux, WSL2, or Termux, run the installer. It provisions Python, Node.js, and the hermes binary.
```
curl -fsSL https://hermes-agent.nousresearch.com/install.sh | bash
```
Step 2
Run first-time setup
Connect your model access through the guided setup, then open chat to confirm the agent answers.
```
hermes setup --portal
```
Step 3
Confirm MCP support
The standard install includes MCP support. Open the server picker to confirm it lists entries.
```
hermes mcp
```
Step 4
Add Locus Pro
Register the hosted Locus Pro MCP server so the agent can call paid tools from one prepaid balance.
```
hermes mcp add --url https://api.paywithlocus.com/api/credits/mcp --auth oauth locus
```
Step 5
Approve access
Complete OAuth for the Locus Pro server, then reload tools inside chat so the agent picks them up.
```
hermes mcp login locus
```
Step 6
Verify tools
Ask the agent to search the Locus catalog for a capability, such as company enrichment, to confirm paid calls work.

What the Locus Pro step buys you

Steps 1 to 3 give you a working agent with free tools. Steps 4 and 5 add the paid layer: thousands of specialist APIs the agent discovers by outcome, each with its price shown up front, settled per call from one balance with policy controls. No per-provider accounts, keys, or subscriptions. For what to install next, see the best tools for a Hermes agent.

Locus Pro connection guide See pricing

How to set up the Hermes agent

Setup, step by step

What the Locus Pro step buys you

Keep going

Frequently asked questions