browser-use /

Browser Use

Live map
Snapshotmain · f3298c5

Serialized page state becomes typed actions executed through a managed Chrome session.

Click a building or route
Choose a path

Observe an indexed element, choose it, and execute the click.

System map7 components · 8 connections
130%
browser-use: an observe-decide-act browser loop architectureFollow the loop clockwise from the agent through page observation, the LLM, tools, and back to browser state.active tab and session…DOM snapshot and layou…indexed elements, URL,…task and step messagesaction names and param…click, type, navigate,…protocol commands and …MessagemanagerLLM adapterAgent serviceTool registryBrowsersessionDOM serializerChrome / CDP
Connections
BuildingsEntryServiceComputeStorageRuntimeToolingExternal

Terms, in plain English

CDPChrome DevTools Protocol, the command and event channel used to control Chrome.

How to study this repo

  1. 1
    Inspect perception

    Trace a live page through DOM serialization into the model prompt.

  2. 2
    Follow a click

    Track an element index from model output to the session action.

  3. 3
    Study recovery

    Read session watchdogs and identify how popups or crashes alter the loop.