30.8K Star！OpenHands：一个由 AI 和 LLMs 驱动的自动化软件开发平台，协助开发人员编写代码、修复错误

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
dockerrun-it\
--pull=always\
-eSANDBOX_USER_ID=$(id-u)\
-eWORKSPACE_MOUNT_PATH=$WORKSPACE_BASE\
-v$WORKSPACE_BASE:/opt/workspace_base\
-v/var/run/docker.sock:/var/run/docker.sock\
-p3000:3000\
--add-hosthost.docker.internal:host-gateway\
--nameopenhands-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，更准确地反映其功能和目标。