OpenHands 简介
OpenHands[1] 是一个由人工智能和大型语言模型(LLMs)驱动的自动化软件开发平台,为了协助人类开发者编写代码、修复错误和发布功能。
项目特点
主要特点
协作开发:OpenHands的智能代理与人类开发者合作,共同完成编码任务。 多平台支持:适用于Linux、Mac OS以及Windows上的WSL。 Docker容器运行:通过Docker容器安全运行,保证系统其余部分不受影响。 模型与API集成:用户可以在设置中选择适当的模型和输入API密钥,以定制开发环境。
使用场景
开发新功能:快速编写代码,加速开发流程。 代码维护:修复现有代码库中的错误。 自动化测试:使用OpenHands进行自动化回归测试和性能评估。
项目使用
环境要求
OpenHands 最适合在 Docker 版本 26.0.0+ (Docker Desktop 4.31.0+) 下运行。 需要在 Linux、Mac OS 或 Windows 的 WSL 上使用。
启动 OpenHands
在终端中运行以下命令来启动 OpenHands 的 Docker 容器:
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/all-hands-ai/openhands:0.9
这个命令会启动 OpenHands 的 0.9 版本,这是 OpenHands 最新的稳定版本。如果你需要特定版本,可以使用 ghcr.io/all-hands-ai/openhands:<OpenHands_version>替换<OpenHands_version>为需要的版本号。对于最新的开发版本,可以使用 ghcr.io/all-hands-ai/openhands:main,但请注意这个版本可能不稳定,仅推荐用于测试或开发。
访问 OpenHands
启动后,你可以通过 http://localhost:3000访问 OpenHands。OpenHands 将只能访问 ./workspace文件夹中的代码。
设置模型和 API 密钥
打开 OpenHands 后,需要在自动弹出的设置中选择适当的模型并输入 API 密钥。 如果所需的模型不在列表中,可以在文本框中手动输入。
参考文档
官方文档[2] 提供了详细的使用指南和高级配置选项。 开发流程[3] 为开发者提供了开发工作流程的详细信息。 Discord服务器[4]:社区运行的服务器,用于一般讨论、问题和反馈。
项目原名为“OpenDevin”,现已更名为OpenHands,更准确地反映其功能和目标。
