OpenHands: Code Less, Make More

欢迎使用 OpenHands（原 OpenDevin），这是一个由 AI 驱动的软件开发代理平台。

OpenHands 代理可以完成人类开发者能做的所有事情：修改代码、运行命令、浏览网页、调用 API，甚至还能从 StackOverflow 复制代码片段。

了解更多请访问 docs.all-hands.dev，或立即注册 OpenHands Cloud 开始使用。

[!IMPORTANT] 正在工作中使用 OpenHands？我们期待与您交流！填写这份简短表单加入我们的设计合作伙伴计划，您将获得商业功能的早期访问权限，并有机会为产品路线图提供建议。

应用截图

☁️ OpenHands 云服务

体验 OpenHands 最简单的方式是通过 OpenHands Cloud，新用户注册即可获得 20 美元免费额度。

💻 本地运行 OpenHands

您也可以使用 Docker 在本地系统运行 OpenHands。查看运行 OpenHands 指南了解系统要求和更多信息。

[!WARNING] 在公共网络环境下使用？请参阅我们的强化版 Docker 安装指南，通过限制网络绑定和实施额外安全措施来保护您的部署。

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

docker run -it --rm --pull=always \
    -e SANDBOX_RUNTIME_CONTAINER_IMAGE=docker.all-hands.dev/all-hands-ai/runtime:0.48-nikolaik \
    -e LOG_ALL_EVENTS=true \
    -v /var/run/docker.sock:/var/run/docker.sock \
    -v ~/.openhands:/.openhands \
    -p 3000:3000 \
    --add-host host.docker.internal:host-gateway \
    --name openhands-app \
    docker.all-hands.dev/all-hands-ai/openhands:0.48

注意：如果您使用的 OpenHands 版本低于 0.44，可能需要执行 mv ~/.openhands-state ~/.openhands 命令将聊天记录迁移至新位置。

OpenHands 将在 http://localhost:3000 运行！

首次打开应用时，系统会提示您选择 LLM 提供商并添加 API 密钥。推荐使用 Anthropic 的 Claude Sonnet 4 (anthropic/claude-sonnet-4-20250514)，但您也可以选择其他多种方案。

💡 其他运行 OpenHands 的方式

[!WARNING] OpenHands 设计为在本地工作站由单一用户运行，不适合多租户部署场景（即多个用户共享同一实例）。该系统未内置身份验证、隔离或扩展功能。

如需在多租户环境中运行 OpenHands，请查看采用商业许可、源码可用的 OpenHands 云 Helm Chart

您可以：

将 OpenHands 连接到本地文件系统
以可编写脚本的无头模式运行
通过友好的 CLI 交互
使用 GitHub Action 处理标记问题

更多信息及安装说明请访问运行 OpenHands。

如需修改 OpenHands 源代码，请查阅 Development.md。

遇到问题？故障排除指南可能帮到您。

📖 文档

想了解更多项目信息及使用技巧，请查阅我们的文档。

您将在文档中找到不同LLM提供商的使用方法、故障排查资源以及高级配置选项。

🤝 加入社区

OpenHands是一个社区驱动的项目，我们欢迎所有人的贡献。我们主要通过Slack进行交流，这是最佳的入门渠道，同时也欢迎通过Discord或Github联系我们：

加入Slack工作区 - 这里讨论研究、架构和未来开发
加入Discord服务器 - 社区运营的通用讨论、问答和反馈平台
查看或提交Github Issues - 浏览当前工作议题或提出您的想法

更多社区详情请参阅COMMUNITY.md，贡献指南详见CONTRIBUTING.md。

📈 项目进展

查看OpenHands月度路线图请点击此处（每月末维护者会议更新）。

📜 许可证

基于MIT许可证分发。详见LICENSE文件。

🙏 致谢

OpenHands由众多贡献者共同构建，我们衷心感谢每一份贡献！同时我们也基于其他开源项目，对这些项目的工作深表感激。

OpenHands使用的开源项目及许可证列表请见CREDITS.md文件。

📚 引用

@inproceedings{
  wang2025openhands,
  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},
  booktitle={The Thirteenth International Conference on Learning Representations},
  year={2025},
  url={https://openreview.net/forum?id=OJd3ayDDoF}
}