OpenHands：AI 驱动的开发

Deutsch | Español | français | 日本語 | 한국어 | Português | Русский | 中文

🙌 欢迎来到 OpenHands，一个专注于 AI 驱动开发的社区。我们诚挚邀请您加入我们的 Slack 社区：点击这里。

您可以通过以下几种方式与 OpenHands 合作：

OpenHands 软件代理 SDK

SDK 是一个可组合的 Python 库，包含了我们所有的代理技术。它是驱动下方所有功能的核心引擎。

您可以在代码中定义代理，然后在本地运行，或者将其扩展到云端的上千个代理。

查看文档 或 查看源码

OpenHands CLI

CLI 是开始使用 OpenHands 的最简单方式。对于曾经使用过 Claude Code 或 Codex 等工具的人来说，这种体验会非常熟悉。您可以选择 Claude、GPT 或其他任何 LLM 来支持它。

查看文档 或 查看源码

OpenHands 本地 GUI

使用本地 GUI 可以在您的笔记本电脑上运行代理。它配备了一个 REST API 和一个单页 React 应用程序。对于使用过 Devin 或 Jules 的用户来说，这种体验会很熟悉。

查看文档 或在此仓库中查看源码。

OpenHands 云服务

这是 OpenHands GUI 的部署版本，运行在托管基础设施上。

您可以通过 使用 GitHub 或 GitLab 账户登录，免费试用 Minimax 模型。

OpenHands 云服务提供开源的功能和集成：

• 与 Slack、Jira 和 Linear 的集成
• 多用户支持
• RBAC 和权限管理
• 协作功能（例如对话共享）

OpenHands 企业版

大型企业可以与我们合作，在其自有 VPC 中通过 Kubernetes 自行部署 OpenHands 云服务。OpenHands 企业版同样支持上述的 CLI 和 SDK。

OpenHands 企业版是源码开放的——您可以在 enterprise/ 目录中查看所有源代码，但如果您希望运行超过一个月，则需要购买许可证。

企业合同还包含扩展支持以及与我们研究团队的合作机会。

更多信息请访问 openhands.dev/enterprise

其他内容

请查看我们的产品路线图，如果您有希望看到的功能，也欢迎随时提交一个问题！

您可能还会对我们提供的评估基础设施、Chrome 扩展或心智理论模块感兴趣。

我们所有的项目均采用 MIT 许可证开源，但本仓库中的 enterprise/ 目录除外（详情请参阅企业版许可证）。核心的 openhands 和 agent-server Docker 镜像同样完全遵循 MIT 许可证。

如果您在使用过程中遇到任何问题，或者只是想聊一聊，欢迎来 Slack 上找我们。

受到以下公司工程师的信赖：

OpenHands 快速上手指南

OpenHands 是一个由社区驱动的 AI 软件开发平台，旨在通过 AI 代理（Agent）辅助代码编写、调试和自动化任务。它提供 SDK、命令行工具（CLI）、本地图形界面（GUI）以及云端服务等多种使用方式。

环境准备

在开始之前，请确保您的开发环境满足以下要求：

• 操作系统：Linux, macOS 或 Windows (推荐 WSL2)。
• Python：版本 3.10 或更高。
• Docker：必须安装并正在运行（OpenHands 依赖 Docker 来隔离和执行代理任务）。
• Git：用于克隆仓库和管理版本。
• LLM API Key：准备一个可用的大模型 API 密钥（如 Anthropic Claude, OpenAI GPT 等），或者计划使用 OpenHands Cloud 的免费 Minimax 模型。

提示：国内用户若遇到 Docker 镜像拉取缓慢的问题，建议配置 Docker 国内镜像加速器。

安装步骤

根据您的使用偏好，可以选择以下三种主要安装方式之一：

方式一：使用命令行工具 (CLI) - 最轻量

适合习惯终端操作的开发者，体验类似 Claude Code。

1. 使用 pip 安装 OpenHands CLI：

   pip install openhands-cli
   

2. 设置您的 LLM API 密钥（以 Claude 为例）：

   export ANTHROPIC_API_KEY="your-api-key-here"
   

方式二：使用本地图形界面 (Local GUI) - 功能最全

适合希望在本地浏览器中获得类似 Devin 或 Jules 体验的开发者。

1. 克隆官方仓库：

   git clone https://github.com/OpenHands/OpenHands.git
   cd OpenHands
   

2. 使用 Docker Compose 启动服务：

   docker compose up
   

   启动完成后，通常在浏览器访问 http://localhost:3000 即可使用。

方式三：使用 Python SDK - 适合集成与扩展

适合需要将 AI 代理能力嵌入自有应用或进行大规模并发测试的开发者。

1. 安装 SDK：

   pip install openhands-ai
   

2. 查看详细文档：OpenHands SDK Docs

基本使用

1. CLI 模式使用示例

安装完成后，直接在终端运行以下命令即可开始与 AI 结对编程：

openhands

系统会提示您输入任务描述，例如：

"在当前目录下创建一个简单的 Python Flask 应用，包含一个返回 'Hello World' 的路由。"

AI 将自动分析需求、编写代码、执行命令并修复潜在错误。

2. 本地 GUI 模式使用示例

1. 启动 Docker 服务后，打开浏览器访问 http://localhost:3000。
2. 在设置页面配置您的 LLM Provider 和 API Key（支持 Claude, GPT, Ollama 等）。
3. 在主对话框中输入自然语言指令，例如：

   "帮我重构 src/utils.py 文件，优化其中的数据库连接逻辑，并添加单元测试。"

4. OpenHands 将在右侧沙箱环境中执行操作，您可以实时查看代码变更、终端输出和文件结构。

3. 免配置体验 (OpenHands Cloud)

如果您不想本地部署，可以直接使用托管服务：

1. 访问 app.all-hands.dev。
2. 使用 GitHub 或 GitLab 账号登录。
3. 默认即可使用 Minimax 模型免费尝试各项功能，无需配置 API Key。

更多高级功能（如企业级私有化部署、Slack/Jira 集成等）请参考官方文档或访问 openhands.dev。