Skip to main content
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.