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，更准确地反映其功能和目标。