docs: clarify numbered paths and simplify README demo copy

This commit is contained in:
MagMueller
2026-09-09 12:15:38 -07:00
parent fcc4f01964
commit 674b0dfce2
4 changed files with 41 additions and 46 deletions
+4 -3
View File
@@ -8,9 +8,10 @@ introduced in [SDK PR #241](https://github.com/browser-use/sdk/pull/241).
The README version shows three paths:
- Fully hosted cloud: OpenCode → Browser Use CLI → cloud browser.
- CLI: your existing agent → Browser Use CLI → local or cloud browser.
- Python library: your code → Browser Use agent → local or cloud browser.
- Path 1, fully hosted cloud: OpenCode → Browser Use CLI → cloud browser.
- Path 2, CLI: your existing agent → Browser Use CLI → local or cloud browser.
- Path 3, Python library: the open source Browser Use agent → local or cloud browser.
The agent and its Python library are one block, with no CLI step.
Keep the light and dark SVGs structurally identical when changing the diagram.
The SDK source remains the reference for the hosted stack; this README adds the
+8 -10
View File
@@ -1,6 +1,6 @@
<svg xmlns="http://www.w3.org/2000/svg" width="1440" height="690" viewBox="0 0 1440 690" role="img" aria-labelledby="title desc">
<title id="title">Three ways to use Browser Use</title>
<desc id="desc">Fully hosted cloud runs our OpenCode agent, Browser Use CLI, and a cloud browser through the V4 API. The CLI connects your existing agent, including Claude Code, Codex, OpenCode, Hermes, or Pi, to a local or cloud browser. The Python library runs the Browser Use agent directly, without the CLI, and also connects to a local or cloud browser.</desc>
<desc id="desc">Path 1: fully hosted cloud runs our OpenCode agent, Browser Use CLI, and a cloud browser through the V4 API. Path 2: the CLI connects your existing agent, including Claude Code, Codex, OpenCode, Hermes, or Pi, to a local or cloud browser. Path 3: the open source Browser Use agent is a Python library that connects directly to a local or cloud browser.</desc>
<defs>
<marker id="arrow" markerWidth="8" markerHeight="8" refX="7" refY="4" orient="auto"><path d="M0 0L8 4L0 8Z" fill="#92929C"/></marker>
<marker id="cloud-arrow" markerWidth="8" markerHeight="8" refX="7" refY="4" orient="auto"><path d="M0 0L8 4L0 8Z" fill="#FFAB66"/></marker>
@@ -12,9 +12,9 @@
<text x="240" y="55" text-anchor="middle" fill="#FFAB66" font-size="18" font-weight="700">RUN BY BROWSER USE</text>
<text x="956" y="55" text-anchor="middle" fill="#BDBDC5" font-size="18" font-weight="700">ON YOUR COMPUTER</text>
<path d="M956 85V650" stroke="#92929C" stroke-opacity="0.35"/>
<text x="240" y="109" text-anchor="middle" fill="#FAFAFA" font-size="32" font-weight="750">Fully hosted cloud</text>
<text x="720" y="109" text-anchor="middle" fill="#FAFAFA" font-size="32" font-weight="750">CLI</text>
<text x="1192" y="109" text-anchor="middle" fill="#FAFAFA" font-size="32" font-weight="750">Python library</text>
<text x="240" y="109" text-anchor="middle" fill="#FAFAFA" font-size="30" font-weight="750">1. Fully hosted cloud</text>
<text x="720" y="109" text-anchor="middle" fill="#FAFAFA" font-size="30" font-weight="750">2. CLI</text>
<text x="1192" y="109" text-anchor="middle" fill="#FAFAFA" font-size="30" font-weight="750">3. Python library</text>
<text x="240" y="140" text-anchor="middle" fill="#BDBDC5" font-size="20" font-weight="450">Send a task through the API</text>
<text x="720" y="140" text-anchor="middle" fill="#BDBDC5" font-size="20" font-weight="450">Use your existing agent</text>
<text x="1192" y="140" text-anchor="middle" fill="#BDBDC5" font-size="20" font-weight="450">Run your own automation</text>
@@ -25,18 +25,16 @@
<text x="720" y="214" text-anchor="middle" fill="#BDBDC5" font-size="18" font-weight="700">YOUR AGENT</text>
<text x="720" y="247" text-anchor="middle" fill="#FAFAFA" font-size="24" font-weight="600">Claude Code · Codex</text>
<text x="720" y="278" text-anchor="middle" fill="#FAFAFA" font-size="24" font-weight="600">OpenCode · Hermes · Pi</text>
<rect x="992" y="184" width="400" height="112" rx="16" fill="#29292E" stroke="#92929C" stroke-width="2"/>
<text x="1192" y="219" text-anchor="middle" fill="#BDBDC5" font-size="18" font-weight="700">YOUR CODE</text>
<text x="1192" y="260" text-anchor="middle" fill="#FAFAFA" font-size="29" font-weight="750">Python library</text>
<rect x="992" y="184" width="400" height="244" rx="16" fill="#302419" stroke="#FFAB66" stroke-width="2"/>
<text x="1192" y="262" text-anchor="middle" fill="#FFAB66" font-size="20" font-weight="700">OPEN SOURCE</text>
<text x="1192" y="313" text-anchor="middle" fill="#FAFAFA" font-size="31" font-weight="750">Browser Use Agent</text>
<text x="1192" y="355" text-anchor="middle" fill="#BDBDC5" font-size="24" font-weight="450">Python library</text>
<path d="M240 296V336" fill="none" stroke="#92929C" stroke-width="2.5" stroke-linejoin="round" marker-end="url(#arrow)"/>
<path d="M720 296V336" fill="none" stroke="#92929C" stroke-width="2.5" stroke-linejoin="round" marker-end="url(#arrow)"/>
<path d="M1192 296V336" fill="none" stroke="#92929C" stroke-width="2.5" stroke-linejoin="round" marker-end="url(#arrow)"/>
<rect x="64" y="350" width="352" height="78" rx="16" fill="#302419" stroke="#FFAB66" stroke-width="2"/>
<text x="240.0" y="397" text-anchor="middle" fill="#FAFAFA" font-size="28" font-weight="750">Browser Use CLI</text>
<rect x="520" y="350" width="400" height="78" rx="16" fill="#302419" stroke="#FFAB66" stroke-width="2"/>
<text x="720.0" y="397" text-anchor="middle" fill="#FAFAFA" font-size="28" font-weight="750">Browser Use CLI</text>
<rect x="992" y="350" width="400" height="78" rx="16" fill="#302419" stroke="#FFAB66" stroke-width="2"/>
<text x="1192.0" y="397" text-anchor="middle" fill="#FAFAFA" font-size="28" font-weight="750">Browser Use agent</text>
<path d="M240 428V498" fill="none" stroke="#FFAB66" stroke-width="2.5" stroke-linejoin="round" marker-end="url(#cloud-arrow)"/>
<rect x="64" y="512" width="352" height="112" rx="16" fill="#302419" stroke="#FFAB66" stroke-width="2"/>
<path d="M64 538H416" stroke="#FFAB66" stroke-width="2"/>

Before

Width:  |  Height:  |  Size: 8.4 KiB

After

Width:  |  Height:  |  Size: 8.2 KiB

+8 -10
View File
@@ -1,6 +1,6 @@
<svg xmlns="http://www.w3.org/2000/svg" width="1440" height="690" viewBox="0 0 1440 690" role="img" aria-labelledby="title desc">
<title id="title">Three ways to use Browser Use</title>
<desc id="desc">Fully hosted cloud runs our OpenCode agent, Browser Use CLI, and a cloud browser through the V4 API. The CLI connects your existing agent, including Claude Code, Codex, OpenCode, Hermes, or Pi, to a local or cloud browser. The Python library runs the Browser Use agent directly, without the CLI, and also connects to a local or cloud browser.</desc>
<desc id="desc">Path 1: fully hosted cloud runs our OpenCode agent, Browser Use CLI, and a cloud browser through the V4 API. Path 2: the CLI connects your existing agent, including Claude Code, Codex, OpenCode, Hermes, or Pi, to a local or cloud browser. Path 3: the open source Browser Use agent is a Python library that connects directly to a local or cloud browser.</desc>
<defs>
<marker id="arrow" markerWidth="8" markerHeight="8" refX="7" refY="4" orient="auto"><path d="M0 0L8 4L0 8Z" fill="#8B8B94"/></marker>
<marker id="cloud-arrow" markerWidth="8" markerHeight="8" refX="7" refY="4" orient="auto"><path d="M0 0L8 4L0 8Z" fill="#C94D00"/></marker>
@@ -12,9 +12,9 @@
<text x="240" y="55" text-anchor="middle" fill="#C94D00" font-size="18" font-weight="700">RUN BY BROWSER USE</text>
<text x="956" y="55" text-anchor="middle" fill="#606068" font-size="18" font-weight="700">ON YOUR COMPUTER</text>
<path d="M956 85V650" stroke="#8B8B94" stroke-opacity="0.35"/>
<text x="240" y="109" text-anchor="middle" fill="#242428" font-size="32" font-weight="750">Fully hosted cloud</text>
<text x="720" y="109" text-anchor="middle" fill="#242428" font-size="32" font-weight="750">CLI</text>
<text x="1192" y="109" text-anchor="middle" fill="#242428" font-size="32" font-weight="750">Python library</text>
<text x="240" y="109" text-anchor="middle" fill="#242428" font-size="30" font-weight="750">1. Fully hosted cloud</text>
<text x="720" y="109" text-anchor="middle" fill="#242428" font-size="30" font-weight="750">2. CLI</text>
<text x="1192" y="109" text-anchor="middle" fill="#242428" font-size="30" font-weight="750">3. Python library</text>
<text x="240" y="140" text-anchor="middle" fill="#606068" font-size="20" font-weight="450">Send a task through the API</text>
<text x="720" y="140" text-anchor="middle" fill="#606068" font-size="20" font-weight="450">Use your existing agent</text>
<text x="1192" y="140" text-anchor="middle" fill="#606068" font-size="20" font-weight="450">Run your own automation</text>
@@ -25,18 +25,16 @@
<text x="720" y="214" text-anchor="middle" fill="#606068" font-size="18" font-weight="700">YOUR AGENT</text>
<text x="720" y="247" text-anchor="middle" fill="#242428" font-size="24" font-weight="600">Claude Code · Codex</text>
<text x="720" y="278" text-anchor="middle" fill="#242428" font-size="24" font-weight="600">OpenCode · Hermes · Pi</text>
<rect x="992" y="184" width="400" height="112" rx="16" fill="#F4F4F5" stroke="#8B8B94" stroke-width="2"/>
<text x="1192" y="219" text-anchor="middle" fill="#606068" font-size="18" font-weight="700">YOUR CODE</text>
<text x="1192" y="260" text-anchor="middle" fill="#242428" font-size="29" font-weight="750">Python library</text>
<rect x="992" y="184" width="400" height="244" rx="16" fill="#FFF4E8" stroke="#C94D00" stroke-width="2"/>
<text x="1192" y="262" text-anchor="middle" fill="#C94D00" font-size="20" font-weight="700">OPEN SOURCE</text>
<text x="1192" y="313" text-anchor="middle" fill="#242428" font-size="31" font-weight="750">Browser Use Agent</text>
<text x="1192" y="355" text-anchor="middle" fill="#606068" font-size="24" font-weight="450">Python library</text>
<path d="M240 296V336" fill="none" stroke="#8B8B94" stroke-width="2.5" stroke-linejoin="round" marker-end="url(#arrow)"/>
<path d="M720 296V336" fill="none" stroke="#8B8B94" stroke-width="2.5" stroke-linejoin="round" marker-end="url(#arrow)"/>
<path d="M1192 296V336" fill="none" stroke="#8B8B94" stroke-width="2.5" stroke-linejoin="round" marker-end="url(#arrow)"/>
<rect x="64" y="350" width="352" height="78" rx="16" fill="#FFF4E8" stroke="#C94D00" stroke-width="2"/>
<text x="240.0" y="397" text-anchor="middle" fill="#242428" font-size="28" font-weight="750">Browser Use CLI</text>
<rect x="520" y="350" width="400" height="78" rx="16" fill="#FFF4E8" stroke="#C94D00" stroke-width="2"/>
<text x="720.0" y="397" text-anchor="middle" fill="#242428" font-size="28" font-weight="750">Browser Use CLI</text>
<rect x="992" y="350" width="400" height="78" rx="16" fill="#FFF4E8" stroke="#C94D00" stroke-width="2"/>
<text x="1192.0" y="397" text-anchor="middle" fill="#242428" font-size="28" font-weight="750">Browser Use agent</text>
<path d="M240 428V498" fill="none" stroke="#C94D00" stroke-width="2.5" stroke-linejoin="round" marker-end="url(#cloud-arrow)"/>
<rect x="64" y="512" width="352" height="112" rx="16" fill="#FFF4E8" stroke="#C94D00" stroke-width="2"/>
<path d="M64 538H416" stroke="#C94D00" stroke-width="2"/>

Before

Width:  |  Height:  |  Size: 8.4 KiB

After

Width:  |  Height:  |  Size: 8.2 KiB