OpenHands SDK：AI 编码 Agent 开发包

项目简介

OpenHands Software Agent SDK 是一个干净、模块化的 SDK，用于构建能与代码协作的 AI Agent。它提供 Python、TypeScript 和 REST API，是 OpenHands CLI 与 OpenHands Cloud 背后的引擎。

Agent 既可以把本地机器作为工作区，也可以通过 Agent Server 运行在 Docker、Kubernetes 等临时工作区中。

主要功能

• 提供 Python SDK、浏览器兼容的 TypeScript 客户端以及 REST/WebSocket API
• 内置 Agent、工具、对话、工作区、事件等核心抽象
• 支持 Terminal、FileEditor、TaskTracker 等工具
• 支持自定义工具、MCP、Skills 与插件
• 支持本地工作区与远程 Agent Server 两种运行方式
• 仓库附带多组示例：独立 SDK、远程 Agent Server、GitHub 工作流、Skills 与插件

安装与使用

安装与详细配置请参考官方 Getting Started 文档：

https://docs.openhands.dev/sdk/getting-started

从本仓库进行本地开发时，可运行：

make build

最小使用示例：

import os

from openhands.sdk import LLM, Agent, Conversation, Tool
from openhands.tools.file_editor import FileEditorTool

llm = LLM(model="gpt-5.5", api_key=os.getenv("LLM_API_KEY"))
agent = Agent(llm=llm, tools=[Tool(name=FileEditorTool.name)])
conversation = Conversation(agent=agent, workspace=os.getcwd())
conversation.send_message("Write 3 facts about the current project into FACTS.txt.")
conversation.run()

examples/ 目录包含完整用法示例，文档地址为 https://docs.openhands.dev/sdk 。

注意事项

• 需要自行准备模型与 API Key，示例中通过环境变量 LLM_API_KEY 读取
• 使用远程工作区时需部署或连接 Agent Server
• 项目采用 MIT 许可证

---

本作品整理自 GitHub 开源项目 OpenHands/software-agent-sdk，原作者 @OpenHands，许可证 MIT。中文介绍由 AI 根据项目 README 整理，以原仓库为准。