software-agent-sdk

Q: 必须用哪个模型？

示例中使用 model=＂gpt-5.5＂，只要你的 API Key 对应服务支持该模型即可，否则请换成你有权限调用的模型名。

用模块化 SDK 快速搭出能干活儿的 AI Agent

开源 🏷️完全免费 🔧 仅开源项目，无在线服务，需自行部署开发框架 🍴 复刻 738 🐛 待处理 780 👀 关注 12

GitHub ↗

GitHub 星标 ★ 1341

维护状态活跃

是否开源开源

定价模式 🏷️完全免费开源免费，无在线服务

项目预览

software-agent-sdk 项目界面预览图 — 图片来源：GitHub 官方仓库名片

项目数据

分类开发框架

开发团队OpenHands

GitHubhttps://github.com/OpenHands/software-agent-sdk

定价模式🏷️完全免费

价格说明开源免费，无在线服务

访问状态🔧 仅开源项目，无在线服务，需自行部署

是否开源是

开源协议MIT

主要语言Python

技术栈/模型agent,sdk

GitHub 星标★ 1341

上线时间2025-08-23 00:00:00

代码更新2026-11-03

仓库体积58.5 MB

本站数据更新2026-11-03

维护状态活跃

收录时间2026-09-12

浏览次数1

项目介绍

software-agent-sdk 是 OpenHands 团队推出的模块化 Python SDK，用于构建 AI Agent，属于 OpenHands V1 的核心开发框架。它把 Agent 的构建过程拆解为清晰、可组合的组件，开发者无需从零搭建复杂的 Agent 运行时，就能快速接入工具调用、代码执行、多步任务规划等能力。SDK 强调简洁与模块化，让开发者可以按需替换或扩展各个模块，比如自定义工具、模型后端、执行环境等，从而适配不同业务场景。它解决的是 Agent 开发中重复造轮子、代码耦合度高、难以维护和扩展的问题，适合希望把 AI Agent 能力嵌入自身产品或做二次开发的团队。作为 OpenHands 生态的一部分，它能与 OpenHands 的运行时和工具链协同工作，降低从原型到落地的门槛。

Star 增长趋势

本站每日记录该项目 GitHub 星标变化，观测越久曲线越完整

数据来源：GitHub API 逐日快照 · 收录于 2026-09-12 · 当前星标 ★ 1341

技术标签

agent sdk

使用教程

ℹ 本教程由 AI 依据该项目 README 整理，个别步骤可能需要按你的环境微调。

难度：入门约 10 分钟部署方式：库/依赖 5 步

环境要求

Python 环境（SDK 为 Python 库）
Git 用于克隆仓库
GNU Make 用于执行 make build
一个可用的 LLM API Key（示例中读取 LLM_API_KEY 环境变量）

安装与启动步骤

1克隆仓库

从 GitHub 拉取 software-agent-sdk 源码到本地，后续所有操作都在该目录内进行。
```
git clone https://github.com/OpenHands/software-agent-sdk.git
```
2进入项目目录

切换到刚克隆下来的仓库根目录，make build 需要在此目录执行。
```
cd software-agent-sdk
```
3安装依赖

README 说明本地开发运行 make build，会安装 workspace 依赖与 pre-commit hooks。
```
make build
```
4配置 API Key

示例代码通过 os.getenv("LLM_API_KEY") 读取密钥，需先设置为环境变量再运行脚本。
```
export LLM_API_KEY=sk-xxxxxxxx
```
5运行示例脚本

把 Quick Start 代码保存为脚本后执行，即可创建 Agent 并跑通一次对话。
```
python quickstart.py
```

关键配置

配置项	必填	说明	示例
`LLM_API_KEY`	是	模型服务密钥，示例代码通过环境变量读取	`sk-xxxxxxxx`
`model`	是	传给 LLM 的模型名称，示例中为 gpt-5.5	`gpt-5.5`