星标数：31057★ Fork数：4949 《composio：为 AI 智能体提供千余工具的 SDK 集合》
Composio 为你的 AI 智能体提供 1000+ 预认证工具包、按用户划分的会话、认证机制、触发器和一个沙箱环境，让你构建出能够将意图转化为实际操作的智能体。
这是 Composio 的 SDK 单体仓库，包含 TypeScript SDK（@composio/core）、Python SDK（composio）、可在命令行中搜索、执行和编写脚本的 composio CLI，以及针对 OpenAI Agents、Claude Agent SDK、Vercel AI SDK、LangChain 等多种框架的 Provider 适配器。
使用时先从 dashboard 获取 COMPOSIO_API_KEY，然后为用户创建会话，把会话的工具交给你的智能体，智能体即可跨 1000+ 应用执行操作。默认情况下，会话会在运行时动态发现、认证和执行应用工具（元工具），无需把数百个工具定义一次性加载到上下文中；保存 session.session_id 后可跨轮次通过 composio.use() 复用。每个会话还提供托管的 MCP 端点，传入 mcp: true 即可让 Claude、Cursor 等 MCP 客户端接入。
主要特点
- 提供 1000+ 预认证工具包，支持工具搜索与上下文管理
- 按用户隔离的会话、认证配置与已连接账号管理
- 触发器（triggers）与沙箱工作台（sandboxed workbench）
- TypeScript 与 Python 双 SDK，配套独立 CLI
- 丰富的 Provider 适配器：OpenAI、Anthropic、Claude Agent SDK、Vercel AI SDK、Google、LangChain、LangGraph、LlamaIndex、CrewAI、AutoGen 等
- 支持 MCP：每个会话暴露托管 MCP 端点，可直接对接 MCP 客户端
快速开始
TypeScript：
npm install @composio/core @composio/openai-agents @openai/agentsimport { Composio } from "@composio/core";
import { OpenAIAgentsProvider } from "@composio/openai-agents";
import { Agent, run } from "@openai/agents";
const composio = new Composio({ provider: new OpenAIAgentsProvider() });
// Each session is scoped to one of your users
const session = await composio.create("user_123");
const tools = await session.tools();
const agent = new Agent({
name: "Personal Assistant",
instructions: "You are a helpful assistant. Use Composio tools to take action.",
tools,
});
const result = await run(agent, "Summarize my emails from today");
console.log(result.finalOutput);Python：
pip install composio composio-openai-agents openai-agentsfrom composio import Composio
from composio_openai_agents import OpenAIAgentsProvider
from agents import Agent, Runner
composio = Composio(provider=OpenAIAgentsProvider())
# Each session is scoped to one of your users
session = composio.create(user_id="user_123")
tools = session.tools()
agent = Agent(
name="Personal Assistant",
instructions="You are a helpful assistant. Use Composio tools to take action.",
tools=tools,
)
result = Runner.run_sync(starting_agent=agent, input="Summarize my emails from today")
print(result.final_output)CLI 安装
curl -fsSL https://composio.dev/install | sh安装后新开终端执行 composio login。常用命令：
- composio search — 搜索工具
- composio execute — 执行工具
- composio link — 连接账号
- composio run — 用 TypeScript 编写工作流脚本
环境要求
- TypeScript SDK 针对 Node 22+ 进行测试
- Python SDK 支持 Python 3.10+
开发构建流程：
mise install # pinned toolchain (Node, Python, pnpm)
pnpm install
pnpm build
pnpm testPython 相关命令在 python/ 目录下执行。欢迎为两个 SDK 贡献代码，提交 PR 前请先阅读贡献指南。
📊 本项目 GitHub 星标数：31057。最后更新：2026-11-13，发布：2026-11-13。项目地址：https://github.com/ComposioHQ/composio
