Hermes Agent setup - Browserbase Documentation

This guide recommends two Browserbase setup paths for Hermes Agent, in this order:

Use Hermes’ built-in Browserbase cloud mode.
Use the Browse CLI if you specifically want browse workflows.

Recommended: Hermes Browserbase cloud mode

This is the preferred path because Hermes already supports Browserbase as a built-in cloud browser provider.

Get your Browserbase credentials

Create a Browserbase account, then copy your API key from the Overview dashboard.

Add Browserbase credentials to Hermes

Add the following to ~/.hermes/.env:

BROWSERBASE_API_KEY=your_browserbase_api_key

Enable Hermes browser automation

If you have not enabled browser tools yet, run:

hermes tools

Then enable Browser Automation in the Hermes setup flow.

Start browsing with Hermes

Once configured, Hermes can use its native browser toolset against Browserbase-managed cloud browsers.Example prompts:

Open https://example.com and summarize the page
Navigate to https://news.ycombinator.com and extract the top 5 story titles

According to the current Hermes browser docs, if you set both Browserbase and Browser Use credentials, Browserbase takes priority as the cloud browser provider.

Helpful Browserbase settings

Hermes also supports Browserbase-specific environment variables for common cloud browser behavior:

# Residential proxies for better CAPTCHA solving
BROWSERBASE_PROXIES=true

# Keep sessions alive across disconnects on supported plans
BROWSERBASE_KEEP_ALIVE=true

# Override session timeout in milliseconds
BROWSERBASE_SESSION_TIMEOUT=600000

Alternative: Browse CLI

If your workflow is centered on browse commands instead of Hermes’ native browser tools, use the Browse CLI.

Install the Browse CLI

npm i -g browse

Authenticate with your Browserbase API key

export BROWSERBASE_API_KEY="your_api_key"

Use `browse` commands for Browserbase workflows

Example commands:

browse projects list
browse sessions get <session_id>
browse fetch https://example.com
browse search "browser automation" --num-results 5

For the full CLI workflow reference, see the Browse CLI guide.

​Recommended: Hermes Browserbase cloud mode

​Helpful Browserbase settings

​Alternative: Browse CLI

Recommended: Hermes Browserbase cloud mode

Helpful Browserbase settings

Alternative: Browse CLI