OSFRIA Découvrir les outils

OSIALab · Coder avec l'IA

OpenHands — l'agent de développement qui agit sur le code

OpenHands (ex-OpenDevin) est un agent de développement autonome : on lui confie un objectif, il lit, écrit et exécute du code dans un environnement Docker isolé, jusqu'à aboutir ou signaler qu'il bloque. Puissant — et à manier avec méthode.

Page informative, sans valeur de conseil. OpenHands exécute du code et des commandes. Lisez les points de vigilance avant tout usage, installez depuis la source officielle et vérifiez la licence.

À quoi ça sert

OpenHands est un environnement d'agent capable de mener une tâche de développement de bout en bout. Vous formulez un objectif (« corrige le bug de l'issue #42 et ajoute un test de non-régression ») ; l'agent planifie, écrit du code, lance des commandes dans un conteneur d'exécution isolé, lit les sorties et itère. Une interface web sur localhost:3000 permet de suivre et de piloter chaque étape. C'est le projet anciennement connu sous le nom OpenDevin.

Ce qui fait sa force

  • Une vraie boucle d'agent. Là où un assistant suggère, OpenHands agit : il enchaîne édition, exécution, lecture des résultats et correction — exactement ce qu'on attend pour automatiser une tâche complète.
  • Exécution sandboxée par défaut. Le code tourne dans un conteneur d'exécution dédié, séparé de votre système. L'isolation est au cœur de l'architecture, pas un ajout.
  • Le modèle reste votre choix. OpenHands se branche sur le LLM que vous fournissez (Anthropic, OpenAI ou compatible). Les grands modèles s'en sortent en général mieux sur les tâches longues, mais rien n'est imposé.
  • Interface web pour garder la main. On suit le raisonnement, on interrompt, on corrige — la supervision est intégrée, pas optionnelle.
  • Cœur sous licence MIT. Le projet et ses images Docker principales sont MIT, donc réutilisables largement (voir la nuance sur le répertoire enterprise/ plus bas).

Pour qui

Pour le développeur expérimenté qui maîtrise Docker et git, et comprend ce qu'implique l'exécution de code autonome. Ce n'est pas un premier pas : pour découvrir l'IA qui code, commencez par Continue ou Aider. Pour un agent plus léger, intégré à VS Code, voyez Cline.

Attention. OpenHands exécute du code. Le conteneur limite la portée, mais l'agent peut écrire des fichiers, faire des requêtes réseau et — selon la configuration — accéder à des volumes que vous montez. Supervisez chaque session ; ne le pointez jamais sur de la production sans précautions strictes.

Installation

Prérequis

Docker est indispensable (installez-le depuis docker.com). Il faut un modèle : une clé API (Anthropic, OpenAI ou compatible), ou un modèle local servi par Ollama ou LM Studio, qui demande alors une machine solide et un grand contexte (environ 22 000 jetons au moins).

Lancer OpenHands

Source officielle : github.com/OpenHands/OpenHands. Les numéros de version évoluent vite : vérifiez la commande à jour dans la documentation officielle. À titre indicatif, la forme actuelle :

À savoir avant de copier une commande : l'interface locale d'OpenHands ne demande pas de connexion, et la commande monte le socket Docker : quiconque atteint le port 3000 peut piloter un agent qui lance des conteneurs sur votre machine, avec votre clé API. Sans adresse précisée, Docker publie le port sur toutes les adresses de la machine ; la commande ci-dessous le limite donc à 127.0.0.1, comme le recommande la section « Hardened Docker Installation » de la documentation d'OpenHands. À réserver à une machine de confiance (voir « Points de vigilance »).

docker run -it --rm --pull=always \
  -e AGENT_SERVER_IMAGE_REPOSITORY=ghcr.io/openhands/agent-server \
  -e AGENT_SERVER_IMAGE_TAG=1.26.0-python \
  -e LOG_ALL_EVENTS=true \
  -v /var/run/docker.sock:/var/run/docker.sock \
  -v ~/.openhands:/.openhands \
  -p 127.0.0.1:3000:3000 \
  --add-host host.docker.internal:host-gateway \
  --name openhands-app \
  docker.openhands.dev/openhands/openhands:1.8

Ouvrez ensuite http://localhost:3000, renseignez votre clé API LLM et définissez le répertoire de travail.

Points de vigilance

Le risque n'est pas une « machine qui ralentit » : c'est un agent qui exécute réellement du code. L'isolation Docker réduit la surface, sans la supprimer. Les vrais points :

Point d'attention Niveau Ce qu'il faut savoir
Exécution de code et de commandes par l'agent 🔴 réel OpenHands crée, modifie, supprime des fichiers et lance des commandes dans son conteneur. Supervisez chaque session, ne le lancez que sur un dépôt isolé (copie ou branche), jamais sur de la production sans filet.
Socket Docker monté (/var/run/docker.sock) 🔴 selon configuration Monter le socket Docker accorde des droits étendus sur l'hôte : à réserver au développement local, sur une machine de confiance. Ne le faites pas sur un serveur partagé ou exposé.
Volumes montés trop larges 🟡 selon configuration Ne montez que les répertoires nécessaires. Éviter de monter le dossier personnel ou des chemins contenant des secrets limite ce que l'agent peut lire ou modifier.
Code et contexte envoyés au LLM 🟡 selon provider OpenHands s'appuie sur un LLM externe : fichiers, commandes et sorties transitent vers le provider. N'y travaillez pas sur des données sensibles sans en mesurer l'envoi.
Consommation de tokens sur tâches longues 🟡 selon usage Une boucle d'agent peut consommer beaucoup de tokens. Fixez des limites de dépense côté provider et surveillez la consommation.
Licence : cœur MIT, sauf enterprise/ 🟡 à vérifier Le cœur d'OpenHands et ses images principales sont sous licence MIT ; le répertoire enterprise/ relève d'une licence dédiée. Lisez la licence du modèle LLM avant un usage commercial.
Réglages par défaut accordant un accès large à la machine 🟡 à vérifier avant usage Certains réglages par défaut d'OpenHands donnent au conteneur un accès étendu à l'hôte (socket Docker, volumes). Avant de lancer une session, vérifiez la configuration et montez uniquement les répertoires nécessaires — c'est ce qui aide le bac à sable à rester un bac à sable.

Sécurité

  • Dépôt isolé, toujours. Copie ou branche dédiée ; traitez le code produit comme du code externe : revue, tests, validation avant merge.
  • Socket Docker en local uniquement. Jamais sur une machine partagée ou exposée à Internet.
  • Restreignez volumes et réseau. Montez le strict nécessaire ; en contexte sensible, limitez l'accès réseau du conteneur.
  • Protégez la clé API. Gestionnaire de secrets ou variable d'environnement, jamais dans une image ou un fichier commité.

Aller plus loin

  • Dépôt officiel OpenHands — code, releases, guide de démarrage.
  • Documentation OpenHands — configuration détaillée et bonnes pratiques.
  • Cline — agent plus léger, intégré à VS Code, validation pas à pas.
  • Aider — assistant terminal centré git, plus prévisible.
  • OSIALab — comparer tous les outils pour coder avec l'IA.

Sources