Browser Harness : un pont CDP auto-éditable pour les tâches navigateur des LLM
Harnais de navigateur | Harnais d'auto-guérison qui permet aux LLM d'accomplir n'importe quelle tâche.
En bref
- De quoi s’agit-il ?
- Un harnais fin et éditable connecte un LLM à un vrai Chrome ou Chromium via CDP, et l'agent écrit ses propres helpers pendant l'exécution.
- À qui s’adresse-t-il ?
- La conception du projet s'articule autour d'un noyau minimal que l'agent étend à l'exécution, et le README fournit une invite de configuration, un lanceur de développement et un chemin de contribution pour les compétences de domaine générées par l'agent.
- Puis-je l’utiliser commercialement ?
- Oui. MIT est une licence permissive : vous pouvez utiliser, modifier et vendre un logiciel qui en dépend, à condition de conserver les mentions de droit d’auteur et de licence.
- Est-il encore maintenu ?
- Oui. Les derniers commits datent d’il y a 4 jours.
- En quel langage est-il écrit ?
- Principalement Python, d’après les statistiques de langage de GitHub.
Ces réponses reposent sur les données GitHub du projet (dernière synchronisation le 15 septembre 2026) et sur notre analyse. Elles ne constituent pas un avis juridique.
ANALYSE OPEN SOURCE APPROFONDIE
Un harnais CDP qui s'édite lui-même
Browser Harness est un projet Python qui connecte un LLM à un vrai navigateur via le protocole Chrome DevTools. Le README le décrit comme un harnais fin et éditable qui donne à l'agent une liberté totale pour les tâches navigateur. La connexion est un websocket unique vers Chrome, rien entre les deux. Pendant l'exécution, l'agent écrit le code helper manquant, et le harnais s'améliore à chaque exécution. Le README illustre une tâche d'upload de fichier où l'agent découvre d'abord un helper manquant, l'écrit dans agent_helpers.py, puis termine l'upload.
Le choix architectural est volontairement réduit : le navigateur reste un vrai Chrome ou Chromium, la connexion passe par CDP et l’agent conserve un petit espace de travail avec quatre fichiers. Cette simplicité facilite l’inspection, mais elle transfère une part du contrôle qualité à l’utilisateur et au modèle qui produit les helpers.
Configuration via une seule invite
Le README fournit une invite de configuration à coller dans Claude Code ou Codex. L'invite demande à l'agent d'installer ou de mettre à niveau browser-harness vers la dernière version stable avec uv et Python 3.12, d'enregistrer la compétence depuis 'browser-harness skill', et de se connecter au navigateur. Il demande également si les enregistrements navigateur locaux doivent être activés, par défaut non, et préserve les préférences existantes lors des mises à niveau. Si la configuration ou la connexion échoue, l'agent doit suivre le fichier install.md. L'agent ouvrira chrome://inspect/#remote-debugging, et l'utilisateur doit cocher la case et cliquer sur Allow dans la fenêtre contextuelle par pièce jointe qui apparaît dans Chrome 144 et ultérieur. Le README mentionne également Browser Use Cloud comme alternative, offrant un niveau gratuit avec trois navigateurs concurrents, des proxys, la résolution de captchas et sans carte requise.
Pour examiner le comportement, il faut lancer le harnais avec l’invite du README, observer les fichiers générés et vérifier le port CDP utilisé par Chrome. Les helpers écrits pendant l’exécution doivent être relus avant réutilisation, surtout lorsqu’ils manipulent des sessions authentifiées ou des actions irréversibles. Le README décrit le mécanisme, mais ne promet ni isolation complète ni couverture de tous les sites.
Les quatre fichiers et l'espace de travail de l'agent
L'architecture est décrite comme environ mille lignes réparties sur quatre fichiers principaux. Le README liste install.md pour l'installation initiale et le bootstrap du navigateur, SKILL.md pour l'utilisation quotidienne, src/browser_harness/ comme package central protégé, et deux emplacements d'espace de travail de l'agent sous ${XDG_CONFIG_HOME:-~/.config}/browser-harness/ : agent_helpers.py pour le code helper que l'agent édite, et domain-skills/ pour les compétences réutilisables spécifiques au site. Les appels helper simples 'browser-harness' se connectent au point de terminaison CDP du Chrome ou Chromium en cours d'exécution. Pour l'automatisation isolée, le README indique de lancer Chrome avec --remote-debugging-port et de passer BU_CDP_URL, ou d'utiliser un navigateur cloud Browser Use.
Exécuter l'arbre de travail pendant le développement
Pour le développement à partir d'un checkout, le README montre comment utiliser ./browser-harness pour exécuter l'arbre de travail actuel sans activer de virtualenv ni dépendre de la commande globalement installée. Un exemple envoie un extrait Python au lanceur qui appelle page_info(). Le README précise que la documentation normale orientée agent doit continuer à utiliser la commande browser-harness, et que le lanceur ./browser-harness est uniquement pour les tests de dépôt locaux. Cela garde l'arbre de travail testé séparé du paquet installé.
Les compétences de domaine sont générées par l'agent
Les compétences de domaine vivent dans l'espace de travail de l'agent et sont activées en définissant BH_DOMAIN_SKILLS=1. Le répertoire agent-workspace/domain-skills/ du dépôt contient des exemples comme github, linkedin et amazon. Le README est explicite : les compétences sont écrites par le harnais, pas à la main. Lorsque l'agent découvre quelque chose de non évident, il enregistre la compétence lui-même. Les contributeurs sont invités à ne pas créer manuellement de fichiers de compétences, mais plutôt à exécuter une tâche avec l'agent, puis à ouvrir une PR avec le dossier généré domain-skills/<site>/ copié dans les exemples du dépôt. Les corrections de bogues, les ajustements de documentation et les améliorations de helpers sont également les bienvenus.
Licence MIT et ce qu'elle ne couvre pas
Le projet est sous licence MIT, copyright 2026 Browser Use. La licence accorde le droit d'utiliser, copier, modifier, fusionner, publier, distribuer, sous-licencier et vendre des copies du logiciel, à condition que l'avis de copyright et la licence soient inclus dans toutes les copies ou portions substantielles. Le logiciel est fourni 'en l'état', sans garantie d'aucune sorte, expresse ou implicite, y compris les garanties de qualité marchande, d'adéquation à un usage particulier et de non-contrefaçon. La licence n'établit aucune garantie de sécurité, aucun engagement de support ni aucune clause de responsabilité au-delà de l'avertissement. Le README ne décrit pas non plus de modèle de support, et les métadonnées du dépôt enregistrent 230 problèmes ouverts au moment de l'instantané, mais le README lui-même ne les aborde pas.
Contrôle propre au dépôt · browser use browser harness
Le contrôle doit rester attaché à browser-harness. Le choix architectural est volontairement réduit : le navigateur reste un vrai Chrome ou Chromium, la connexion passe par CDP et l’agent conserve un petit espace de travail avec quatre fichiers. Cette simplicité facilite l’inspection, mais elle transfère une part du contrôle qualité à l’utilisateur et au modèle qui produit les helpers.
Conclusion éditoriale
La conception du projet s'articule autour d'un noyau minimal que l'agent étend à l'exécution, et le README fournit une invite de configuration, un lanceur de développement et un chemin de contribution pour les compétences de domaine générées par l'agent.
Notes de la communauté