GoldieBench Blog · 10 min read
Hermes Agent Browser Explained: What It Is, How To Enable It, Its Limits And The Models To Put Behind It
Hermes Agent browser is the built-in toolset that lets Hermes open, click and read web pages. What it is, setup, backends, limits and which models suit it.

Hermes Agent browser is the built-in browser automation toolset that lets Hermes Agent open a real web page, read it, click buttons, type into forms and take screenshots.
It is part of Hermes Agent, the free open-source agent from Nous Research, so the toolset itself costs nothing.
Below you'll find what it is, how it works, the commands that switch it on and off, every backend the docs list, how logins and safety work, the costs, the limits and a late section on models.
The Hermes facts come from the official Hermes browser docs, which I re-read on 12 October 2026, and from the help output of my own install on version 0.21.4.
What the Hermes Agent browser is in plain English
A chatbot can describe a website, but it can't use one.
The browser toolset gives the model a browser it can drive with tool calls.
The docs call it a full browser automation toolset with multiple backend options.
They say that in every mode the agent can navigate websites, interact with page elements, fill forms and extract information.
How the Hermes Agent browser works
The important design choice is how the model sees a page.
Hermes represents each page as an accessibility tree, which is a text-based snapshot.
Every interactive element gets a reference ID such as @e1 or @e2.
The model reads the snapshot, chooses a reference and calls a tool to click or type.
The compact snapshot shows only the interactive elements, and the full snapshot shows the whole page.
When text isn't enough, the model can call a vision tool that takes a screenshot and analyses it with vision AI.
That split matters for the model section later, because most of the work is reading text and making decisions.
What the browser toolset can do
The docs list these built-in tools.
| Tool | What it does |
|---|---|
browser_navigate | It opens a URL and has to be called before any other browser tool. |
browser_snapshot | It returns the text snapshot with element references. |
browser_click | It clicks an element by its reference. |
browser_type | It clears an input field and types new text. |
browser_scroll | It scrolls the page up or down. |
browser_press | It presses a key such as Enter, Tab or Escape. |
browser_back | It returns to the previous page. |
browser_get_images | It lists the images on a page with their URLs and alt text. |
browser_vision | It takes a screenshot and analyses it with a vision model. |
browser_console | It reads console errors and can evaluate a JavaScript expression. |
browser_cdp | It sends raw Chrome DevTools Protocol commands when a CDP endpoint is connected. |
browser_dialog | It accepts or dismisses alert, confirm and prompt boxes. |
The toolsets reference also lists vault tools that fill saved logins into sign-in pages.
There is one more tool called browser_exec.
The docs say Browser Use mode is now the default, so when the browser-use command-line tool can run, the model gets that single tool and writes short Python to drive the page.
If it can't run, Hermes falls back to the built-in tools in the table.
You can force the built-in tools by typing /browser use off.
That project has its own page here, which is my Hermes Agent browser use guide.
Browser tools vs web search and extract
The web toolset has web_search and web_extract, and it fetches information.
The browser toolset drives a live page.
The docs tell you to prefer the web tools for simple information retrieval, because they are faster and cheaper.
They tell you to use the browser when you need to click buttons, fill forms or handle dynamic content.
The toolsets reference adds that web search is deliberately not part of the browser toolset, so disabling the browser keeps lookups working.
How to enable or disable the Hermes Agent browser
I checked these commands against the help output on my own machine.
| What you want | What you type |
|---|---|
| See every toolset and its status | hermes tools list |
| Switch the browser on | hermes tools enable browser |
| Switch the browser off | hermes tools disable browser |
| Change one platform only | Add --platform telegram to either command. |
| Open the interactive menu and pick a backend | hermes tools, then Browser Automation |
| Switch it off inside a chat | /tools disable browser |
| Install a missing local browser | hermes pm install agent-browser |
When I ran the list command on 12 October 2026, the browser toolset already showed as enabled for the terminal on my install.
The toolsets reference says the default terminal toolset includes the browser, so most people only need to check.
The browser backends the docs list
A backend is where the browser runs.
| Backend | Where it runs | What the docs say |
|---|---|---|
| Local browser | Your machine | Hermes launches its own packaged Chromium through the agent-browser tool. |
| Your own browser over CDP | Your machine | The /browser connect command attaches to Chrome, Brave, Chromium or Edge. |
| Real profile browsing | Your machine | Hermes drives a copy of your active profile with your logins. |
| Browser Use cloud | Cloud | It is managed Chromium with stealth, residential proxies, CAPTCHA solving and saved profiles. |
| Browserbase | Cloud | It is an alternative cloud provider with anti-bot tooling. |
| Firecrawl | Cloud | It offers cloud browsers with built-in scraping. |
| Camofox | Your machine, in Docker | It is a self-hosted Firefox-based browser for anti-detection browsing. |
| Lightpanda | Your machine | It is a lightweight headless engine with no graphical renderer. |
| Nous subscription | Cloud | Paid Nous Portal subscribers get cloud browsing through the Tool Gateway. |
The docs note that a provider key only supplies credentials, and the active provider is the one selected in the tools menu.
The connect command is terminal-only, so it does nothing if you type it into Telegram or a web chat.
Since Chrome 136, the debug port is ignored on your default profile, so the docs tell you to start Chrome with a dedicated profile folder.
I rank these options in my best browser for Hermes list, so I won't pick a winner on this page.
Logged-in sessions and cookies
The default local browser is a clean throwaway profile, so the agent is logged into nothing.
Real profile browsing is the setting browser.use_real_profile, and it is off by default.
When it is on, Hermes copies your active browser profile into a managed snapshot and launches your real browser on that copy.
The docs say your live profile is never opened directly.
It supports Chrome, Edge, Brave and Chromium, and it stops with a clear message if your default browser is Firefox.
You should quit your browser before starting one of these sessions, because a running browser usually locks the login databases.
The credential vault is the other route.
It asks you for a login in a masked prompt the first time, encrypts it on your machine and fills it on later visits.
The docs say the model never sees the password.
Approvals and safety
The docs describe real profile browsing as a consent-gated convenience and not an isolation boundary.
- A saved password is only filled when the page origin exactly matches the saved origin.
- The website blocklist blocks listed domains across web search, web extract and browser navigation.
- Private and internal addresses are blocked on cloud backends and handled by a local browser instead.
- The
browser.restrict_evaluatesetting adds a denylist over sensitive JavaScript such as cookies and storage. - Hermes never closes your browser to free a locked profile without asking you first.
The docs also admit that once a password is typed into a site, that site has it.
What the Hermes Agent browser costs
Hermes Agent and its browser toolset are free.
Local browsing costs nothing beyond your model tokens.
The docs say cloud sessions consume provider credits, so Browser Use, Browserbase and Firecrawl bill on their own plans.
The Tool Gateway route needs a paid Nous Portal subscription.
The cost that surprises people is tokens, because every snapshot is text the model has to read, and that is where model choice starts to matter.
Limits, CAPTCHAs and bot detection
- The browser works from the text snapshot and not from pixel coordinates.
- A snapshot over 15,000 characters is truncated, and the full version is saved to a file the agent can read.
- The docs state that the browser cannot download files.
- Cloud sessions expire based on your provider's plan.
- Idle sessions close after 120 seconds by default.
- Lightpanda has no graphical renderer, so screenshots aren't available on that engine in the default mode.
The docs say Browser Use cloud includes CAPTCHA solving, and Browserbase lists it under basic stealth.
Headed mode keeps a visible window open so you can solve a challenge by hand.
Nothing in the docs promises that every site will accept an automated visitor.
Troubleshooting the Hermes Agent browser
| What you see | What it usually means | The fix from the docs |
|---|---|---|
| Connection refused on the connect command | Chrome ignored the debug flag on your default profile. | Start Chrome with a dedicated --user-data-dir folder. |
| The connect command does nothing in a chat app | The command is terminal-only. | Run it inside hermes in the terminal. |
| Real profile opens signed out | Your browser was running and held the login databases. | Quit the browser fully and retry. |
| A missing key error | The selected provider has no credentials. | Run hermes tools and select a provider again. |
| No browser tools appear | The local browser didn't install. | Run hermes pm install agent-browser. |
A real example from my own setup
I use a Hermes skill for a daily AI news scan, and I published it in my Hermes AI skills guide.
The skill tries web search first and web extract second.
If both come back empty, it calls browser_navigate and then browser_snapshot with the full option on.
My note in that skill says the web tools returned nothing in March 2026 and the browser returned the full pages every time.
The same skill records that Product Hunt showed a bot check, and my instruction to the agent was to skip that site.
The video at the top of this page covers Hermes Computer Use, which controls desktop apps in the background.
The Hermes docs say browser work goes through the browser toolset and not through Computer Use, so treat that video as the neighbouring feature.
Does the Hermes Agent browser come with its own model?
No, it doesn't, because Hermes Agent is the body and you plug in the brain.
Every browser tool is called by whichever model you've connected.
The same snapshot can lead to a sensible click under one model and a wasted loop under another.
I use GoldieBench to shortlist that brain, and I want to be straight about what the board measures.
GoldieBench gives each model the same one-shot prompt to build a game, a page, a simulation or a visual, then scores the rendered result from 0 to 10.
It has no browsing test, so none of these numbers is a browser score.
I still use it as a guide, because a model that holds a hard build together in one shot tends to hold a long chain of clicks together too.
Which models I'd put behind the Hermes Agent browser
| Model | Live GoldieBench average | Context on its model page | How I'd use it with the browser |
|---|---|---|---|
| Claude Opus 5 | 8.27 | 1M tokens | It's my pick for long logged-in jobs with many decisions in a row. |
| GPT-5.6 Sol | 8.16 | 1.05M tokens | It's a frontier alternative for the same multi-step work. |
| MiniMax M3 | 7.97 | 1M tokens | It's the value pick for scheduled page checks that run every day. |
| Kimi K3 | 7.89 | 1M tokens | It's a strong everyday brain for research across many pages. |
| GLM-5.2 | 7.77 | 1M tokens | It's an open-weights option with room for long snapshots. |
| Gemini 3.6 Flash | 7.08 | 1M tokens | It's a lower-cost option for light read-only browsing. |
| Qwable 5 27B Coder | 7.14 | 256K tokens | It's a free local brain from the local board for private pages. |
Every average matched the live model page when I checked on 12 October 2026.
How I match a model to a browser job
Browsing is token-heavy, because each step adds another snapshot to the conversation.
A large context window helps, which is why I listed the context next to each score.
Read-only jobs, such as pulling a headline from a dynamic page, work fine on a cheaper model.
Scheduled checks run many times, so I'd send those to a low-cost brain such as MiniMax M3.
Logged-in jobs carry more risk per click, so I'd move those up to Claude Opus 5 or GPT-5.6 Sol.
The browser_vision tool analyses screenshots with vision AI, so check that your setup has a vision-capable model available before you rely on it.
Private pages can go to a local model through Ollama, and I'd keep those jobs short because a smaller brain feels every extra snapshot.
A quick test before you trust a model with the browser
I'd run the same routine with any new brain.
First, I'd pick three read-only pages and ask for one fact from each.
Second, I'd give it one form on a test page and watch whether it snapshots before it clicks.
Third, I'd count how many tool calls it needed.
Fourth, I'd swap to a cheaper model and repeat the same jobs.
If the cheaper model finishes cleanly, I'd leave the browser there and save the money.
For the wider ranking, read my post on the best LLMs for Hermes Agent, and for the other tools read the best Hermes Agent tools.
Also On Our Network
- Agent Operatorsevery command for the Hermes Agent browser, step by step
- AI Income Deskseven business jobs for the Hermes Agent browser
- AI Tool Verdictevery Hermes Agent browser feature explained and scored
- agentos.guidethe Hermes Agent browser quick-start inside an Agent OS
- agentos.guideJulian's Hermes AI skills guide, with the news-scan skill that uses the browser
Start on the free local browser, pick a brain you've tested on real pages, and you'll get dependable work out of the Hermes Agent browser.
FAQ
What is the Hermes Agent browser?
The Hermes Agent browser is the browser automation toolset built into Hermes Agent from Nous Research. It lets the agent open pages, read them as text snapshots, click, type, scroll and take screenshots.
How do I enable the Hermes Agent browser?
Run hermes tools list to check it, then run hermes tools enable browser if it shows as disabled. Run hermes tools and open Browser Automation to choose where the browser runs.
Which browsers does Hermes Agent support?
The official docs list a local packaged Chromium, your own Chrome, Brave, Chromium or Edge over CDP, real profile browsing, Browser Use cloud, Browserbase, Firecrawl, Camofox and Lightpanda. Paid Nous Portal subscribers can also use the Tool Gateway.
Does the Hermes Agent browser come with its own model?
No. Hermes Agent runs on whichever model you connect, and that model decides which browser tool to call. Julian shortlists the model using GoldieBench scores and then tests it on real pages.
Which model is best for the Hermes Agent browser?
GoldieBench has no browsing test, so there is no measured answer. As a guide, Julian would use Claude Opus 5, which averages 8.27, for long logged-in jobs and MiniMax M3 at 7.97 for cheap scheduled checks.
Does the Hermes Agent browser need a vision model?
Most browsing works from text snapshots, so clicking and typing don't need vision. The browser_vision tool analyses screenshots with vision AI when a page needs a visual check.
What can't the Hermes Agent browser do?
The docs say it cannot download files, long snapshots are truncated at 15,000 characters and cloud sessions cost provider credits. Some sites will also block automated browsers.


