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 — giving you shared browser sessions across agents, persistent logins and cookies, profile management, and access to Browser Use’s full command surface.

​
Setup

1. Install the CLI 
curl -fsSL https://browser-use.com/cli/install.sh | bash
2. Verify the installation 
browser-use doctor
3. Install the skill The Browser Use skill teaches Hermes the full CLI command set. Install it from skills.sh: 
hermes skills install skills-sh/browser-use/browser-use/browser-use
Or ask Hermes directly in chat to install it. 4. Connect to cloud browsers Log in with your API key: 
browser-use cloud login <your-api-key>
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 advanced features like cloud browsers, tunnels, sessions, and Python execution, 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: 
curl -fsSL https://browser-use.com/cli/install.sh | bash
The agent runs three CLI commands using its terminal tool: 1. Request a challenge 
browser-use cloud signup
Returns a Challenge ID and Challenge — an obfuscated math problem that requires LLM reasoning to solve. 2. Solve the challenge and verify The agent solves the math problem, then verifies with the answer (a string with 2 decimal places, e.g. "13.60"): 
browser-use cloud signup --verify <challenge-id> <answer>
The CLI saves the API key to ~/.browser-use/config.json automatically. 3. Copy the key to Hermes config For the cloud browser backend (Option 1): 
hermes config set BROWSER_USE_API_KEY $(browser-use config get api_key)
For CLI mode (Option 2), the key is already saved — no extra step needed.

​
Claim the account (optional)

If the human wants to see the account in the dashboard later: 
browser-use cloud signup --claim
Returns a claim URL valid for 1 hour. The human can follow the link to sign up and claim the agent-created account.