Last translated: 17 Jun 2025

Translation Not Available Yet

This repository's README hasn't been translated yet. Once translated, it will be easier to read and understand in your native language (中文).

After translating, add the links to README so others can view it directly.

Logo

OpenHands:少写代码,多创成果

欢迎使用 OpenHands(原 OpenDevin),这是一个由 AI 驱动的软件开发智能体平台。

OpenHands 智能体可以完成人类开发者能做的所有工作:修改代码、运行命令、浏览网页、调用 API,甚至还能从 StackOverflow 复制代码片段。

访问 docs.all-hands.dev 了解更多,或注册 OpenHands 云服务立即开始体验。

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

应用截图

☁️ OpenHands 云服务

体验 OpenHands 最简单的方式是使用 OpenHands 云服务,新用户可获得 50 美元免费额度。

💻 本地运行 OpenHands

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

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

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

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

注意:如果您使用过 0.44 版本之前的 OpenHands,可能需要执行 mv ~/.openhands-state ~/.openhands 来迁移对话历史到新位置。

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

首次打开应用时,您需要选择 LLM 提供商并添加 API 密钥。Anthropic 的 Claude Sonnet 4 (anthropic/claude-sonnet-4-20250514) 表现最佳,但您还有多种选择

💡 其他运行方式

[!CAUTION] OpenHands 设计为在本地工作站由单个用户使用。不适合多租户部署场景,不具备内置的身份验证、隔离或扩展能力。

如需在多租户环境中运行 OpenHands,请联系我们获取高级部署方案。

您还可以:

更多设置说明请参阅运行指南

如需修改 OpenHands 源代码,请查看 Development.md

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

📖 文档

Ask DeepWiki

了解更多项目信息和使用技巧,请查阅我们的文档

您将找到关于不同 LLM 提供商的使用方法、故障排除资源和高级配置选项。

🤝 加入社区

OpenHands 是社区驱动的项目,欢迎所有人参与贡献。我们主要通过 Slack 交流,但您也可以通过 Discord 或 GitHub 联系我们:

更多社区信息请见 COMMUNITY.md,贡献指南详见 CONTRIBUTING.md

📈 项目进展

每月路线图更新请见此处(维护者会议每月末更新)。

Star History Chart

📜 许可证

基于 MIT 许可证分发,详见 LICENSE

🙏 致谢

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},
}