# OpenHands Agent Canvas : piloter des agents de code > OpenHands Agent Canvas est un tableau de bord auto-hébergé pour lancer Claude Code, Codex ou Gemini et automatiser des tâches de développement. - Type : projet open source - Famille : Agents IA · Centre de contrôle d'agents - Habitat : Navigateur · Node.js · Docker - Niveau : intermédiaire - Langage : TypeScript - Licence : MIT - Étoiles GitHub : 91698 (relevé le 25 octobre 2026) - Source : https://github.com/OpenHands/OpenHands - Publié le : 25 octobre 2026 - Page : https://geekus.fr/projets/openhands/ OpenHands Agent Canvas est un centre de contrôle auto-hébergé pour agents de code : une interface unique pour démarrer des conversations avec plusieurs agents et automatiser des tâches courantes. Il fait tourner l'agent OpenHands, mais aussi Claude Code, [Codex](https://geekus.fr/projets/codex/), Gemini CLI, Pi ou OpenCode. Les agents peuvent s'exécuter sur ta machine, dans Docker, sur une machine virtuelle ou dans le cloud. ## En bref - Un tableau de bord unique pour OpenHands, Claude Code, Codex, Gemini, Pi, OpenCode ou tout agent compatible ACP - Les agents tournent en local, dans Docker, sur une VM ou dans le cloud, et tu passes de l'un à l'autre - Des automatisations planifiées ou déclenchées par webhook, avec Slack, GitHub, Linear et d'autres - Sans bac à sable Docker, l'agent accède à tout le système de fichiers - Licence MIT, installation par npm ou par image Docker ![OpenHands en image (tirée de la page du projet)](/illustrations/openhands-2.webp?v=6ade1dfb) ## Qu'est-ce qu'OpenHands Agent Canvas ? Les agents de code, ces programmes d'IA qui lisent un projet, écrivent et modifient du code, se multiplient, et chacun vient avec sa propre interface. OpenHands Agent Canvas propose de les réunir dans un seul **tableau de bord** que tu héberges toi-même. Le README le décrit comme une façon de transformer tes agents en équipe d'ingénierie hébergée par tes soins et toujours disponible. L'outil sert à démarrer des conversations avec les agents et à automatiser des tâches du quotidien, par exemple générer des rapports publiés sur Slack ou découper automatiquement des tickets GitHub en tâches. Par défaut, il s'exécute sur ta machine. ## Comment fonctionne OpenHands Agent Canvas Agent Canvas s'appuie sur l'Agent Server d'OpenHands, une API REST qui permet de faire tourner plusieurs agents sur une même machine. Chaque Agent Server écoute sur un hôte et un port. Le tableau de bord peut se connecter à plusieurs de ces serveurs, appelés « backends », et basculer de l'un à l'autre. Un serveur peut être partagé avec une équipe pour la revue de code ou les mises à jour de dépendances, tandis que tes agents personnels restent sur ton ordinateur portable. Le serveur d'agents est souvent associé à un serveur d'automatisations, qui gère les agents lancés selon un calendrier ou en réaction à un événement. ## Agents, modèles et automatisations L'agent open source OpenHands fonctionne dès l'installation. Les agents tiers passent par l'Agent-Client Protocol (ACP) : Claude Code, Codex, Gemini CLI, Pi, OpenCode, ou tout agent compatible. Côté modèle de langage, le README indique que l'outil s'utilise avec n'importe quel LLM. Les automatisations s'intègrent à des services comme Slack, GitHub, Linear ou Notion. Elles se lancent à heure fixe ou en réponse à des événements de type webhook. - Choisir entre exécution locale, distante ou dans le cloud sans perdre le fil - Brancher ses propres modèles via des profils LLM - Publier des rapports sur Slack - Décomposer des issues GitHub en tâches ## Installer OpenHands Agent Canvas Le README propose quatre options. La plus directe, sans bac à sable, demande Node.js 24 ou plus récent et `uv`. Attention : l'agent-server tourne alors directement sur ta machine et l'agent a un accès complet à ton système de fichiers. Une fois lancé, l'interface est accessible sur pour les lanceurs npm et source, ou sur /canvas pour l'image Docker. Tu peux ajouter d'autres backends depuis l'interface. ```bash npm install -g @openhands/agent-canvas agent-canvas ``` ## Isoler les agents avec Docker La deuxième option utilise une image Docker. Il faut créer un dossier `PROJECTS_PATH` contenant les projets auxquels l'agent aura accès, et seuls ces projets lui sont visibles. La troisième option lance chaque nouvelle conversation dans son propre conteneur, avec son Agent Server et ses outils, ce qui sert à faire tourner plusieurs agents en parallèle. Canvas et l'Agent Server extérieur restent sur ta machine : cette option isole l'exécution des conversations, pas l'ensemble de l'outil. Deux conversations qui utilisent le même dossier de travail partagent ses fichiers. ```bash export PROJECTS_PATH="$HOME/projects" # directory containing your project folders mkdir -p "$PROJECTS_PATH" "$HOME/.openhands" docker run -it --rm \ -p 127.0.0.1:8000:8000 \ -e AGENT_CANVAS_ALLOW_LAN_SESSION_KEY=true \ -v "$HOME/.openhands:/home/openhands/.openhands" \ -v "${PROJECTS_PATH}:/projects" \ ghcr.io/openhands/agent-canvas:1.33.0 # x-release-please-version ``` ## Où en est le projet Selon les relevés GitHub du 25 octobre 2026, le dépôt compte 91 798 étoiles, 12 189 copies, 583 contributeurs et 1 109 tickets et demandes de fusion ouverts. Il a été créé le 13 mars 2024, et son code est écrit à 92 % en TypeScript. La version 1.33.0 est sortie le 23 octobre 2026, deux jours après la 1.31.0 du 22 octobre et le même jour que la 1.32.0. Ses notes mentionnent notamment le masquage des valeurs secrètes dans les formulaires et la suppression du badge « beta » du README. Les versions précédentes ont apporté, entre autres, l'épinglage des automatisations favorites et un choix d'options à l'installation de serveurs MCP. ## Ce qu'il faut savoir avant de se lancer Le projet est sous licence MIT. En local, les écoutes se font sur l'adresse de bouclage (127.0.0.1), donc inaccessibles depuis les autres machines du réseau. Pour écouter sur toutes les interfaces, il faut l'indiquer avec `--host 0.0.0.0` ; dans ce cas la clé de session n'est plus injectée et l'interface demande une clé d'API. Pour une installation exposée sur Internet, le README renvoie à son guide d'auto-hébergement, notamment pour le durcissement de la sécurité. Côté macOS, les notes de version signalent que l'application n'est pas encore signée avec un identifiant développeur Apple : le système peut la déclarer « endommagée », ce qui demande une commande de déblocage. ## Quelques repères - **Webhook** : Un webhook est un message qu'un service envoie automatiquement à une adresse donnée quand un événement se produit, par exemple l'ouverture d'un ticket. Il permet de déclencher une action sans intervention humaine. - **Conteneur** : Un conteneur est un environnement isolé dans lequel un programme s'exécute avec ses propres outils. Il limite ce que le programme peut toucher sur la machine qui l'héberge. - **API REST** : Une API REST est une interface qui permet à des programmes de communiquer entre eux par des requêtes web. Elle sert par exemple à piloter un service à distance depuis une autre application. ## Questions fréquentes ### OpenHands Agent Canvas est-il gratuit et open source ? Le dépôt d'OpenHands est publié sous licence MIT. Le README mentionne aussi une offre commerciale, OpenHands Cloud, mais n'en donne pas le prix. ### Quels agents de code OpenHands Agent Canvas peut-il lancer ? OpenHands Agent Canvas lance l'agent OpenHands, Claude Code, Codex, Gemini CLI, Pi et OpenCode, ainsi que tout agent compatible avec l'Agent-Client Protocol (ACP). ### Comment installer OpenHands Agent Canvas ? Avec Node.js 24 ou plus récent et `uv`, la commande `npm install -g @openhands/agent-canvas` installe l'outil, puis `agent-canvas` le démarre. Une image Docker est aussi proposée pour isoler l'agent. ### OpenHands Agent Canvas est-il sûr à lancer sur son ordinateur ? Sans bac à sable, non : l'agent a un accès complet au système de fichiers de la machine. Avec l'option Docker, il n'accède qu'aux dossiers de projets que tu as montés. ## À retenir OpenHands Agent Canvas réunit dans une interface auto-hébergée plusieurs agents de code, des backends locaux, distants ou cloud, et des automatisations connectées à Slack ou GitHub. Le choix entre exécution directe et bac à sable Docker détermine ce que l'agent peut atteindre sur ta machine. Sources : - [OpenHands](https://github.com/OpenHands/OpenHands) (README) - [docs/README.md](https://github.com/openhands/openhands/blob/HEAD/docs/README.md) (documentation officielle) - [GitHub](https://github.com/openhands/openhands/releases) (notes de version) Mots-clés : agents, auto-hébergé, code, automatisation, acp --- Fiche publiée par Geekus : https://geekus.fr/projets/openhands/