mirror of
https://github.com/OpenHands/OpenHands.git
synced 2025-12-26 05:48:36 +08:00
01ae22ef57
* 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>
110 lines
4.6 KiB
Plaintext
110 lines
4.6 KiB
Plaintext
---
|
|
sidebar_position: 1
|
|
---
|
|
|
|
# 💻 OpenHands
|
|
|
|
OpenHands est un **ingénieur logiciel IA autonome** capable d'exécuter des tâches d'ingénierie complexes et de collaborer activement avec les utilisateurs sur des projets de développement logiciel.
|
|
Ce projet est entièrement open-source, vous pouvez donc l'utiliser et le modifier comme bon vous semble.
|
|
|
|
:::tip
|
|
Explorez le code source d'OpenHands sur [GitHub](https://github.com/All-Hands-AI/OpenHands) ou rejoignez l'une de nos communautés !
|
|
|
|
<a href="https://github.com/All-Hands-AI/OpenHands/graphs/contributors">
|
|
<img
|
|
src="https://img.shields.io/github/contributors/All-Hands-AI/OpenHands?style=for-the-badge"
|
|
alt="Contributors"
|
|
/>
|
|
</a>
|
|
<a href="https://github.com/All-Hands-AI/OpenHands/network/members">
|
|
<img
|
|
src="https://img.shields.io/github/forks/All-Hands-AI/OpenHands?style=for-the-badge"
|
|
alt="Forks"
|
|
/>
|
|
</a>
|
|
<a href="https://github.com/All-Hands-AI/OpenHands/stargazers">
|
|
<img
|
|
src="https://img.shields.io/github/stars/All-Hands-AI/OpenHands?style=for-the-badge"
|
|
alt="Stargazers"
|
|
/>
|
|
</a>
|
|
<a href="https://github.com/All-Hands-AI/OpenHands/issues">
|
|
<img
|
|
src="https://img.shields.io/github/issues/All-Hands-AI/OpenHands?style=for-the-badge"
|
|
alt="Issues"
|
|
/>
|
|
</a>
|
|
<br></br>
|
|
<a href="https://github.com/All-Hands-AI/OpenHands/blob/main/LICENSE">
|
|
<img
|
|
src="https://img.shields.io/github/license/All-Hands-AI/OpenHands?style=for-the-badge"
|
|
alt="MIT License"
|
|
/>
|
|
</a>
|
|
<br></br>
|
|
<a href="https://join.slack.com/t/openhands/shared_invite/zt-2ngejmfw6-9gW4APWOC9XUp1n~SiQ6iw">
|
|
<img
|
|
src="https://img.shields.io/badge/Slack-Join%20Us-red?logo=slack&logoColor=white&style=for-the-badge"
|
|
alt="Join our Slack community"
|
|
/>
|
|
</a>
|
|
<a href="https://discord.gg/ESHStjSjD4">
|
|
<img
|
|
src="https://img.shields.io/badge/Discord-Join%20Us-purple?logo=discord&logoColor=white&style=for-the-badge"
|
|
alt="Join our Discord community"
|
|
/>
|
|
</a>
|
|
:::
|
|
|
|
## 🛠️ Pour commencer
|
|
|
|
La manière la plus simple d'exécuter OpenHands est à l'intérieur d'un conteneur Docker. Il fonctionne mieux avec la version la plus récente de Docker, `26.0.0`.
|
|
Vous devez utiliser Linux, Mac OS ou WSL sur Windows.
|
|
|
|
Pour démarrer OpenHands dans un conteneur docker, exécutez les commandes suivantes dans votre terminal :
|
|
|
|
:::warning
|
|
Lorsque vous exécutez la commande suivante, les fichiers dans `./workspace` peuvent être modifiés ou supprimés.
|
|
:::
|
|
|
|
```bash
|
|
WORKSPACE_BASE=$(pwd)/workspace
|
|
docker run -it \
|
|
--pull=always \
|
|
-e SANDBOX_USER_ID=$(id -u) \
|
|
-e WORKSPACE_MOUNT_PATH=$WORKSPACE_BASE \
|
|
-v $WORKSPACE_BASE:/opt/workspace_base \
|
|
-v /var/run/docker.sock:/var/run/docker.sock \
|
|
-p 3000:3000 \
|
|
--add-host host.docker.internal:host-gateway \
|
|
--name openhands-app-$(date +%Y%m%d%H%M%S) \
|
|
ghcr.io/opendevin/opendevin:0.6
|
|
```
|
|
|
|
Vous trouverez OpenHands fonctionnant à l'adresse [http://localhost:3000](http://localhost:3000) avec accès à `./workspace`. Pour qu'OpenHands fonctionne sur votre code, placez-le dans `./workspace`.
|
|
|
|
OpenHands n'aura accès qu'à ce dossier de workspace. Le reste de votre système ne sera pas affecté car il s'exécute dans un bac à sable sécurisé de docker.
|
|
|
|
:::tip
|
|
Si vous souhaitez utiliser la version **(instable !)** la plus récente, vous pouvez utiliser `ghcr.io/opendevin/opendevin:main` comme image (dernière ligne).
|
|
:::
|
|
|
|
Pour le workflow de développement, consultez [Development.md](https://github.com/All-Hands-AI/OpenHands/blob/main/Development.md).
|
|
|
|
Avez-vous des problèmes ? Consultez notre [Guide de dépannage](https://docs.all-hands.dev/modules/usage/troubleshooting).
|
|
|
|
:::warning
|
|
OpenHands est actuellement en cours de développement, mais vous pouvez déjà exécuter la version alpha pour voir le système de bout en bout en action.
|
|
:::
|
|
|
|
[contributors-shield]: https://img.shields.io/github/contributors/All-Hands-AI/OpenHands?style=for-the-badge
|
|
[contributors-url]: https://github.com/All-Hands-AI/OpenHands/graphs/contributors
|
|
[forks-shield]: https://img.shields.io/github/forks/All-Hands-AI/OpenHands?style=for-the-badge
|
|
[forks-url]: https://github.com/All-Hands-AI/OpenHands/network/members
|
|
[stars-shield]: https://img.shields.io/github/stars/All-Hands-AI/OpenHands?style=for-the-badge
|
|
[stars-url]: https://github.com/All-Hands-AI/OpenHands/stargazers
|
|
[issues-shield]: https://img.shields.io/github/issues/All-Hands-AI/OpenHands?style=for-the-badge
|
|
[issues-url]: https://github.com/All-Hands-AI/OpenHands/issues
|
|
[license-shield]: https://img.shields.io/github/license/All-Hands-AI/OpenHands?style=for-the-badge
|
|
[license-url]: https://github.com/All-Hands-AI/OpenHands/blob/main/LICENSE
|