* Replace OpenDevin with OpenHands * Update CONTRIBUTING.md * Update README.md * Update README.md * update poetry lock; move opendevin folder to openhands * fix env var * revert image references in docs * revert permissions * revert permissions --------- Co-authored-by: Xingyao Wang <xingyao6@illinois.edu>
3.1 KiB
Notes pour les utilisateurs de Windows et WSL
OpenHands ne supporte Windows que via WSL. Veuillez vous assurer de lancer toutes les commandes à l'intérieur de votre terminal WSL.
Dépannage
Erreur : 'docker' n'a pas pu être trouvé dans cette distribution WSL 2.
Si vous utilisez Docker Desktop, assurez-vous de le démarrer avant d'exécuter toute commande docker depuis l'intérieur de WSL. Docker doit également avoir l'option d'intégration WSL activée.
Recommandation : Ne pas exécuter en tant qu'utilisateur root
Pour des raisons de sécurité, il est fortement recommandé de ne pas exécuter OpenHands en tant qu'utilisateur root, mais en tant qu'utilisateur avec un UID non nul. De plus, les sandboxes persistants ne seront pas pris en charge lors de l'exécution en tant que root et un message approprié pourrait apparaître lors du démarrage d'OpenHands.
Références :
- Pourquoi il est mauvais de se connecter en tant que root
- Définir l'utilisateur par défaut dans WSL Astuce pour la 2e référence : pour les utilisateurs d'Ubuntu, la commande pourrait en fait être "ubuntupreview" au lieu de "ubuntu".
Échec de la création de l'utilisateur openhands
Si vous rencontrez l'erreur suivante lors de l'installation :
Exception: Failed to create openhands user in sandbox: 'useradd: UID 0 is not unique'
Vous pouvez la résoudre en exécutant :
export SANDBOX_USER_ID=1000
Installation de Poetry
- Si vous rencontrez des problèmes pour exécuter Poetry même après l'avoir installé pendant le processus de construction, il peut être nécessaire d'ajouter son chemin binaire à votre environnement :
export PATH="$HOME/.local/bin:$PATH"
- Si
make builds'arrête avec une erreur telle que :
ModuleNotFoundError: no module named <module-name>
Cela pourrait être un problème avec le cache de Poetry. Essayez d'exécuter ces 2 commandes l'une après l'autre :
rm -r ~/.cache/pypoetry
make build
L'objet NoneType n'a pas d'attribut 'request'
Si vous rencontrez des problèmes liés au réseau, tels que NoneType object has no attribute 'request' lors de l'exécution de make run, il peut être nécessaire de configurer vos paramètres réseau WSL2. Suivez ces étapes :
- Ouvrez ou créez le fichier
.wslconfigsitué àC:\Users\%username%\.wslconfigsur votre machine hôte Windows. - Ajoutez la configuration suivante au fichier
.wslconfig:
[wsl2]
networkingMode=mirrored
localhostForwarding=true
- Enregistrez le fichier
.wslconfig. - Redémarrez WSL2 complètement en quittant toute instance WSL2 en cours d'exécution et en exécutant la commande
wsl --shutdowndans votre invite de commande ou terminal. - Après avoir redémarré WSL, essayez d'exécuter
make runà nouveau. Le problème réseau devrait être résolu.