---

欢迎来到 OpenHands（以前称为 OpenDevin），这是一个由 AI 驱动的软件开发代理平台。

OpenHands 的代理可以做到人类开发者所能做的一切：修改代码、运行指令、浏览网页、调用 API，甚至可以从 StackOverflow 中复制代码片段。

在 docs.all-hands.dev 可以了解更多信息，或者直接跳转至 快速入门。

⚡ 快速入门

运行 OpenHands 最简单的方法是使用 Docker。请查阅安装指南，了解系统要求和更多信息。

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

docker run -it --pull=always \
    -e SANDBOX_RUNTIME_CONTAINER_IMAGE=docker.all-hands.dev/all-hands-ai/runtime:0.14-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.14

你将在 http://localhost:3000 找到运行中的 OpenHands！

最后，你还需要一个模型提供者和 API 密钥。Anthropic 的 Claude 3.5 Sonnet（anthropic/claude-3-5-sonnet-20241022）表现最佳，但你有很多选择。

你还可以连接 OpenHands 到本地文件系统， 以可脚本化的无头模式运行 OpenHands， 通过友好的 CLI与其交互， 或使用 Github Action 运行已标记的问题。

访问安装指南，获取更多信息和设置说明。

如果你想修改 OpenHands 的源码，查看 Development.md。

遇到问题了吗？故障排除指南可以提供帮助。

📖 文档

为了更好地了解项目，以及获取使用 OpenHands 的技巧， 请查看我们的文档。

您将在那里找到有关如何使用不同大语言模型提供者的资源、故障排除资源及高级配置选项。

🤝 如何加入社区

OpenHands 是一个以社区为驱动的项目，我们欢迎大家的贡献。我们主要通过 Slack 进行沟通，这里是最好的开始，当然你也可以通过 Discord 或 Github 联系我们：

• 加入我们的 Slack 工作空间 - 在这里，我们讨论研究、架构和未来发展。
• 加入我们的 Discord 服务器 - 这是一个由社区经营的服务器，用于一般讨论、问题和反馈。
• 阅读或发布 Github 问题 - 查看我们正在解决的问题，或添加你自己的想法。

在 COMMUNITY.md 中查看更多关于社区的信息，或在 CONTRIBUTING.md 中找到贡献的细节。

📈 进展

📜 许可

基于 MIT 许可证发布。有关更多信息，请参见 LICENSE。

🙏 致谢

OpenHands 由许多贡献者构建，每个贡献都非常感谢！我们也借鉴了其他开源项目，深表谢意。

有关 OpenHands 使用的开源项目和许可证的列表，请参见我们的 CREDITS.md 文件。

📚 引用

@misc{openhands,
      title={{OpenHands: An Open Platform for AI Software Developers as Generalist Agents}},
      author={Xingyao Wang and Boxuan Li and Yufan Song and Frank F. Xu and Xiangru Tang and Mingchen Zhuge and Jiayi Pan and Yueqi Song and Bowen Li and Jaskirat Singh and Hoang H. Tran and Fuqiang Li and Ren Ma and Mingzhang Zheng and Bill Qian and Yanjun Shao and Niklas Muennighoff and Yizhe Zhang and Binyuan Hui and Junyang Lin and Robert Brennan and Hao Peng and Heng Ji and Graham Neubig},
      year={2024},
      eprint={2407.16741},
      archivePrefix={arXiv},
      primaryClass={cs.SE},
      url={https://arxiv.org/abs/2407.16741},
}