Set Up Browser Automation with Browserbase
Enable Hermes to browse the web, fill forms, click buttons, and scrape data using cloud-based browser automation.
Browser automation lets Hermes interact with websites like a human — navigate pages, fill forms, click buttons, extract data, and even solve CAPTCHAs. Browserbase provides cloud browsers with stealth features to avoid bot detection.
Managed cloud · API costs included · Skill library · Cancel anytime
Before you start:
- ☑Hermes Agent installed
- ☑Browserbase account with API key
- ☑Browser toolset enabled (default in CLI)
Steps
- 1
Sign up for Browserbase
Create an account at browserbase.com and get your API key
- 2
Add credentials to .env
Set BROWSERBASE_API_KEY and BROWSERBASE_PROJECT_ID in ~/.hermes/.env
- 3
Enable the browser toolset
The browser toolset is enabled by default in hermes-cli preset
- 4
Configure stealth options
Set BROWSERBASE_PROXIES=true for residential IPs, BROWSERBASE_ADVANCED_STEALTH=true for Scale plan
- 5
Test browser tools
Ask Hermes: 'Navigate to example.com and tell me what you see'
Pro Tips
- 💡Basic stealth (random fingerprints, auto CAPTCHA) is always active — no extra config needed
- 💡Residential proxies (BROWSERBASE_PROXIES=true) dramatically improve success rate on protected sites
- 💡Advanced stealth requires Browserbase Scale plan — uses custom Chromium to avoid all detection
- 💡Set BROWSER_INACTIVITY_TIMEOUT to control when idle sessions are cleaned up
Troubleshooting
❌ Browser navigation fails
✅ Check your BROWSERBASE_API_KEY and BROWSERBASE_PROJECT_ID are correct. Verify on browserbase.com dashboard.
❌ CAPTCHA challenges blocking automation
✅ Enable residential proxies: BROWSERBASE_PROXIES=true. For persistent issues, upgrade to Scale plan for advanced stealth.
❌ Browser session times out
✅ Increase BROWSER_SESSION_TIMEOUT (default 300 seconds). Some sites require longer sessions.
❌ Screenshots not visible
✅ Hermes uses vision models to analyze screenshots. Ensure your auxiliary: vision: provider is configured correctly.