Exécution d'OpenHands
Configuration système requise
- MacOS avec support Docker Desktop
- Linux
- Windows avec WSL et support Docker Desktop
Un système avec un processeur moderne et un minimum de 4 Go de RAM est recommandé pour exécuter OpenHands.
Prérequis
MacOS
Docker Desktop
- Installer Docker Desktop sur Mac.
- Ouvrez Docker Desktop, allez dans
Settings > Advanced
et assurez-vous queAllow the default Docker socket to be used
est activé.
Linux
Windows
WSL
- Installer WSL.
- Exécutez
wsl --version
dans powershell et confirmezDefault Version: 2
.
Docker Desktop
- Installer Docker Desktop sur Windows.
- Ouvrez Docker Desktop, allez dans
Settings
et confirmez les points suivants :
- General:
Use the WSL 2 based engine
est activé. - Resources > WSL Integration:
Enable integration with my default WSL distro
est activé.
La commande docker ci-dessous pour démarrer l'application doit être exécutée dans le terminal WSL.
Démarrer l'application
La façon la plus simple d'exécuter OpenHands est dans Docker.
docker pull docker.all-hands.dev/all-hands-ai/runtime:0.37-nikolaik
docker run -it --rm --pull=always \
-e SANDBOX_RUNTIME_CONTAINER_IMAGE=docker.all-hands.dev/all-hands-ai/runtime:0.37-nikolaik \
-e LOG_ALL_EVENTS=true \
-v /var/run/docker.sock:/var/run/docker.sock \
-v ~/.openhands-state:/.openhands-state \
-p 3000:3000 \
--add-host host.docker.internal:host-gateway \
--name openhands-app \
docker.all-hands.dev/all-hands-ai/openhands:0.37
Vous trouverez OpenHands en cours d'exécution à l'adresse http://localhost:3000 !
Vous pouvez également connecter OpenHands à votre système de fichiers local, exécuter OpenHands en mode headless scriptable, interagir avec lui via une CLI conviviale, ou l'exécuter sur des problèmes étiquetés avec une action GitHub.
Configuration
Après avoir lancé OpenHands, vous devez sélectionner un LLM Provider
et un LLM Model
et saisir une API Key
correspondante.
Cela peut être fait lors de la fenêtre contextuelle des paramètres initiaux ou en sélectionnant le bouton Settings
(icône d'engrenage) dans l'interface utilisateur.
Si le modèle requis n'existe pas dans la liste, vous pouvez activer les options Advanced
et le saisir manuellement avec le préfixe correct
dans la zone de texte Custom Model
.
Les options Advanced
vous permettent également de spécifier une Base URL
si nécessaire.
Obtenir une clé API
OpenHands nécessite une clé API pour accéder à la plupart des modèles de langage. Voici comment obtenir une clé API auprès des fournisseurs recommandés :
Anthropic (Claude)
Envisagez de définir des limites d'utilisation pour contrôler les coûts.
OpenAI
Vous êtes maintenant prêt à commencer avec OpenHands.
Versions
La commande docker ci-dessus extrait la version stable la plus récente d'OpenHands. Vous avez également d'autres options :
- Pour une version spécifique, remplacez $VERSION dans
openhands:$VERSION
etruntime:$VERSION
par le numéro de version. Nous utilisons SemVer, donc0.9
pointera automatiquement vers la dernière version0.9.x
, et0
pointera vers la dernière version0.x.x
. - Pour la version de développement la plus à jour, remplacez $VERSION dans
openhands:$VERSION
etruntime:$VERSION
parmain
. Cette version est instable et est recommandée uniquement à des fins de test ou de développement.
Pour le flux de travail de développement, consultez Development.md.
Vous rencontrez des problèmes ? Consultez notre Guide de dépannage.