Aller directement au contenu principal

Installation

Configuration système requise​

  • Docker version 26.0.0+ ou Docker Desktop 4.31.0+.
  • Vous devez utiliser Linux ou Mac OS.
    • Si vous êtes sous Windows, vous devez utiliser WSL.

Démarrer l'application​

La façon la plus simple d'exécuter OpenHands est avec Docker.

docker pull docker.all-hands.dev/all-hands-ai/runtime:0.20-nikolaik

docker run -it --rm --pull=always \
    -e SANDBOX_RUNTIME_CONTAINER_IMAGE=docker.all-hands.dev/all-hands-ai/runtime:0.20-nikolaik \
    -e LOG_ALL_EVENTS=true \
    -v /var/run/docker.sock:/var/run/docker.sock \
    -p 3000:3000 \
    --add-host host.docker.internal:host-gateway \
    --name openhands-app \
    docker.all-hands.dev/all-hands-ai/openhands:0.20

Vous pouvez également exécuter OpenHands en mode headless scriptable, en tant que CLI interactive, ou en utilisant l'Action GitHub OpenHands.

Configuration​

Après avoir exécuté la commande ci-dessus, vous trouverez OpenHands en cours d'exécution à l'adresse http://localhost:3000.

Au lancement d'OpenHands, vous verrez une fenêtre modale de paramètres. Vous devez sélectionner un Fournisseur LLM et un Modèle LLM, et entrer une Clé API correspondante. Ces paramètres peuvent être modifiés à tout moment en sélectionnant le bouton Paramètres (icône d'engrenage) dans l'interface utilisateur.

Si le Modèle LLM requis n'existe pas dans la liste, vous pouvez activer les Options avancées et l'entrer manuellement avec le préfixe correct dans la zone de texte Modèle personnalisé. Les Options avancées vous permettent également de spécifier une URL de base si nécessaire.

settings-modalsettings-modal

Versions​

La commande ci-dessus récupère la version stable la plus récente d'OpenHands. Vous avez également d'autres options :

  • Pour une version spécifique, utilisez docker.all-hands.dev/all-hands-ai/openhands:$VERSION, en remplaçant $VERSION par le numéro de version.
  • Nous utilisons semver et publions des tags majeurs, mineurs et de patch. Ainsi, 0.9 pointera automatiquement vers la dernière version 0.9.x, et 0 pointera vers la dernière version 0.x.x.
  • Pour la version de développement la plus à jour, vous pouvez utiliser docker.all-hands.dev/all-hands-ai/openhands:main. Cette version est instable et n'est recommandée qu'à des fins de test ou de développement.

Vous pouvez choisir le tag qui convient le mieux à vos besoins en fonction des exigences de stabilité et des fonctionnalités souhaitées.

Pour le workflow de développement, consultez Development.md.

Vous rencontrez des problèmes ? Consultez notre Guide de dépannage.