Comment installer Browser Use sur Windows 11 étape par étape

Dernière mise à jour : 27/08/2026

  • Browser Use recommande Python 3.12 et uv pour les nouvelles installations sous Windows.
  • L'environnement virtuel empêche les conflits entre l'utilisation du navigateur et les autres projets Python.
  • uvx browser-use install télécharge Chromium sans installer Playwright manuellement et séparément.
  • Un test minimal confirme la présence de Python, du navigateur, du modèle et de la clé.
Comment installer Browser Use sur Windows 11

L'utilisation du navigateur vous permet de contrôler les pages Web à l'aide d'agents d'intelligence artificielleMais avant de créer une quelconque automatisation, vous devez correctement préparer Python, le navigateur et le modèle qui prendra les décisions.

Sous Windows, l'installation est relativement simple si vous utilisez les versions et les commandes appropriées. Le principal problème est que de nombreux guides anciens recommandent encore d'installer Playwright, les paquets LangChain et Chromium séparément, même si La procédure officielle actuelle a été simplifiée..

Ce guide se concentre exclusivement sur Installer le navigateur sur Windows 10 ou 11Vérifiez que votre navigateur fonctionne et résolvez les erreurs courantes. Si vous souhaitez apprendre à créer des tâches, extraire des résultats ou protéger vos identifiants, consultez notre guide. Automatisation d'un site web avec l'utilisation du navigateur.

Chrome intégré Gemini
Article connexe :
Gemini est intégré à Chrome : voici comment le navigateur de Google évolue.

Ce dont vous avez besoin pour installer un navigateur sous Windows

Ce dont vous avez besoin pour installer un navigateur sous Windows

Avant de commencer, assurez-vous d'avoir :

  • Windows 10 ou 11 avec une version mise à jour.
  • Python 3.12, qui est la version utilisée dans le guide officiel.
  • Un terminal comme PowerShell, Terminal Windows ou Invite de commandes.
  • Une connexion Internet est requise pour télécharger les paquets et Chromium.
  • UN Clé API pour le modèle que l'agent utilisera.
  • Au moins quelques gigaoctets d'espace libre pour Python, ses dépendances et le navigateur.

Google Chrome n'est pas requis pour le test de base. BrowserUser peut télécharger une version compatible de Chrome et l'exécuter indépendamment.

Vous n’avez pas non plus besoin d’installer Playwright manuellement pour commencer. Vous pourrez l’ajouter ultérieurement si vous souhaitez créer des outils personnalisés à l’aide de ses API. Cela ne fait pas partie de la procédure de base actuelle..

Comment vérifier si Python est installé ?

Ouvrez PowerShell ou le Terminal Windows et exécutez :

py --version

Si une version de Python apparaît, le lanceur est installé. Pour vérifier spécifiquement la présence de Python 3.12 :

py -3.12 --version

Le résultat devrait être similaire à :

Python 3.12.x

Si Windows indique qu'il ne reconnaît pas la commande, téléchargez Python 3.12 pour Windows Extrait du site officiel. Lors de l'installation, activez l'option permettant d'ajouter Python. PATH.

Après l'installation, fermez le terminal, ouvrez une nouvelle fenêtre et répétez l'opération :

py -3.12 --version

Bien que Browser Use puisse fonctionner avec d'autres versions compatibles, l'utilisation de Python 3.12 évite de nombreux problèmes de dépendances et est compatible avec l'environnement recommandé dans la documentation officielle.

Comment installer UV sur Windows

L'utilisation du navigateur recommande d'utiliser uv pour créer l'environnement virtuel et installer les dépendances. Cet outil gère les paquets Python et est généralement plus rapide que l'utilisation de pip directement.

Installez-le en utilisant :

py -m pip install uv

Vérifiez ensuite qu'il répond :

uv --version

Si Windows ne trouve pas la commande immédiatement, Fermer et rouvrir le terminalCela permet au système de recharger les itinéraires configurés.

Vous pouvez également vérifier que le paquet est installé en :

py -m pip show uv

Comment créer l'environnement virtuel pour l'utilisation du navigateur

Comment créer l'environnement virtuel pour l'utilisation du navigateur

N'installez pas Browser Use globalement avec tous vos autres packages. Il est recommandé de créer un dossier séparé et d'utiliser un... environnement virtuel isolé.

Contenu exclusif - Cliquez ici  Comment créer vos propres thèmes dynamiques sur Android avec Repainter

Par exemple, créez un dossier appelé browser-use-windows:

mkdir browser-use-windows
cd browser-use-windows

Créez maintenant l'environnement avec Python 3.12 :

uv venv --python 3.12

La commande générera un dossier appelé .venvPour activer l'environnement depuis PowerShell :

.venv\Scripts\Activate.ps1

À partir de l'invite de commandes, utilisez :

.venv\Scripts\activate.bat

Si elle a été activée correctement, vous verrez (.venv) au début de la ligne de commande. À partir de ce moment, seuls les paquets de ce projet seront installés.

Si PowerShell bloque le script d'activation en raison de sa stratégie d'exécution, vous pouvez éviter de modifier la sécurité du système puis exécutez le programme en utilisant uv run.

Comment installer Browser Use et Chromium

Une fois l'environnement préparé, installez la bibliothèque :

uv pip install browser-use

Téléchargez ensuite le navigateur nécessaire :

uvx browser-use install

Cette deuxième commande installe Chrome et les composants nécessaires à l'automatisationIl n'est plus nécessaire de les exécuter séparément :

pip install playwright
playwright install chromium

Ces commandes peuvent apparaître dans des tutoriels précédents, mais elles ne sont pas nécessaires pour suivre la procédure officielle de base d'utilisation du navigateur.

Pour vérifier que Python peut importer la bibliothèque, exécutez :

python -c "import browser_use; print('Browser Use instalado correctamente')"

Si vous n'avez pas activé l'environnement virtuel, utilisez :

uv run python -c "import browser_use; print('Browser Use instalado correctamente')"

Comment configurer la clé du modèle

Comment configurer la clé du modèle dans le navigateur ?

L'option « Utilisation du navigateur » contrôle le navigateur, mais elle nécessite un Modèle de langage qui interprète la page et décide des actionsVous pouvez utiliser leur propre modèle, Gemini, OpenAI, Anthropic, OpenRouter et d'autres fournisseurs compatibles.

Pour créer le fichier de configuration sous Windows :

echo. > .env

Ouvrez-le avec le Bloc-notes :

notepad .env

Si vous comptez utiliser Gemini, ajoutez :

GOOGLE_API_KEY=TU_CLAVE

L'intégration actuelle utilise GOOGLE_API_KEYL'ancienne variable GEMINI_API_KEY Il est obsolète et peut causer des problèmes dans les exemples récents.

Pour le navigateur, utilisez un modèle propriétaire :

BROWSER_USE_API_KEY=TU_CLAVE

Vous pouvez également configurer d'autres fournisseurs :

OPENAI_API_KEY=TU_CLAVE
ANTHROPIC_API_KEY=TU_CLAVE
OPENROUTER_API_KEY=TU_CLAVE

Ne partagez pas le fichier .env Ne le téléchargez même pas sur GitHub. Si vous utilisez Git, ajoutez cette ligne au fichier .gitignore:

.env

Les limites de gratuité et les tarifs des fournisseurs peuvent changer. Consultez les conditions en vigueur avant de lancer des automatisations longues ou récurrentes.

Article connexe :
Comment connecter Jan AI aux serveurs MCP : Guide complet

Comment vérifier si l'utilisation du navigateur fonctionne

Comment vérifier si l'utilisation du navigateur fonctionne

L'objectif de ce test n'est pas de créer une automatisation avancée, mais de confirmer que Python, utilisation du navigateur, Chromium, le modèle et la clé ils fonctionnent bien.

Créez un fichier appelé prueba.py:

notepad prueba.py

Saisissez ce code si vous comptez utiliser Gemini :

import asyncio

from dotenv import load_dotenv
from browser_use import Agent, Browser, ChatGoogle

load_dotenv()

async def main():
    browser = Browser(
        headless=False,
        allowed_domains=["example.com"],
    )

    agent = Agent(
        task=(
            "Abre https://example.com, comprueba que la página carga "
            "y devuelve su encabezado principal."
        ),
        llm=ChatGoogle(model="gemini-flash-latest"),
        browser=browser,
        use_vision="auto",
    )

    history = await agent.run(max_steps=5)

    print(history.final_result())
    print("Finalizado:", history.is_successful())

if __name__ == "__main__":
    asyncio.run(main())

Enregistrez le fichier et exécutez-le :

python prueba.py

Si l'environnement virtuel n'est pas activé :

uv run python prueba.py

Une fenêtre Chromium devrait s'ouvrir et se charger. example.com et le résultat s'affichera dans le terminal. Si cela se produit, L'installation de base est terminée..

Contenu exclusif - Cliquez ici  Les jouets dotés d'intelligence artificielle (chatbots) font l'objet d'un examen minutieux en raison de leurs failles de sécurité.

L'option headless=False Cela permet de garder la fenêtre visible et facilite la détection des erreurs. Lorsque l'automatisation fonctionne correctement, vous pouvez la basculer vers True exécuter le navigateur en arrière-plan.

Différences entre l'utilisation de la bibliothèque et du navigateur avec l'interface de ligne de commande (CLI)

L'utilisation du navigateur comporte plusieurs interfaces dont les noms peuvent prêter à confusion :

  • Bibliothèque Python : permet le développement d'agents par le biais Agent, Browser et les classes de modélisation.
  • Utilisation du navigateur via l'interface de ligne de commande : Il permet un contrôle direct du navigateur pour Codex, Claude Code et d'autres agents de programmation.
  • Utiliser le navigateur dans le terminal : Il s'agit d'une application interactive autonome, dotée de son propre historique, de ses profils et de ses commandes.
  • Utilisation du navigateur dans le cloud : Il propose des navigateurs et des sessions gérés à distance.

Pour suivre ce guide, vous n'avez besoin que de la bibliothèque Python et ChromiumIl n'est pas nécessaire d'installer le navigateur. Utilisez le terminal.

Si vous souhaitez ajouter l'interface de ligne de commande Direct Control comme outil permanent :

uv tool install browser-use
browser-use --help

Pour vérifier d'éventuels problèmes de connexion au navigateur :

browser-use --doctor

La bibliothèque est la solution idéale pour développer votre propre application. L'interface en ligne de commande (CLI) est utile lorsque vous souhaitez… un agent de programmation contrôle directement votre navigateur sans créer un script complet à partir de zéro.

Comment mettre à jour BrowserUser sous Windows

Comment mettre à jour BrowserUser sous Windows

BrowserUse évolue rapidement et certains noms de classes ou de paramètres peuvent changer. Pour mettre à jour la bibliothèque dans l'environnement virtuel :

uv pip install --upgrade browser-use

Vérifiez ensuite à nouveau les composants du navigateur :

uvx browser-use install

Si vous avez installé l'interface de ligne de commande (CLI) en tant qu'outil global à l'aide de uv toolVous pouvez forcer sa mise à jour avec :

uv tool install --python 3.12 --upgrade --force browser-use

Vérifiez la version disponible en utilisant :

browser-use --help

Après une mise à jour majeure, relancez-la. prueba.py avant d'utiliser vos automatisations habituelles.

Windows ne reconnaît pas py ou python

Python n'est pas installé ou est introuvable dans le PATHRéinstallez Python 3.12, activez l'option permettant de l'ajouter au système et ouvrez un nouveau terminal.

Windows ne reconnaît pas les UV

Vérifiez d'abord qu'il a été installé :

py -m pip show uv

Fermez puis rouvrez Windows Terminal ou PowerShell. Si le problème persiste, vérifiez que le dossier des scripts Python est bien inclus dans le chemin d'accès. PATH.

PowerShell empêche l'activation de l'environnement virtuel.

Il n'est pas obligatoire de modifier la politique d'exécution globale du système. Vous pouvez exécuter directement :

uv run python prueba.py

uv Il utilisera l'environnement du projet sans nécessiter le script d'activation PowerShell.

Je reçois l'erreur ModuleNotFoundError : aucun module nommé browser_use

Le script s'exécute avec un interpréteur Python différent. Activer .venv ou utilisations :

uv run python prueba.py

Chromium n'est pas installé

Relancez-le :

uvx browser-use install

Vérifiez également que votre antivirus ou pare-feu ne bloque pas le téléchargement ou l'exécution du navigateur.

La clé API n'apparaît pas.

Vérifiez que le nom du fichier est exactement .env et non .env.txtDans l'Explorateur de fichiers, activez temporairement l'affichage des extensions de fichiers pour vérifier cela.

Contenu exclusif - Cliquez ici  Guide complet de Process Hacker : une alternative avancée au Gestionnaire de tâches

Il confirme également que le script comprend :

from dotenv import load_dotenv
load_dotenv()

Gemini renvoie une erreur d'authentification

Vérifiez que vous utilisez GOOGLE_API_KEYCela confirme que la clé reste active et que le projet dispose d'un quota. N'utilisez pas l'ancienne variable. GEMINI_API_KEY.

Le navigateur s'ouvre et se ferme immédiatement.

Vérifiez l'erreur affichée dans le terminal. Elle peut être due à une clé manquante, un modèle incompatible, Chromium non installé ou une exception dans le script.

Conserver temporairement headless=False et réduit le test à un domaine simple comme example.com.

L'agent met beaucoup de temps à répondre.

La vitesse dépend principalement du modèle, de la connexion et du nombre d'étapes, et non pas seulement du navigateur. Essayez une tâche plus courte et un modèle plus rapide avant de modifier l'installation.

Un modèle local n'exécute pas correctement les actions.

La compatibilité d'un modèle avec une API ne garantit pas son bon fonctionnement selon les schémas et outils d'utilisation du navigateur. Les petits modèles locaux peuvent générer des réponses invalides ou effectuer des actions incorrectes.

Commencez par confirmer l'installation à l'aide de l'un des modèles recommandés. Ensuite, configurez Ollama comme une intégration autonome afin d'éviter de confondre un problème de modèle avec un problème Windows.

Que faire après avoir terminé l'installation

Une fois le test minimum réussi, vous pouvez créer des tâches plus complexes, configurer des résultats structurés, restreindre les domaines, utiliser des données sensibles ou connecter une session authentifiée.

Il est conseillé de procéder progressivement :

  1. Commencez par consulter une simple page publique.
  2. Cela limite l'agent à quelques étapes.
  3. Consultez les pages et les actions de l'historique.
  4. Ajoutez uniquement les domaines nécessaires.
  5. Saisissez l'authentification après avoir validé la navigation.
  6. Demander une confirmation pour toute action irréversible.

L'installation de Browser Use sous Windows implique la préparation de Python 3.12 et la création d'un environnement utilisant uvInstallez la bibliothèque et téléchargez Chromium à l'aide de son programme d'installation. Le test final devrait confirmer que Le modèle peut ouvrir une page et renvoyer le résultat. sans erreurs.

En concentrant cet article sur l'installation, on évite de répéter le guide d'automatisation général et on permet de mieux répondre à l'intention spécifique de l'utilisateur : Installation et fonctionnement de Browser Use sur un PC Windows.

Alberto Navarro

Alberto Navarro

Passionné de technologie, j'ai fait de ma passion mon métier. Depuis plus de dix ans, j'utilise des technologies de pointe et expérimente avec toutes sortes de programmes par pure curiosité. Je suis désormais spécialisé en informatique et jeux vidéo. Depuis plus de cinq ans, j'écris pour différents sites web spécialisés, en créant des articles accessibles à tous.

Si vous avez des questions, mes connaissances s'étendent de tout ce qui concerne le système d'exploitation Windows ainsi qu'Android pour les téléphones mobiles. Et mon engagement est envers vous, je suis toujours prêt à consacrer quelques minutes et à vous aider à résoudre toutes les questions que vous pourriez avoir dans ce monde Internet.