Agent de navigation IA open source pour discuter avec les pages, automatiser les tâches et exécuter des workflows multi-étapes avec le LLM de votre choix.
English · 中文 · Français · Documentation · Site web · Licence MIT
WebBrain est une extension de navigateur qui place un agent IA dans un panneau latéral, à côté de vos onglets. Posez-lui des questions sur la page où vous êtes, ou confiez-lui une tâche et laissez-le cliquer, saisir et naviguer pour l'accomplir. Il tourne sur le modèle de votre choix — un serveur local llama.cpp ou Ollama, une API cloud de pointe, ou l'option gérée par défaut qui ne demande aucune configuration.
Installez depuis le Chrome Web Store, les modules Firefox ou les modules Edge.
Ou chargez-le depuis les sources
git clone https://github.com/webbrain-one/webbrain.gitChrome — ouvrez chrome://extensions/, activez le mode développeur (en
haut à droite), cliquez sur Charger l'extension non empaquetée et
sélectionnez le dossier webbrain/src/chrome.
Firefox — ouvrez about:debugging#/runtime/this-firefox, cliquez sur
Charger un module complémentaire temporaire et sélectionnez
src/firefox/manifest.json. Les modules temporaires sont supprimés au
redémarrage de Firefox ; une installation permanente nécessite une signature via
addons.mozilla.org.
Cliquez sur l'icône WebBrain pour ouvrir le panneau latéral, puis tapez par exemple :
- « Résume cette page »
- « Trouve tous les liens à propos des tarifs »
- « Remplis le champ de recherche avec 'AI agents' et clique sur Rechercher »
- « Navigue vers github.com et trouve les dépôts tendance »
Trois modes contrôlent ce que l'agent a le droit de faire :
| Mode | Ce qu'il peut faire |
|---|---|
| Ask | Lecture seule. Lit la page, répond aux questions, récupère des URL. |
| Act | Clique, saisit, navigue, téléverse, télécharge, remplit des formulaires. |
| Dev | Ajoute source de page, styles, console, réseau et éditions réversibles. |
WebBrain Cloud 1.0 est l'option par défaut : ni clé API, ni configuration locale.
Les modèles locaux ne demandent pas non plus de clé API. Pointez WebBrain vers n'importe quel serveur compatible OpenAI :
llama-server -m your-model.gguf --port 8080 # llama.cpp
ollama serve # Ollama → :11434/v1
vllm serve your-model --port 8000 # vLLM → :8000/v1
python -m sglang.launch_server --model-path your-model --port 30000LM Studio (:1234/v1), Jan (:1337/v1) et LocalAI (:8080/v1) fonctionnent de
la même manière. Chargez un modèle avec au moins une fenêtre de contexte de
16k jetons — 8k ne fonctionne qu'avec le niveau Compact, et 4k est trop petit
pour le prompt système et les schémas d'outils. WebBrain détecte
automatiquement la fenêtre réelle pour llama.cpp, Ollama et LM Studio, et
compacte la conversation à mesure qu'elle se remplit. Il existe aussi un relais
ollama launch webbrain --model <model> en préversion. Détails :
fournisseurs et modèles.
API cloud — OpenAI, Anthropic Claude, Google Gemini, Azure OpenAI, AWS Bedrock, Mistral, DeepSeek, xAI Grok, MiniMax, Kimi, Qwen, z.ai GLM, Groq, Together, Cloudflare, Nvidia NIM, Hugging Face, Fireworks, OpenRouter et d'autres. Les Paramètres embarquent 104 cartes de fournisseurs avec URL de base et modèle par défaut préremplis — voir le catalogue complet.
- Lit n'importe quelle page — texte, liens, formulaires, tableaux, PDF et éléments interactifs, via l'arbre d'accessibilité plutôt que des sélecteurs fragiles
- Agit dessus — cliquer, saisir, faire défiler, naviguer, téléverser, télécharger et vérifier des formulaires, avec des demandes d'autorisation par site avant toute action conséquente
- Plan avant Act — Act et Dev peuvent générer un plan structuré, l'afficher pour approbation, et l'épingler dans le scratchpad avant l'exécution du moindre outil
- Agent multi-étapes — boucle d'utilisation d'outils autonome, configurable jusqu'à 195 étapes (130 par défaut), avec un bouton Continuer en cas de limite
- Workflows enregistrés — transformez une exécution réussie en workflow réutilisable et sans valeurs, que vous pouvez relancer, exporter et partager
- Tâches planifiées et surveillance —
/schedulepour plus tard,/watchpour interroger une page et agir quand une condition est remplie - Compétences — instructions et outils de confiance chargés uniquement quand c'est pertinent
- Contexte intelligent — auto-compactage tenant compte des jetons, limites de résultats d'outils et récupération d'urgence en cas de débordement
- Conversations par onglet — chaque onglet garde son historique ; mémoire utilisateur locale optionnelle pour vos préférences déclarées
- Panneau latéral pensé pour la lecture — réponses Ask en streaming, commandes flottantes qui gardent votre question visible pendant que la réponse s'allonge, boutons de copie, bannière d'inspection de page et un bouton d'arrêt utilisable en cours d'exécution
- Déterministe par défaut — température
0.15pour les décisions de contrôle du navigateur,0.3pour Ask,0pour les descriptions de captures d'écran
WebBrain sépare le niveau du mode. Le niveau (compact, mid, full)
est un réglage par fournisseur contrôlant le nombre d'outils que le modèle voit
— Compact convient aux petits modèles locaux, Full débloque hover, drag-drop,
frames et shadow DOM. Le mode (ask, act, dev) contrôle ce que
l'utilisateur autorise.
La matrice complète outil × niveau, les notes WebMCP et les diagnostics du mode Dev se trouvent dans outils de l'agent.
Tapez /help dans le panneau pour les syntaxes et options complètes. Les plus
utiles :
| Commande | Ce qu'elle fait |
|---|---|
/ask · /act · /dev · /plan |
Changer de mode avant d'envoyer |
/schedule [invite] |
Créer une tâche planifiée |
/watch [--keep] [--secs <30-120>] [--long | --short] <condition et action> [/beep] |
Interroger la page courante et agir quand une condition est remplie |
/workflow --save <nom> |
Compiler la dernière exécution réussie en workflow réutilisable |
/memory --add <texte> |
Enregistrer une préférence utilisateur |
/screenshot [--full-page] |
Capturer l'onglet, ou la page entière défilable |
/record [--transcribe] |
Enregistrer l'onglet actuel, avec transcription optionnelle |
/export [--traces | --config] |
Télécharger la conversation, la chaîne d'outils ou un instantané des Paramètres |
/compact · /reset · /verbose |
Compacter le contexte, effacer la conversation, basculer le détail des outils |
/allow-api |
Dérogation par conversation autorisant fetch_url à muter quand l'UI échoue |
/watch effectue sa première vérification immédiatement, puis interroge toutes
les 60 secondes (--secs accepte 30 à 120). Les conditions relatives comme
« quand un nouveau commit apparaît » établissent une référence à la première
vérification ; --keep maintient la surveillance active et supprime les alertes
répétées pour la même clé d'événement stable.
Référence complète, y compris /dangerously-skip-permissions et les suffixes de
capture d'exécution : commandes slash.
Les raccourcis du panneau latéral Chrome fonctionnent lorsque le panneau latéral WebBrain a le focus.
| Raccourci | Ce qu'il fait |
|---|---|
Ctrl+/ ou Cmd+/ |
Mettre le focus dans le champ de saisie |
Ctrl+Shift+A ou Cmd+Shift+A |
Passer en mode Ask |
Ctrl+Shift+X ou Cmd+Shift+X |
Passer en mode Act |
Ctrl+Shift+D ou Cmd+Shift+D |
Passer en mode Dev |
Escape |
Arrêter l'exécution active, sauf s'il ne fait que fermer l'autocomplétion des commandes slash |
Escape deux fois |
Arrêter un enregistrement actif depuis WebBrain ou une page du navigateur |
| Architecture | Vue d'ensemble, flux d'un tour, sous-systèmes |
| Outils de l'agent | Niveaux, modes et matrice complète |
| Commandes slash | Toutes les commandes et options |
| Fournisseurs et modèles | Les 104 cartes, configuration locale, niveaux |
| Compétences | Compétences intégrées, import, outils de compétence |
| Modèle de sécurité | Permissions, identifiants, frontières de confiance |
| Défense contre l'injection de prompt | Couches de défense et limites connues |
| Confidentialité et flux de données | Ce qui quitte le navigateur, et ce qui reste |
| Arbre d'accessibilité et refs | Comment les pages sont lues et ciblées |
| Adaptateurs de sites | Consignes par site |
| Export and workflow formats | webbrain-config/1, webbrain-workflow/1 (en anglais) |
| Ajouter un outil · Localisation · Scénarios de test | Guides pour contributeurs |
Également disponible en English et 中文.
src/chrome/ Build Manifest V3 — service worker, chrome.scripting, sidePanel
src/firefox/ Build Manifest V2 — page d'arrière-plan, executeScript, sidebar_action
docs/ Documentation de conception et de référence (en, zh-CN, fr)
lmstudio-plugin/ fetch_url + research_url en plugin LM Studio autonome
web/ Site vitrine et site de documentation
test/ Suite de tests Node, benchmarks de scénarios LLM, corpus de sécuritéLa quasi-totalité du code de l'agent est partagée entre les deux builds. Voir architecture pour les points de divergence.
Firefox est nettement plus faible que Chrome. Firefox n'a pas d'équivalent au
Chrome DevTools Protocol via chrome.debugger : le build Firefox n'a donc pas de
traversée du shadow DOM, pas de véritables événements de souris approuvés
(certains gestionnaires React/Vue ne se déclenchent pas), pas de traversée de
shadow root fermé, pas de budget de réessai resolveSelector, pas de réessai
conscient de la navigation SPA, et pas de captures d'écran CDP (repli sur
tabs.captureVisibleTab, onglets actifs uniquement). Les adaptateurs de sites,
la détection par vision, la détection de boucle, la boucle de capture
automatique et l'ensemble prompt/outils Compact sont reflétés sur Firefox.
Certaines applications monopages peuvent aussi ne pas déclencher la réinjection
du content-script après une navigation côté client.
Voir CONTRIBUTING.md. Pour ajouter un outil, suivez la
checklist d'ajout d'un outil. Pour ajouter un
fournisseur, étendez BaseLLMProvider, implémentez chat() (et éventuellement
chatStream()), et enregistrez-le dans providers/manager.js — en répercutant
les deux changements dans src/chrome/ et src/firefox/. Tous les fournisseurs
se normalisent vers { content, toolCalls, usage } ; détails dans
fournisseurs et modèles.
Les changements récents sont dans CHANGELOG.md.
fetch_url et research_url sont également fournis comme plugin
LM Studio autonome sur
webbrain/web-tools, pour utiliser des
outils de récupération web dans les chats LM Studio sans l'extension de
navigateur. Pur Node, sans navigateur sans interface.
lms clone webbrain/web-toolsSource : lmstudio-plugin/.
@software{webbrain2026,
author = {Sokullu, Emre},
title = {WebBrain : Agent de navigation IA open source pour discuter avec les pages},
year = {2026},
publisher = {GitHub},
url = {https://github.com/webbrain-one/webbrain}
}MIT — créé par Emre Sokullu