Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.browserbase.com/llms.txt

Use this file to discover all available pages before exploring further.

This guide recommends two Browserbase setup paths for Hermes Agent, in this order:
  1. Use Hermes’ built-in Browserbase cloud mode.
  2. Use the Browse CLI if you specifically want browse workflows.
This is the preferred path because Hermes already supports Browserbase as a built-in cloud browser provider.
1

Get your Browserbase credentials

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

Add Browserbase credentials to Hermes

Add the following to ~/.hermes/.env:
BROWSERBASE_API_KEY=your_browserbase_api_key
3

Enable Hermes browser automation

If you have not enabled browser tools yet, run:
hermes tools
Then enable Browser Automation in the Hermes setup flow.
4

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.
1

Install the Browse CLI

npm i -g browse
2

Authenticate with your Browserbase API key

export BROWSERBASE_API_KEY="your_api_key"
3

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.