Repolode
andrewyng

andrewyng/aisuite

一个轻量级 Python 库,用统一的 OpenAI 风格接口调用多家大模型服务,并提供带工具和 MCP 支持的 Agents API。

Star
16,353
Fork
1,734
未关闭 Issue
161
最近提交
上个月

这是什么?

aisuite 是一个 Python 库,通过统一接口调用多家大模型服务商的模型。模型名采用 <provider>:<model-name> 格式,切换 OpenAI、Anthropic、Google、Ollama 等服务时只需修改一个字符串,请求和响应结构也保持一致,temperature、max_tokens 等常用参数在不同服务商之间通用。

在对话接口之上,aisuite 可以把普通 Python 函数直接作为工具使用:自动生成工具描述、执行调用,并通过 max_turns 控制多轮循环。针对较长的任务,它还提供 Agents API,包括 Runner、文件/git/shell 等预置工具集、工具调用审批策略、可恢复运行的状态存储,并原生支持 Model Context Protocol(MCP)服务器。

项目同时支持同步和异步流式输出,并通过简单的适配器类约定来扩展新的服务商。

核心功能

  • 01通过模型字符串切换,统一调用多家大模型服务的对话接口。
  • 02同步与异步流式输出,支持流式工具调用片段。
  • 03Python 函数可直接作为工具,自动生成描述并支持多轮调用循环。
  • 04Agents API 提供 Runner、文件/git/shell 预置工具集和工具调用审批策略。
  • 05原生支持 MCP,可将任意 MCP 服务器的工具交给模型使用。
  • 06按照命名约定实现适配器即可扩展新的服务商。

适用场景

  • 不改应用代码即可在 OpenAI、Anthropic 等服务商之间对比或切换。
  • 构建调用本地 Python 函数或 MCP 服务器的工具型助手。
  • 原型开发在代码仓库的文件和 git 历史上工作的多步骤智能体。
  • 用相同提示词同时测试本地 Ollama 模型和云端 API。

快速上手

  1. 1

    从 PyPI 安装 aisuite 基础包

    pip install aisuite
  2. 2

    安装你要使用的服务商 SDK(例如 Anthropic)

    pip install 'aisuite[anthropic]'
  3. 3

    按照 Chat Completions 快速入门配置各服务商的 API 密钥

  4. 4

    创建客户端,并使用 provider:model 格式调用模型

使用前须知

  • 使用前需要为所调用的模型服务商准备 API 密钥,需要一些设置工作。
  • 部分功能(如 Agents API 和 MCP 工具)需要额外安装,或需要单独了解其用法。
  • 基于 aisuite 构建的桌面应用 OpenWorker 已迁移至独立仓库。

标签

常见问题

aisuite 是什么?
一个轻量级 Python 库,用统一的 OpenAI 风格接口调用多家大模型服务,并提供带工具和 MCP 支持的 Agents API。 aisuite 是一个 Python 库,通过统一接口调用多家大模型服务商的模型。模型名采用 <provider>:<model-name> 格式,切换 OpenAI、Anthropic、Google、Ollama 等服务时只需修改一个字符串,请求和响应结构也保持一致,temperature、max_tokens 等常用参数在不同服务商之间通用。
aisuite 可以免费使用吗?用的什么许可证?
aisuite 以 MIT 许可证开源。用于商业产品前,请先确认许可证条款。
aisuite 还在维护吗?
半年内有更新。aisuite 最近一次提交是在 2026年9月18日。
aisuite 适合用来做什么?
不改应用代码即可在 OpenAI、Anthropic 等服务商之间对比或切换。 构建调用本地 Python 函数或 MCP 服务器的工具型助手。 原型开发在代码仓库的文件和 git 历史上工作的多步骤智能体。 用相同提示词同时测试本地 Ollama 模型和云端 API。
aisuite 怎么安装和运行?
从 PyPI 安装 aisuite 基础包: pip install aisuite 安装你要使用的服务商 SDK(例如 Anthropic): pip install 'aisuite[anthropic]' 按照 Chat Completions 快速入门配置各服务商的 API 密钥 创建客户端,并使用 provider:model 格式调用模型
在哪里获取 aisuite?
源代码和安装说明在 GitHub 上:https://github.com/andrewyng/aisuite

概要由 AI 根据项目 README 生成;GitHub 数据每日更新。

相关项目