andrewyng/aisuite

开源 Python 库,用统一接口调用多家 LLM 并构建 Agent

开源 Python 库,用统一接口调用多家 LLM 并构建 Agent

产品定位

aisuite 的定位是轻量级的 LLM 开发框架,分为两层:跨提供商的统一 Chat Completions API 和其上的 Agents API。它与直接使用各厂商官方 SDK 的差异在于提供商无关性——切换模型只需更改一个字符串。选型时需注意:调用云提供商需自行准备相应 API key 并承担其费用,本地运行需通过 Ollama。库本身以 MIT 许可证开源,可免费商用。基于它构建的桌面应用 OpenWorker 已迁移至独立仓库 开发。

适合用户

  • 开发者
  • AI 应用构建者
  • 开源贡献者

功能亮点

  • 统一 Chat Completions API

    提供 OpenAI 风格的统一接口,可通过更改一个模型字符串切换 OpenAI、Anthropic、Google、Ollama 等提供商。

  • Agents API 与工具包

    声明 Agent 并用 Runner 运行,可将普通 Python 函数作为工具,附加预构建的沙箱化工具包(文件、git、shell),支持多轮工具调用循环。

  • MCP 工具支持

    原生支持 Model Context Protocol,可将任意 MCP 服务器的工具交给模型,支持内联配置或显式 MCPClient。

  • 流式输出

    支持 stream=True,从兼容提供商获取 OpenAI 形状的流式分块。

  • 工具策略、状态存储与追踪

    提供 RequireApprovalPolicy 等工具策略、内存/文件/Postgres 状态存储以持久化和恢复运行,以及产物存储与追踪。

使用步骤

快速开始多提供商对话调用

  1. pip 安装 aisuite(基础包或带提供商 SDK 的版本)
  2. 设置所需提供商的 API key(环境变量或 Client 构造函数)
  3. 使用统一接口调用模型,需要切换提供商时更改模型字符串

构建带工具的 Agent

  1. 定义普通 Python 函数作为工具(aisuite 自动生成 schema)
  2. 声明 Agent 并附加工具包(files、git、shell)或 MCP 工具
  3. 用 Runner.run 运行,可选配置工具策略与状态存储

适用场景

一套代码切换多家 LLM 提供商

开发者

通过统一的 OpenAI 风格接口,仅更改模型名字符串即可在 OpenAI、Anthropic、Google、Ollama 等提供商之间切换。

构建带工具调用的多模型 Agent

AI 应用构建者

使用 Agents API、工具包与 MCP 支持构建可执行实际任务的 Agent 应用。

访问与价格

可用状态: 当前可用

价格信息: 开源

支持平台: API, 自托管

价格说明: aisuite 以 MIT 许可证开源发布,可免费用于商业和非商业用途;但调用各 LLM 提供商需自行承担其 API 费用。

官方入口

常见问题

如何安装 aisuite?

通过 pip 安装:基础包为 pip install aisuite;也可安装特定提供商 SDK(如 pip install 'aisuite[anthropic]')或全部 SDK(pip install 'aisuite[all]')。

aisuite 采用什么许可证?

MIT 许可证,可免费用于商业和非商业用途。

可以不使用 API key 本地运行吗?

可以,通过 Ollama 完全本地运行模型,无需 API key。

OpenWorker 和 aisuite 是什么关系?

OpenWorker 是基于 aisuite 构建的桌面 AI 同事应用,目前在独立仓库中开发。

来源核验

资料核验于 2026-09-01