Hermes Agent

Give Hermes Agent cloud browser automation with Browser Use.

Hermes Agent is an open-source, self-improving AI agent by Nous Research. It has built-in browser automation tools that work with local Chromium out of the box. Add Browser Use and those tools run on cloud browsers with anti-detect profiles, residential proxies in 195+ countries, and stealth browsing.

Two ways to set it up: configure Browser Use as Hermes’s cloud browser backend, or install the Browser Use CLI and let Hermes drive it directly.

Option 1: Cloud Browser Backend

Hermes has built-in browser tools (browser_navigate, browser_click, browser_snapshot, etc.) that default to local Chromium. Point them at Browser Use cloud browsers instead — no extra dependencies, same Hermes experience.

Setup

1. Get your API key

Sign up at cloud.browser-use.com and copy your API key from Settings → API Keys.

Or let the agent provision one itself — see Agent Self-Registration below.

2. Configure Hermes

Run the setup wizard:

hermes setup tools

Select Browser Automation, then Browser Use, and paste your API key when prompted.

Or configure manually — add your key to ~/.hermes/.env:

BROWSER_USE_API_KEY=your_key_here

And set the provider in ~/.hermes/config.yaml:

browser:
  cloud_provider: browser-use

3. Use it

Just chat with Hermes — any browsing tasks automatically route through Browser Use cloud browsers:

> Find the top trending repositories on GitHub today and summarize them

Option 2: Browser Use CLI

The Browser Use CLI is a standalone tool that gives Hermes browser automation through terminal commands. Hermes drives the browser directly via its terminal tool, using Browser Harness and Python helpers through the browser-use command.

Setup

1. Install the CLI

uv tool install browser-use

2. Verify the installation

browser-use doctor

3. Register the skill

Register the Browser Use skill with the installed CLI:

browser-use skill install

Or ask Hermes directly in chat to install it.

4. Authenticate for cloud browsers

Authenticate with your API key:

browser-use auth login

Or let the agent provision one itself — see Agent Self-Registration below.

5. Use it

Once the skill is loaded, Hermes can drive the browser through CLI commands via its terminal tool:

> Use browser-use to open github.com/trending and summarize the top repos

For the complete CLI reference and Python execution examples, see the Browser Use CLI docs.

Agent Self-Registration

Hermes can provision its own Browser Use API key autonomously — no human interaction needed. This works with both options above.

Install the Browser Use CLI and skill:

uv tool install browser-use
browser-use skill install

The agent can follow the REST flow to request and verify a challenge, then use the returned API key.

Copy the key to Hermes config

For the cloud browser backend (Option 1):

hermes config set BROWSER_USE_API_KEY <api-key>

For CLI mode (Option 2), put the key in the agent’s shell environment:

export BROWSER_USE_API_KEY=bu_...
browser-use auth status

Claim the account (optional)

If the human wants to see the account in the dashboard later, use the claim endpoint. The returned claim URL is valid for 1 hour.