# browser_exec Tool

> The Hermes tool that drives a real web browser to click, type and read pages.

**Field:** Artificial Intelligence  
**Category:** Hermes Agent  
**Also known as:** Hermes browser, Hermes browser automation, browser_exec

## Think of it like

It is like a helper who clicks the buttons for you.

## Definition

browser_exec is the Hermes tool that drives a real web browser. The model writes a short Python script, and the tool runs it against the browser. That lets it open pages, click, type, fill in forms and take screenshots. By default Hermes starts its own hidden Chromium, one per session. It can also use a cloud browser or join your own Chrome.

## Example

Lucy asks Hermes to book a table on a site with no API. It opens the page with browser_exec, picks the time and fills in her name.

## Example code

```console
/browser connect
```

Join the Chrome you already have open, with your own tabs.

## Why it matters

Many sites only work with a mouse and a keyboard. A browser tool reaches the parts of the web an API does not.

## Common mistake

Using it to read a plain page. web_search and web_extract are faster and cheaper for that.

## Three principles

- **Runs a script.** The model writes Python for the page.
- **Hidden by default.** Its own Chromium, one per session.
- **For doing, not reading.** Click, type and fill forms.

## Related terms

- [web_search Tool](https://learn.benibix.com/term/ai/hermes-web-search-tool)
- [Hermes Toolset](https://learn.benibix.com/term/ai/hermes-toolset)
- [Computer Use](https://learn.benibix.com/term/ai/computer-use)
- [Browser Automation](https://learn.benibix.com/term/development/browser-automation)
- [Headless Browser](https://learn.benibix.com/term/development/headless-browser)

## Told apart from

- [web_search vs browser_exec](https://learn.benibix.com/compare/hermes-web-search-tool-vs-hermes-browser-tool): People think Hermes needs a browser to read the web. It does not. web_search finds pages, and web_extract pulls out their text, fast and cheap. browser_exec starts a real browser that clicks, types and fills forms. Use the web tools to read. Use the browser only when the page needs a hand on the mouse.

![The agent asks to use a tool. A shell command first passes an approval gate with three modes, smart, manual and off. Web tools sit beside it: web_search and web_extract for reading, browser_exec for clicking and typing on a real page.](https://learn.benibix.com/diagrams/ai8-hermes-tool-check.svg)

---

Source: https://learn.benibix.com/term/ai/hermes-browser-tool
Author: Behnia Zarei (a developer in Vienna, Austria, who builds and teaches data, AI and business intelligence at BENIBIX)
Publisher: BENIBIX Learn (https://learn.benibix.com/)
Last updated: 2026-11-17
Licence: CC BY 4.0 (https://creativecommons.org/licenses/by/4.0/). Quote freely with attribution.
