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

# Hermes Agent setup

> Set up Hermes Agent with Browserbase, starting with Hermes' built-in Browserbase cloud mode and then the Browse CLI.

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](/integrations/skills/browserbase-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.

<Steps>
  <Step title="Get your Browserbase credentials">
    Create a Browserbase account, then copy your API key from the [Overview dashboard](https://www.browserbase.com/overview).
  </Step>

  <Step title="Add Browserbase credentials to Hermes">
    Add the following to `~/.hermes/.env`:

    ```bash theme={null}
    BROWSERBASE_API_KEY=your_browserbase_api_key
    ```
  </Step>

  <Step title="Enable Hermes browser automation">
    If you have not enabled browser tools yet, run:

    ```bash theme={null}
    hermes tools
    ```

    Then enable **Browser Automation** in the Hermes setup flow.
  </Step>

  <Step title="Start browsing with Hermes">
    Once configured, Hermes can use its native browser toolset against Browserbase-managed cloud browsers.

    Example prompts:

    ```text theme={null}
    Open https://example.com and summarize the page
    Navigate to https://news.ycombinator.com and extract the top 5 story titles
    ```
  </Step>
</Steps>

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

## Helpful Browserbase settings

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

```bash theme={null}
# 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.

<Steps>
  <Step title="Install the Browse CLI">
    ```bash theme={null}
    npm i -g browse
    ```
  </Step>

  <Step title="Authenticate with your Browserbase API key">
    ```bash theme={null}
    export BROWSERBASE_API_KEY="your_api_key"
    ```
  </Step>

  <Step title="Use `browse` commands for Browserbase workflows">
    Example commands:

    ```bash theme={null}
    browse projects list
    browse sessions get <session_id>
    browse fetch https://example.com
    browse search "browser automation" --num-results 5
    ```
  </Step>
</Steps>

For the full CLI workflow reference, see the [Browse CLI guide](/integrations/skills/browserbase-cli).