> 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/fr/notions-de-base/browser-use.md).

# Utilisation du navigateur avec des LLM locaux

Utilisez des modèles locaux pour naviguer sur des sites web et effectuer des tâches dans le navigateur intégré.

Browser use permet aux LLM locaux de naviguer sur des sites web et d’effectuer des tâches à votre place, dans un navigateur que vous pouvez regarder à côté de votre chat. Dans l’open source [Unsloth Desktop](https://unsloth.ai/docs/fr/desktop.md) app pour macOS, Windows et Linux, n’importe quel modèle capable d’appeler des outils peut ouvrir des pages, cliquer sur des boutons, remplir des formulaires et lire des documents comme des PDF, tandis que les modèles de vision peuvent aussi examiner des captures d’écran.

{% columns %}
{% column %}
&#x20;Ce guide montre comment configurer browser use avec des modèles locaux et leur confier des tâches web.

Unsloth demande votre approbation avant les connexions, les envois de formulaires, les achats ou les téléchargements, et vous pouvez définir des autorisations pour chaque site web. Vous pouvez aussi le connecter à n’importe quel modèle cloud ou API.
{% endcolumn %}

{% column %}

<figure><img src="https://550366147-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 en train d’accomplir 4 tâches de navigateur différentes</p></figcaption></figure>
{% endcolumn %}
{% endcolumns %}

### ⚡ Démarrage rapide

Installez Unsloth Desktop pour exécuter un modèle local et lui permettre de parcourir des sites web à côté de votre chat.

{% stepper %}
{% step %}

#### Télécharger Unsloth

La façon la plus simple de commencer est d’installer l’application Unsloth Desktop. Elle prend en charge [macOS](https://unsloth.ai/docs/fr/commencer/install/mac.md), Linux, [Windows](https://unsloth.ai/docs/fr/commencer/install/windows-installation.md), [NVIDIA](https://unsloth.ai/docs/fr/commencer/install/pip-install.md), [AMD](https://unsloth.ai/docs/fr/commencer/install/amd.md), les configurations Intel et CPU.

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

* <i class="fa-apple">:apple:</i> [Télécharger pour macOS](https://unsloth.ai/download/mac)
* <i class="fa-windows">:windows:</i> [Télécharger pour Windows](https://unsloth.ai/download/windows)
* <i class="fa-linux">:linux:</i> [Télécharger pour Linux](https://unsloth.ai/download/linux)

Ou, si vous préférez une installation manuelle :

{% tabs %}
{% tab title="Installation native" %}
**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" %}
Le [L'image Docker Unsloth](https://hub.docker.com/r/unsloth/unsloth) `unsloth/unsloth` est disponible sur Docker. [Lire le guide.](https://unsloth.ai/docs/get-started/install/docker)
{% endtab %}

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

{% code collapsedlinecount="10" %}

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

{% endcode %}

Mettre à jour Unsloth Desktop :

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

{% endtab %}

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

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

Mettre à jour Unsloth Desktop :

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

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

{% step %}

#### Installer

1. Ouvrez l’installateur Unsloth (`.dmg`, `.exe` fichiers)
2. Faites glisser Unsloth vers Applications sur Mac ou terminez l’installation sur Windows.
3. Lancez l’application et attendez la fin de l’installation
   {% endstep %}

{% step %}

#### Choisir un modèle

Ouvrez Model Hub ou le menu déroulant Sélectionner un modèle. Choisissez un modèle qui prend en charge l’appel d’outils et une quantification adaptée à votre appareil, puis téléchargez-le et chargez-le.

<figure><img src="https://550366147-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 %}

#### Commencer à naviguer

Ouvrez le **+** menu à côté de la zone de saisie du chat et activez **Browser use**. Essayez cette invite :

```
Ouvrez https://kenney.nl/assets et trouvez trois packs de ressources
pour un petit jeu d’île de pirates : environnements, personnages
et interface.

Ouvrez la page de chaque pack. Indiquez son nom, son lien et une courte
explication de la manière dont nous pourrions l’utiliser. Vérifiez la
licence indiquée. Ne téléchargez rien.
```

<figure><img src="https://550366147-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 %}

### Naviguer avec votre modèle

Donnez à votre modèle un site web et une tâche. Il peut lire des pages, suivre des liens et interagir avec des boutons, des formulaires et d’autres contrôles. Pour une navigation plus claire, référez-vous aux libellés visibles : « Ouvrez Tarifs, puis sélectionnez Facturation annuelle. »

**Annotations** vous permettent de poser des questions sur des parties spécifiques d’une page. Sélectionnez **Demander des modifications**, mettez le contenu en surbrillance et ajoutez une question ou une instruction. La sélection est envoyée au modèle dans le chat.

#### Poursuivre votre tâche

Vous pouvez poser des questions de suivi dans le même chat. Après avoir trouvé les packs de ressources, essayez :

```
Lequel de ces packs conviendrait le mieux à un jeu en vue de dessus ?
Compare leurs styles et suggère ce dont nous pourrions avoir besoin d’autre.
```

<div data-with-frame="true"><figure><img src="https://550366147-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>

Il est utile d’être précis sur ce que vous souhaitez faire vérifier. Vous pouvez demander au modèle de comparer des options, de vérifier des détails sur une autre page ou d’expliquer comment il est arrivé à sa réponse.

#### Travailler avec du contenu visuel

Les modèles avec prise en charge de la vision peuvent examiner des captures d’écran d’images, de graphiques et d’autres contenus que le texte de la page ne capture pas. Les modèles sans vision peuvent toujours utiliser le texte de la page, les liens et les contrôles, mais ne peuvent pas examiner les images elles-mêmes.

Demandez au modèle d’ouvrir ou d’agrandir le contenu que vous voulez qu’il examine. Par exemple :

```
Pouvez-vous naviguer dans les ressources Kenney et partager une capture d’écran
de l’aperçu agrandi sur la page Pirate Kit ?
```

Le modèle peut naviguer vers la page du pack, ouvrir son aperçu et prendre une capture d’écran. Développez l’appel d’outil `browser_screenshot` pour voir l’image exacte qu’il a capturée.&#x20;

<div data-with-frame="true"><figure><img src="https://550366147-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>

Vous pouvez ensuite poser des questions de suivi sur l’image ou demander un examen plus précis d’une zone spécifique.

### Contrôler le navigateur

Observez le modèle travailler à côté de votre chat. Si vous devez gérer une étape vous-même, sélectionnez **Arrêter**, effectuez-la dans le navigateur et demandez au modèle de continuer.

Pour désactiver browser use, cliquez sur l’indicateur **Browser** à côté de la zone de saisie du chat.

#### Approuver les actions

Lorsqu’une approbation est nécessaire, le navigateur affiche une demande avec **Autoriser** et **Refuser** boutons.

Par défaut, Unsloth demande avant d’envoyer des formulaires, de se connecter ou d’effectuer des actions telles qu’envoyer, acheter ou supprimer. Il peut aussi demander avant d’ouvrir un nouveau site web.

Saisissez vous-même les mots de passe et les informations de paiement. Les outils de navigateur standard ne peuvent pas remplir ces champs ni téléverser des fichiers.

#### Définir les autorisations du site web

Ouvrez Paramètres et sélectionnez **Browser**. Sous **Autorisations de l’agent**, choisissez les valeurs par défaut ou ajoutez des exceptions pour des sites web individuels.

| Paramètre          | Ce qu’il contrôle                                                                                            |
| ------------------ | ------------------------------------------------------------------------------------------------------------ |
| Navigation         | Quels sites web le modèle peut visiter.                                                                      |
| Actions            | Approbation pour les connexions, les soumissions de formulaires et les actions telles qu’envoyer ou acheter. |
| Téléchargements    | Si les téléchargements sont autorisés, nécessitent une approbation ou sont bloqués.                          |
| Clics sans libellé | Clics et glissements sur des zones sans contrôle nommé, comme un canevas.                                    |

#### Historique et sélection de scripts de passages

Vous pouvez choisir si le modèle peut lire votre historique de navigation Unsloth. Réglez-le pour demander d’abord, toujours autoriser ou ne jamais autoriser.

Les scripts nécessitent une approbation à chaque fois. Vous verrez le script avant son exécution. Pour les désactiver, réglez **Exécuter les scripts** sur **Jamais**.

L’accès complet ignore plusieurs invites d’approbation, y compris les demandes liées à l’historique, sauf si l’accès à l’historique est réglé sur **Jamais**Demander d’abord

### <i class="fa-file">:file:</i> Travailler avec des fichiers à côté de votre chat

Vous pouvez aussi utiliser le panneau du navigateur pour modifier et parcourir des PDF, des documents Office, du HTML et des fichiers texte.

Ouvrez Paramètres, sélectionnez **Browser** et activez **Ouvrir les fichiers dans le navigateur**. Cliquez sur une pièce jointe prise en charge pour l’ouvrir à côté de votre conversation.

Pour poser une question sur un passage spécifique ou suggérer une modification, sélectionnez **Demander des modifications**, mettez le passage en surbrillance et dites à votre modèle ce que vous souhaitez qu’il fasse. Votre demande est envoyée au modèle dans le chat.

<div data-with-frame="true"><figure><img src="https://550366147-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>

Pendant votre lecture, demandez à votre modèle de résumer le fichier, d’expliquer une section ou de trouver un détail. Pour poser une question sur un passage spécifique ou suggérer une modification, sélectionnez **Demander des modifications** et mettez en surbrillance le texte concerné.

Les types de fichiers compatibles sont les suivants :&#x20;

| Type de fichier    | Extension |
| ------------------ | --------- |
| PDF                | `.pdf`    |
| Documents Word     | `.docx`   |
| Feuilles de calcul | `.xlsx`   |
| Présentations      | `.pptx`   |
| Markdown           | `.md`     |
| HTML               | `.html`   |
| Texte brut         | `.txt`    |

**Dépannage**

<details>

<summary>L’utilisation du navigateur n’est pas disponible</summary>

Choisissez un modèle qui prend en charge l’appel d’outils et ouvrez la vue de chat normale. L’utilisation du navigateur n’est pas disponible dans les mises en page mobiles ou de comparaison. Activez **Browser use** depuis le **+** menu à côté de la zone de saisie du chat.

</details>

<details>

<summary>Le modèle décrit les actions sans les exécuter</summary>

Vérifiez que **Browser use** est activé. Essayez de demander une action concrète, par exemple : « Ouvrez cette URL et lisez le titre de la page. » La fiabilité de l’appel d’outils peut varier selon les modèles.

</details>

<details>

<summary>Un site web ou une partie d’une page ne fonctionne pas</summary>

Certains sites web et contenus intégrés peuvent ne pas fonctionner avec les outils du navigateur. Si le modèle ne trouve pas un contrôle, décrivez son libellé visible ou son emplacement. Pour le contenu visuel, essayez un modèle capable de vision.

Vous pouvez aussi sélectionner **Arrêter**, effectuer l’étape manuellement si possible, puis demander au modèle de continuer.

</details>

<details>

<summary>Une action attend une approbation</summary>

Vérifiez dans le panneau du navigateur s’il y a une demande d’approbation et sélectionnez **Autoriser** ou **Refuser**. Si la demande a expiré, demandez au modèle de réessayer lorsque vous serez prêt à l’examiner.

</details>

<details>

<summary>Une page locale ne s’ouvre pas</summary>

Browser use prend en charge les sites web publics HTTP et HTTPS. Les adresses localhost, du réseau privé et `file://` les URL ne sont pas prises en charge comme cibles de navigation. Pour afficher une pièce jointe prise en charge, activez **Ouvrir les fichiers dans le navigateur** dans **Paramètres → Navigateur**, puis cliquez sur la pièce jointe.

</details>

<details>

<summary>Le modèle ne peut pas accéder à un autre onglet du navigateur</summary>

Le modèle fonctionne dans son propre onglet de navigateur Unsloth. Il ne peut pas contrôler les onglets dans Chrome, Firefox ou d’autres navigateurs. Copiez l’URL de la page dans le chat et demandez au modèle de l’ouvrir dans Unsloth.

</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/fr/notions-de-base/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.
