composio README

The project's README from github.com/ComposioHQ/composio. As one markdown file: README.md.

Composio logo

composio.dev • Documentation • Quickstart • Changelog

GitHub stars npm PyPI Discord HVTrust

Composio

Composio gives your AI agents 1000+ pre-authenticated toolkits, per-user sessions, authentication, triggers, and a sandbox, so you can ship agents that turn intent into action.

This is the Composio SDK monorepo. It contains:

Quickstart

Create a session for a user, hand its tools to your agent, and let the agent take action across 1000+ apps. Grab a COMPOSIO_API_KEY from the dashboard first.

TypeScript

npm install @composio/core @composio/openai-agents @openai/agents

@composio/core intentionally packages its TypeScript source and SDK docs so the installed package is inspectable to coding agents. If you want a smaller install with the same API, use @composio/slim.

import { 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-agents

from 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)

By default a session gets meta tools that discover, authenticate, and execute app tools at runtime, so you don't load hundreds of tool definitions into context. Store session.session_id and reuse it with composio.use() across turns. See what a session is and configuring sessions for restricting toolkits, auth configs, and connected accounts.

Prefer MCP? Every session also exposes a hosted MCP endpoint. Pass mcp: true to composio.create() and point Claude, Cursor, or any MCP client at session.mcp.url. See sessions via MCP.

CLI

The composio CLI runs Composio from your shell and gives coding agents like Claude Code a local tool surface.

curl -fsSL https://composio.dev/install | sh

The installer puts composio on your PATH for future terminals. Open a new terminal, then run composio login. See INSTALL.md for shell setup overrides, including COMPOSIO_INSTALL_SHELL=none for install-only runs.

Use composio search to find tools, composio execute to run them, composio link to connect accounts, and composio run to script workflows in TypeScript. See the CLI docs.

Providers

A provider adapts Composio tools to your agent framework's native tool format:

Provider TypeScript Python
OpenAI @composio/openai composio-openai
OpenAI Agents @composio/openai-agents composio-openai-agents
Anthropic @composio/anthropic composio-anthropic
Claude Agent SDK @composio/claude-agent-sdk composio-claude-agent-sdk
Vercel AI SDK @composio/vercel —
Google GenAI @composio/google composio-gemini, composio-google
Google ADK — composio-google-adk
LangChain @composio/langchain composio-langchain
LangGraph via @composio/langchain composio-langgraph
LlamaIndex @composio/llamaindex composio-llamaindex
Mastra @composio/mastra —
Pi @composio/experimental* —
Cloudflare Workers AI @composio/cloudflare —
CrewAI — composio-crewai
AutoGen — composio-autogen

* The Pi provider is experimental and ships from @composio/experimental.

Don't see your framework? Build a custom provider, or skip providers entirely and connect over MCP.

All packages

Everything published from this repo:

Package Description
@composio/core TypeScript SDK
@composio/slim @composio/core without packaged source or docs; same API, smaller install
composio CLI Standalone CLI binary: curl -fsSL https://composio.dev/install | sh
@composio/experimental Experimental integrations, including the Pi provider
@composio/json-schema-to-zod JSON Schema to Zod conversion
@composio/* provider adapters OpenAI, OpenAI Agents, Anthropic, Claude Agent SDK, Vercel, Google, LangChain, LlamaIndex, Mastra, Cloudflare
composio Python SDK
composio-* provider adapters OpenAI, OpenAI Agents, Anthropic, Claude Agent SDK, Gemini, Google, Google ADK, LangChain, LangGraph, LlamaIndex, CrewAI, AutoGen

Repository layout

ts/                TypeScript SDK workspace
  packages/core/       @composio/core
  packages/providers/  Provider adapters
  packages/cli/        Composio CLI
python/            Python SDK and provider packages
docs/              Documentation site (docs.composio.dev)

The TypeScript SDK is tested against Node 22+; the Python SDK supports Python 3.10+.

Development

mise install    # pinned toolchain (Node, Python, pnpm)
pnpm install
pnpm build
pnpm test

Python commands run from python/; see python/README.md. We welcome contributions to both SDKs; read the contribution guidelines before submitting pull requests.

Support

License

MIT. See LICENSE.

composio (ComposioHQ/composio)

Searching Database…

30.6K ·GitHub
Composio
这是干什么用的?Composio 是一个面向 AI 智能体的平台:它为你的智能体提供 1000 多个已预先完成授权的工具包、按用户划分的会话、身份验证、触发器和一个沙盒环境,让智能体能够跨应用执行实际操作,而不只是聊天。
这是我安装的库,还是一个托管服务?两者都是:你安装一个 SDK(TypeScript 用 @composio/core,Python 用 composio)或者独立的 composio CLI,而会话、身份验证和工具执行都运行在 Composio 的托管后端上,通过 API 密钥访问。
我怎样接入第一个智能体?从仪表盘获取一个 COMPOSIO_API_KEY,用 npm 安装 @composio/core 或用 pip 安装 composio,创建一个会话,然后把它的工具交给你的智能体。如果想以终端为主来用,就安装 CLI 并运行 composio login。
它支持哪些智能体框架?Provider 适配器覆盖 OpenAI、OpenAI Agents、Anthropic、Claude Agent SDK、Vercel AI SDK、Google GenAI、LangChain、LangGraph、LlamaIndex、Mastra、CrewAI、AutoGen 等;任何 MCP 客户端也都能用。TS SDK 需要 Node 22+ 以上,Python 需要 3.10+ 以上。
有东西是在本地运行的,还是一切都在 Composio 的云上?你需要托管仪表盘提供的 COMPOSIO_API_KEY,而且 README 没有提到自托管模式——会话、身份验证和工具执行都运行在 Composio 的云上。此外 Pi provider 也明确标注为实验性功能。
我的智能体上下文会被工具定义撑爆——Composio 能处理这个问题吗?可以。默认情况下,Python 会话会获得一些元工具,可以在运行时发现、授权并执行应用工具,这样你就不用把几百个工具定义塞进上下文;保存会话 id,之后各轮对话中用 composio.use() 复用它即可。
我不写代码,能在命令行里用它吗?可以。composio CLI 为 Claude Code 这类编程智能体提供了一个本地工具入口:composio search 用于查找工具,execute 用于执行工具,link 用于连接账号,run 用于运行 TypeScript 编写的工作流脚本。
我用的是 Cursor 或 Claude Desktop——能不用 SDK 直接接入吗?可以。给 composio.create() 传入 mcp: true,然后把 Claude、Cursor 或任何 MCP 客户端指向该会话的托管 MCP 端点(session.mcp.url),完全不用 provider 适配器。
@composio/core 和 @composio/slim 有什么区别?API 相同,但 core 特意把它的 TypeScript 源码和 SDK 文档打包进去,这样安装后的包可以被编程智能体检查分析;slim 则去掉这些内容,安装体积更小。
What are similar projects?qwen-code, turnstone, corsair, tambo, headroom, Tracely-ai, trueforge, gitagent
Which topics is it in?aiagents, js, sse, function-calling, gpt-4, llmops, agent-tools, langchain, agent-framework, coding-agents, sandbox, authentication
Creator
ComposioHQ
Size
425.2 MB
Stars
30.6K
Updated
CommitOct 17Release@composio/[email protected]Oct 15
Age
2y
Commits · 90 Days