> For the complete documentation index, see [llms.txt](https://unsloth.ai/docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://unsloth.ai/docs/de/grundlagen/browser-use.md).

# Browser-Nutzung mit lokalen LLMs

Verwenden Sie lokale Modelle, um Websites zu navigieren und Aufgaben im integrierten Browser auszuführen.

Browser Use ermöglicht es lokalen LLMs, Websites zu navigieren und Aufgaben für dich zu erledigen, in einem Browser, den du neben deinem Chat beobachten kannst. In der Open-Source- [Unsloth Desktop](https://unsloth.ai/docs/de/desktop.md) -App für macOS, Windows und Linux kann jedes Modell mit Tool-Aufrufen Seiten öffnen, Buttons anklicken, Formulare ausfüllen und Dokumente wie PDFs lesen, während Vision-Modelle außerdem Screenshots überprüfen können.

{% columns %}
{% column %}
&#x20;Diese Anleitung zeigt, wie du Browser Use mit lokalen Modellen einrichtest und ihnen Webaufgaben gibst.

Unsloth bittet vor Anmeldungen, Formularübermittlungen, Käufen oder Downloads um deine Zustimmung, und du kannst Berechtigungen für jede Website festlegen. Du kannst es auch mit jedem Cloud- oder API-Modell verbinden.
{% endcolumn %}

{% column %}

<figure><img src="https://797013937-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FxhOjnexMCB3dmuQFQ2Zq%2Fuploads%2FHg3Knjk1GznF8V6R39wk%2Ffour_grid_2x2.gif?alt=media&amp;token=008f7dab-7e91-43cb-a7bd-a8e3bfec29d5" alt=""><figcaption><p>Qwen3.8-27B erledigt 4 verschiedene Browser-Aufgaben</p></figcaption></figure>
{% endcolumn %}
{% endcolumns %}

### ⚡ Schnellstart

Installiere Unsloth Desktop, um ein lokales Modell auszuführen und es Websites neben deinem Chat durchsuchen zu lassen.

{% stepper %}
{% step %}

#### Unsloth herunterladen

Der einfachste Einstieg ist die Installation der Unsloth-Desktop-App. Sie unterstützt [macOS](https://unsloth.ai/docs/de/loslegen/install/mac.md), Linux, [Windows](https://unsloth.ai/docs/de/loslegen/install/windows-installation.md), [NVIDIA](https://unsloth.ai/docs/de/loslegen/install/pip-install.md), [AMD](https://unsloth.ai/docs/de/loslegen/install/amd.md), Intel- und CPU-Setups.

<a href="https://unsloth.ai/download" class="button primary" data-icon="down-to-bracket">Unsloth herunterladen</a>

* <i class="fa-apple">:apple:</i> [Für macOS herunterladen](https://unsloth.ai/download/mac)
* <i class="fa-windows">:windows:</i> [Für Windows herunterladen](https://unsloth.ai/download/windows)
* <i class="fa-linux">:linux:</i> [Für Linux herunterladen](https://unsloth.ai/download/linux)

Oder, wenn du die manuelle Installation bevorzugst:

{% tabs %}
{% tab title="Native-Installation" %}
**MacOS, Linux, WSL:**

```bash
curl -fsSL https://unsloth.ai/install.sh | sh
```

**Windows:**

```powershell
irm https://unsloth.ai/install.ps1 | iex
```

{% endtab %}

{% tab title="Docker" %}
Das [Unsloth-Docker-Image](https://hub.docker.com/r/unsloth/unsloth) `unsloth/unsloth` ist auf Docker verfügbar. [Anleitung lesen.](https://unsloth.ai/docs/get-started/install/docker)
{% endtab %}

{% tab title="Homebrew" %}
Unsloth Desktop installieren:

{% code collapsedlinecount="10" %}

```bash
brew install --cask unsloth
```

{% endcode %}

Unsloth Desktop aktualisieren:

```bash
brew upgrade --cask unsloth
```

{% endtab %}

{% tab title="WinGet" %}
Unsloth Desktop installieren:

```powershell
winget install --id UnslothAI.Unsloth -e
```

Unsloth Desktop aktualisieren:

```powershell
winget upgrade --id UnslothAI.Unsloth -e
```

{% endtab %}
{% endtabs %}
{% endstep %}

{% step %}

#### Installieren

1. Öffne das Unsloth-Installationsprogramm (`.dmg`, `.exe` -Dateien)
2. Ziehe Unsloth auf dem Mac in den Ordner „Programme“ oder schließe die Einrichtung unter Windows ab.
3. Starte die App und warte, bis die Installation abgeschlossen ist
   {% endstep %}

{% step %}

#### Wähle ein Modell

Öffne den Model Hub oder das Dropdown-Menü „Modell auswählen“. Wähle ein Modell, das Tool-Aufrufe unterstützt, sowie eine Quantisierung, die zu deinem Gerät passt, und lade es dann herunter und lade es.

<figure><img src="https://797013937-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FxhOjnexMCB3dmuQFQ2Zq%2Fuploads%2FNCEVgKLJI0goPqjgcg9B%2Fmodel%20hub%20models.png?alt=media&amp;token=533b5e3c-a901-4b33-963e-4a703cc9d5a6" alt="" width="563"><figcaption></figcaption></figure>
{% endstep %}

{% step %}

#### Mit dem Surfen beginnen

Öffne das **+** Menü neben der Chat-Eingabe und aktiviere **Browser Use**. Probiere diesen Prompt aus:

```
Öffne https://kenney.nl/assets und finde drei Asset-Pakete
für ein kleines Pirateninsel-Spiel: Umgebungen, Charaktere
und UI.

Öffne die Seite jedes Pakets. Teile den Namen, den Link und eine kurze
Erklärung mit, wie wir es verwenden könnten. Prüfe die angegebene
Lizenz. Lade nichts herunter.
```

<figure><img src="https://797013937-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FxhOjnexMCB3dmuQFQ2Zq%2Fuploads%2FQXmNUrzvl9pRbNBbbEWI%2FUI%20pack%20adventure.gif?alt=media&amp;token=76426c04-5aeb-4c4b-a158-bdccc26fc5b3" alt="" width="563"><figcaption></figcaption></figure>
{% endstep %}
{% endstepper %}

### Mit deinem Modell browsen

Gib deinem Modell eine Website und eine Aufgabe. Es kann Seiten lesen, Links folgen und mit Buttons, Formularen und anderen Steuerelementen interagieren. Für eine klarere Navigation beziehe dich auf sichtbare Beschriftungen: „Öffne Preise und wähle dann jährliche Abrechnung aus.“

**Anmerkungen** ermöglichen es dir, nach bestimmten Teilen einer Seite zu fragen. Wähle **Änderungen anfordern**, markiere den Inhalt und füge eine Frage oder Anweisung hinzu. Die Auswahl wird im Chat an das Modell gesendet.

#### Setze deine Aufgabe fort

Du kannst im selben Chat Rückfragen stellen. Nachdem du die Asset-Pakete gefunden hast, probiere Folgendes aus:

```
Welche dieser Pakete würden sich am besten für ein Top-down-Spiel eignen?
Vergleiche ihre Stile und schlage vor, was wir sonst noch brauchen könnten.
```

<div data-with-frame="true"><figure><img src="https://797013937-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FxhOjnexMCB3dmuQFQ2Zq%2Fuploads%2Fj0521NE4P44p74DzHTGJ%2Fimage.png?alt=media&amp;token=2f58f4e8-5e9b-4f11-a988-01f6ad913470" alt="" width="563"><figcaption></figcaption></figure></div>

Es hilft, genau zu sagen, was geprüft werden soll. Du kannst das Modell bitten, Optionen zu vergleichen, Details auf einer anderen Seite zu prüfen oder zu erklären, wie es zu seiner Antwort gekommen ist.

#### Mit visuellen Inhalten arbeiten

Modelle mit Vision-Unterstützung können Screenshots von Bildern, Diagrammen und anderen Inhalten prüfen, die der Seitentext nicht erfasst. Modelle ohne Vision können weiterhin Seitentext, Links und Steuerelemente verwenden, können die Bilder selbst jedoch nicht prüfen.

Bitte das Modell, die Inhalte zu öffnen oder zu vergrößern, die es prüfen soll. Zum Beispiel:

```
Kannst du dich durch die Kenney-Assets navigieren und einen Screenshot teilen
der vergrößerten Vorschaubildes auf der Pirate-Kit-Seite?
```

Das Modell kann zur Seite des Pakets navigieren, dessen Vorschau öffnen und einen Screenshot erstellen. Erweitere den `browser_screenshot` -Toolaufruf, um das genaue Bild zu sehen, das es erfasst hat.&#x20;

<div data-with-frame="true"><figure><img src="https://797013937-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FxhOjnexMCB3dmuQFQ2Zq%2Fuploads%2FA2D4w7KXmfWBzHzqCneJ%2Fimage.png?alt=media&amp;token=c3e9f395-7d9b-41f6-ab8a-e0b6fd868ea9" alt="" width="563"><figcaption></figcaption></figure></div>

Danach kannst du Folgefragen zum Bild stellen oder eine genauere Ansicht eines bestimmten Bereichs anfordern.

### Den Browser steuern

Beobachte, wie das Modell neben deinem Chat arbeitet. Wenn du einen Schritt selbst erledigen musst, wähle **Stopp**, erledige ihn im Browser und bitte das Modell, fortzufahren.

Um Browser Use zu deaktivieren, klicke auf den **Browser** -Indikator neben der Chat-Eingabe.

#### Aktionen genehmigen

Wenn eine Genehmigung erforderlich ist, zeigt der Browser eine Anfrage mit **Zulassen** und **Ablehnen** -Schaltflächen an.

Standardmäßig fragt Unsloth vor dem Absenden von Formularen, dem Anmelden oder dem Ausführen von Aktionen wie Senden, Kaufen oder Löschen nach. Es kann auch vor dem Öffnen einer neuen Website fragen.

Gib Passwörter und Zahlungsdaten selbst ein. Die Standard-Browser-Tools können diese Felder nicht ausfüllen oder Dateien hochladen.

#### Website-Berechtigungen festlegen

Öffne die Einstellungen und wähle **Browser**. Unter **Agentenberechtigungen**, wähle Standardeinstellungen oder füge Ausnahmen für einzelne Websites hinzu.

| Einstellung              | Was sie steuert                                                                          |
| ------------------------ | ---------------------------------------------------------------------------------------- |
| Browsen                  | Welche Websites das Modell besuchen kann.                                                |
| Aktionen                 | Genehmigung für Anmeldungen, Formularübermittlungen und Aktionen wie Senden oder Kaufen. |
| Downloads                | Ob Downloads erlaubt sind, eine Genehmigung benötigen oder blockiert werden.             |
| Klicks ohne Beschriftung | Klicks und Ziehen auf Bereichen ohne benannte Steuerung, etwa auf einer Leinwand.        |

#### Verlauf und Textausschnitte auswählen

Du kannst festlegen, ob das Modell deinen Unsloth-Browserverlauf lesen darf. Stelle es auf zuerst fragen, immer erlauben oder nie erlauben.

Skripte benötigen jedes Mal eine Genehmigung. Du siehst das Skript, bevor es ausgeführt wird. Um sie zu deaktivieren, setze **Skripte ausführen** auf **Nie**.

Voller Zugriff überspringt mehrere Genehmigungsaufforderungen, einschließlich Anfragen zum Verlauf, sofern der Verlaufszugriff nicht auf **Nie**gesetzt ist. Blockierte Websites und Downloads bleiben blockiert, und Skripte benötigen weiterhin eine Genehmigung.

### <i class="fa-file">:file:</i> Mit Dateien neben deinem Chat arbeiten

Du kannst das Browser-Panel auch verwenden, um PDFs, Office-Dokumente, HTML- und Textdateien zu bearbeiten und zu durchsuchen.

Öffne die Einstellungen, wähle **Browser** und aktiviere **Dateien im Browser öffnen**. Klicke auf einen unterstützten Anhang, um ihn neben deiner Unterhaltung zu öffnen.

Um nach einem bestimmten Abschnitt zu fragen oder eine Änderung vorzuschlagen, wähle **Änderungen anfordern**, markiere den Abschnitt und teile deinem Modell mit, was es tun soll. Deine Anfrage wird im Chat an das Modell gesendet.

<div data-with-frame="true"><figure><img src="https://797013937-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FxhOjnexMCB3dmuQFQ2Zq%2Fuploads%2FkjknhKM8DGLjafiEwfHS%2Fimage.png?alt=media&amp;token=f6fd67d0-490e-46e8-b52a-3503b395c90a" alt="" width="563"><figcaption></figcaption></figure></div>

Während du liest, bitte dein Modell, die Datei zusammenzufassen, einen Abschnitt zu erklären oder ein Detail zu finden. Um nach einem bestimmten Abschnitt zu fragen oder eine Bearbeitung vorzuschlagen, wähle **Änderungen anfordern** und markiere den gemeinten Text.

Die kompatiblen Dateitypen sind wie folgt:&#x20;

| Dateityp              | Erweiterung |
| --------------------- | ----------- |
| PDF                   | `.pdf`      |
| Word-Dokumente        | `.docx`     |
| Tabellenkalkulationen | `.xlsx`     |
| Präsentationen        | `.pptx`     |
| Markdown              | `.md`       |
| HTML                  | `.html`     |
| Klartext              | `.txt`      |

**Fehlerbehebung**

<details>

<summary>Browser Use ist nicht verfügbar</summary>

Wähle ein Modell, das Tool-Aufrufe unterstützt, und öffne die normale Chat-Ansicht. Browser Use ist in mobilen oder Vergleichsansichten nicht verfügbar. Aktiviere **Browser Use** im **+** Menü neben der Chat-Eingabe.

</details>

<details>

<summary>Das Modell beschreibt Aktionen, ohne sie auszuführen</summary>

Prüfe, ob **Browser Use** aktiviert ist. Versuche, nach einer konkreten Aktion zu fragen, zum Beispiel: „Öffne diese URL und lies den Seitentitel.“ Die Zuverlässigkeit von Tool-Aufrufen kann je nach Modell variieren.

</details>

<details>

<summary>Eine Website oder ein Teil einer Seite funktioniert nicht</summary>

Einige Websites und eingebettete Inhalte funktionieren möglicherweise nicht mit den Browser-Tools. Wenn das Modell ein Steuerelement nicht findet, beschreibe dessen sichtbare Beschriftung oder Position. Für visuelle Inhalte probiere ein Modell mit Vision-Fähigkeit.

Du kannst auch **Stopp**auswählen, den Schritt wenn möglich manuell abschließen und dann das Modell bitten, fortzufahren.

</details>

<details>

<summary>Eine Aktion wartet auf Genehmigung</summary>

Prüfe das Browser-Panel auf eine Genehmigungsanfrage und wähle **Zulassen** oder **Ablehnen**. Wenn die Anfrage abgelaufen ist, bitte das Modell, es erneut zu versuchen, wenn du bereit bist, sie zu prüfen.

</details>

<details>

<summary>Eine lokale Seite lässt sich nicht öffnen</summary>

Browser Use unterstützt öffentliche HTTP- und HTTPS-Websites. Localhost-, private Netzwerkadressen und `file://` -URLs werden nicht als Navigationsziele unterstützt. Um einen unterstützten Anhang anzuzeigen, aktiviere **Dateien im Browser öffnen** unter **Einstellungen → Browser**, dann klicke auf den Anhang.

</details>

<details>

<summary>Das Modell kann nicht auf einen anderen Browser-Tab zugreifen</summary>

Das Modell arbeitet in seinem eigenen Unsloth-Browser-Tab. Es kann keine Tabs in Chrome, Firefox oder anderen Browsern steuern. Kopiere die URL der Seite in den Chat und bitte das Modell, sie in Unsloth zu öffnen.

</details>


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://unsloth.ai/docs/de/grundlagen/browser-use.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
