installation.mdx 3.6 KB

1234567891011121314151617181920212223242526272829303132333435363738394041424344454647484950515253545556575859606162636465
  1. # Installation
  2. ## Configuration requise
  3. * Docker version 26.0.0+ ou Docker Desktop 4.31.0+.
  4. * Vous devez utiliser Linux ou Mac OS.
  5. * Si vous êtes sous Windows, vous devez utiliser [WSL](https://learn.microsoft.com/en-us/windows/wsl/install).
  6. ## Démarrer l'application
  7. La façon la plus simple d'exécuter OpenHands est avec Docker. Vous pouvez modifier `WORKSPACE_BASE` ci-dessous pour pointer OpenHands vers
  8. du code existant que vous souhaitez modifier.
  9. ```bash
  10. export WORKSPACE_BASE=$(pwd)/workspace
  11. docker pull ghcr.io/all-hands-ai/runtime:0.11-nikolaik
  12. docker run -it --pull=always \
  13. -e SANDBOX_RUNTIME_CONTAINER_IMAGE=ghcr.io/all-hands-ai/runtime:0.11-nikolaik \
  14. -e SANDBOX_USER_ID=$(id -u) \
  15. -e WORKSPACE_MOUNT_PATH=$WORKSPACE_BASE \
  16. -v $WORKSPACE_BASE:/opt/workspace_base \
  17. -v /var/run/docker.sock:/var/run/docker.sock \
  18. -p 3000:3000 \
  19. --add-host host.docker.internal:host-gateway \
  20. --name openhands-app-$(date +%Y%m%d%H%M%S) \
  21. ghcr.io/all-hands-ai/openhands:0.11
  22. ```
  23. Vous pouvez également exécuter OpenHands en mode [headless scriptable](https://docs.all-hands.dev/modules/usage/how-to/headless-mode), comme un [CLI interactif](https://docs.all-hands.dev/modules/usage/how-to/cli-mode), ou en utilisant l'[Action GitHub OpenHands](https://docs.all-hands.dev/modules/usage/how-to/github-action).
  24. ## Configuration
  25. Après avoir exécuté la commande ci-dessus, vous trouverez OpenHands en cours d'exécution à l'adresse [http://localhost:3000](http://localhost:3000).
  26. L'agent aura accès au dossier `./workspace` pour effectuer son travail. Vous pouvez copier du code existant ici, ou modifier `WORKSPACE_BASE` dans la
  27. commande pour pointer vers un dossier existant.
  28. 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.
  29. Ceux-ci peuvent être modifiés à tout moment en sélectionnant le bouton `Paramètres` (icône d'engrenage) dans l'interface utilisateur.
  30. Si le `Modèle LLM` requis n'existe pas dans la liste, vous pouvez activer les `Options avancées` et le saisir manuellement avec le préfixe correct
  31. dans la zone de texte `Modèle personnalisé`.
  32. Les `Options avancées` vous permettent également de spécifier une `URL de base` si nécessaire.
  33. <div style={{ display: 'flex', justifyContent: 'center', gap: '20px' }}>
  34. <img src="/img/settings-screenshot.png" alt="settings-modal" width="340" />
  35. <img src="/img/settings-advanced.png" alt="settings-modal" width="335" />
  36. </div>
  37. ## Versions
  38. La commande ci-dessus récupère la version stable la plus récente d'OpenHands. Vous avez également d'autres options :
  39. - Pour une version spécifique, utilisez `ghcr.io/all-hands-ai/openhands:$VERSION`, en remplaçant $VERSION par le numéro de version.
  40. - Nous utilisons semver et publions des tags majeurs, mineurs et de correctifs. Ainsi, `0.9` pointera automatiquement vers la dernière version `0.9.x`, et `0` pointera vers la dernière version `0.x.x`.
  41. - Pour la version de développement la plus à jour, vous pouvez utiliser `ghcr.io/all-hands-ai/openhands:main`. Cette version est instable et n'est recommandée qu'à des fins de test ou de développement.
  42. Vous pouvez choisir le tag qui correspond le mieux à vos besoins en fonction des exigences de stabilité et des fonctionnalités souhaitées.
  43. Pour le workflow de développement, consultez [Development.md](https://github.com/All-Hands-AI/OpenHands/blob/main/Development.md).
  44. Vous rencontrez des problèmes ? Consultez notre [Guide de dépannage](https://docs.all-hands.dev/modules/usage/troubleshooting).