https://github.com/composiohq/composio

Composio equips your AI agents & LLMs with 100+ high-quality integrations via function calling
https://github.com/composiohq/composio

agentic-ai agents ai ai-agents aiagents developer-tools function-calling gpt-4 javascript js llm llmops mcp python remote-mcp-server sse typescript

Last synced: 6 days ago
JSON representation

Composio equips your AI agents & LLMs with 100+ high-quality integrations via function calling

Host: GitHub
URL: https://github.com/composiohq/composio
Owner: ComposioHQ
License: mit
Created: 2024-02-23T13:58:27.000Z (almost 2 years ago)
Default Branch: next
Last Pushed: 2026-01-17T00:54:09.000Z (13 days ago)
Last Synced: 2026-01-17T05:09:31.443Z (13 days ago)
Topics: agentic-ai, agents, ai, ai-agents, aiagents, developer-tools, function-calling, gpt-4, javascript, js, llm, llmops, mcp, python, remote-mcp-server, sse, typescript
Language: TypeScript
Homepage: https://docs.composio.dev
Size: 217 MB
Stars: 26,368
Watchers: 57
Forks: 4,408
Open Issues: 33
Metadata Files:
- Readme: README.md
- Contributing: CONTRIBUTING.md
- License: LICENSE
- Code of conduct: .github/CODE_OF_CONDUCT.md
- Codeowners: .github/CODEOWNERS
- Security: .github/SECURITY.md
- Support: .github/SUPPORT.md

Awesome Lists containing this project

README

          




# Composio SDK

Skills that evolve for your Agents

[🌐 Website](https://composio.dev) • [📚 Documentation](https://docs.composio.dev)

[![GitHub Stars](https://img.shields.io/github/stars/ComposioHQ/composio?style=social)](https://github.com/ComposioHQ/composio/stargazers)

[![PyPI Downloads](https://img.shields.io/pypi/dm/composio?label=PyPI%20Downloads)](https://pypi.org/project/composio/)

[![NPM Downloads](https://img.shields.io/npm/dt/@composio/core?label=NPM%20Downloads)](https://www.npmjs.com/package/@composio/core)

[![Discord](https://img.shields.io/badge/Discord-join-5865F2?logo=discord&logoColor=white)](https://discord.gg/composio)



This repository contains the official Software Development Kits (SDKs) for Composio, providing seamless integration capabilities for Python and Typescript Agentic Frameworks and Libraries.

## Getting Started

### TypeScript SDK Installation

```bash

# Using npm

npm install @composio/core

# Using yarn

yarn add @composio/core

# Using pnpm

pnpm add @composio/core

```

#### Quick start:

```typescript

import { Composio } from '@composio/core';

// Initialize the SDK

const composio = new Composio({

  // apiKey: 'your-api-key',

});

```

#### Simple Agent with OpenAI Agents

```bash

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

```

```typescript

import { Composio } from '@composio/core';

import { OpenAIAgentsProvider } from '@composio/openai-agents';

import { Agent, run } from '@openai/agents';

const composio = new Composio({

  provider: new OpenAIAgentsProvider(),

});

const userId = 'user@acme.org';

const tools = await composio.tools.get(userId, {

  toolkits: ['HACKERNEWS'],

});

const agent = new Agent({

  name: 'Hackernews assistant',

  tools: tools,

});

const result = await run(agent, 'What is the latest hackernews post about?');

console.log(JSON.stringify(result.finalOutput, null, 2));

// will return the response from the agent with data from HACKERNEWS API.

```

### Python SDK Installation

```bash

# Using pip

pip install composio

# Using poetry

poetry add composio

```

#### Quick start:

```python

from composio import Composio

composio = Composio(

  # api_key="your-api-key",

)

```

#### Simple Agent with OpenAI Agents

```bash

pip install composio_openai_agents openai-agents

```

```python

import asyncio

from agents import Agent, Runner

from composio import Composio

from composio_openai_agents import OpenAIAgentsProvider

# Initialize Composio client with OpenAI Agents Provider

composio = Composio(provider=OpenAIAgentsProvider())

user_id = "user@acme.org"

tools = composio.tools.get(user_id=user_id, toolkits=["HACKERNEWS"])

# Create an agent with the tools

agent = Agent(

    name="Hackernews Agent",

    instructions="You are a helpful assistant.",

    tools=tools,

)

# Run the agent

async def main():

    result = await Runner.run(

        starting_agent=agent,

        input="What's the latest Hackernews post about?",

    )

    print(result.final_output)

asyncio.run(main())

# will return the response from the agent with data from HACKERNEWS API.

```

For more detailed usage instructions and examples, please refer to each SDK's specific documentation.

### Open API Specification

To update the OpenAPI specifications used for generating SDK documentation:

```bash

# Pull the latest API specifications from the backend

pnpm api:pull

```

This command pulls the OpenAPI specification from `https://backend.composio.dev/api/v3/openapi.json` (defined in `fern/scripts/pull-openapi-spec.sh`) and updates the local API documentation files.

This is pulled automatically with build step.

## Available SDKs

### TypeScript SDK (/ts)

The TypeScript SDK provides a modern, type-safe way to interact with Composio's services. It's designed for both Node.js and browser environments, offering full TypeScript support with comprehensive type definitions.

For detailed information about the TypeScript SDK, please refer to the [TypeScript SDK Documentation](/ts/README.md).

### Python SDK (/python)

The Python SDK offers a Pythonic interface to Composio's services, making it easy to integrate Composio into your Python applications. It supports Python 3.10+ and follows modern Python development practices.

For detailed information about the Python SDK, please refer to the [Python SDK Documentation](/python/README.md).

## Provider Support

The following table shows which AI frameworks and platforms are supported in each SDK:

| Provider | TypeScript | Python |

|----------|:----------:|:------:|

| OpenAI | ✅ | ✅ |

| OpenAI Agents | ✅ | ✅ |

| Anthropic | ✅ | ✅ |

| LangChain | ✅ | ✅ |

| LangGraph | ✅* | ✅ |

| LlamaIndex | ✅ | ✅ |

| Vercel AI SDK | ✅ | ❌ |

| Google Gemini | ✅ | ✅ |

| Google ADK | ❌ | ✅ |

| Mastra | ✅ | ❌ |

| Cloudflare Workers AI | ✅ | ❌ |

| CrewAI | ❌ | ✅ |

| AutoGen | ❌ | ✅ |

\* *LangGraph in TypeScript is supported via the `@composio/langchain` package.*

> **Don't see your provider?** Learn how to [build a custom provider](https://docs.composio.dev/sdk/typescript/custom-providers) to integrate with any AI framework.

## Packages

### Core Packages

| Package | Version |

|---------|---------|

| **TypeScript** | |

| [@composio/core](https://www.npmjs.com/package/@composio/core) | ![npm version](https://img.shields.io/npm/v/@composio/core) |

| **Python** | |

| [composio](https://pypi.org/project/composio/) | ![PyPI version](https://img.shields.io/pypi/v/composio) |

### Provider Packages

| Package | Version |

|---------|---------|

| **TypeScript** | |

| [@composio/openai](https://www.npmjs.com/package/@composio/openai) | ![npm version](https://img.shields.io/npm/v/@composio/openai) |

| [@composio/openai-agents](https://www.npmjs.com/package/@composio/openai-agents) | ![npm version](https://img.shields.io/npm/v/@composio/openai-agents) |

| [@composio/anthropic](https://www.npmjs.com/package/@composio/anthropic) | ![npm version](https://img.shields.io/npm/v/@composio/anthropic) |

| [@composio/langchain](https://www.npmjs.com/package/@composio/langchain) | ![npm version](https://img.shields.io/npm/v/@composio/langchain) |

| [@composio/llamaindex](https://www.npmjs.com/package/@composio/llamaindex) | ![npm version](https://img.shields.io/npm/v/@composio/llamaindex) |

| [@composio/vercel](https://www.npmjs.com/package/@composio/vercel) | ![npm version](https://img.shields.io/npm/v/@composio/vercel) |

| [@composio/google](https://www.npmjs.com/package/@composio/google) | ![npm version](https://img.shields.io/npm/v/@composio/google) |

| [@composio/mastra](https://www.npmjs.com/package/@composio/mastra) | ![npm version](https://img.shields.io/npm/v/@composio/mastra) |

| [@composio/cloudflare](https://www.npmjs.com/package/@composio/cloudflare) | ![npm version](https://img.shields.io/npm/v/@composio/cloudflare) |

| **Python** | |

| [composio-openai](https://pypi.org/project/composio-openai/) | ![PyPI version](https://img.shields.io/pypi/v/composio-openai) |

| [composio-openai-agents](https://pypi.org/project/composio-openai-agents/) | ![PyPI version](https://img.shields.io/pypi/v/composio-openai-agents) |

| [composio-anthropic](https://pypi.org/project/composio-anthropic/) | ![PyPI version](https://img.shields.io/pypi/v/composio-anthropic) |

| [composio-langchain](https://pypi.org/project/composio-langchain/) | ![PyPI version](https://img.shields.io/pypi/v/composio-langchain) |

| [composio-langgraph](https://pypi.org/project/composio-langgraph/) | ![PyPI version](https://img.shields.io/pypi/v/composio-langgraph) |

| [composio-llamaindex](https://pypi.org/project/composio-llamaindex/) | ![PyPI version](https://img.shields.io/pypi/v/composio-llamaindex) |

| [composio-crewai](https://pypi.org/project/composio-crewai/) | ![PyPI version](https://img.shields.io/pypi/v/composio-crewai) |

| [composio-autogen](https://pypi.org/project/composio-autogen/) | ![PyPI version](https://img.shields.io/pypi/v/composio-autogen) |

| [composio-gemini](https://pypi.org/project/composio-gemini/) | ![PyPI version](https://img.shields.io/pypi/v/composio-gemini) |

| [composio-google](https://pypi.org/project/composio-google/) | ![PyPI version](https://img.shields.io/pypi/v/composio-google) |

| [composio-google-adk](https://pypi.org/project/composio-google-adk/) | ![PyPI version](https://img.shields.io/pypi/v/composio-google-adk) |

### Utility Packages

| Package | Version |

|---------|---------|

| [@composio/json-schema-to-zod](https://www.npmjs.com/package/@composio/json-schema-to-zod) | ![npm version](https://img.shields.io/npm/v/@composio/json-schema-to-zod) |

| [@composio/ts-builders](https://www.npmjs.com/package/@composio/ts-builders) | ![npm version](https://img.shields.io/npm/v/@composio/ts-builders) |

_if you are looking for the older sdk, you can find them [here](https://github.com/ComposioHQ/composio/tree/master)_

## Rube

[Rube](https://rube.app) is a Model Context Protocol (MCP) server built with Composio. It connects your AI tools to 500+ apps like Gmail, Slack, GitHub, and Notion. Simply install it in your AI client, authenticate once with your apps, and start asking your AI to perform real actions like "Send an email" or "Create a task." 

It integrates with major AI clients like Cursor, Claude Desktop, VS Code, Claude Code and any custom MCP‑compatible client. You can switch between these clients and your integrations follow you.

## Contributing

We welcome contributions to both SDKs! Please read our [contribution guidelines](https://github.com/ComposioHQ/composio/blob/next/CONTRIBUTING.md) before submitting pull requests.

## License

This project is licensed under the MIT License - see the LICENSE file for details.

## Support

If you encounter any issues or have questions about the SDKs:

- Open an issue in this repository

- Contact our [support team](mailto:support@composio.dev)

- Check our [documentation](https://docs.composio.dev/)

ecosyste.ms

Data

Tools

Indexes

Applications

Experiments

Awesome

https://github.com/composiohq/composio

Awesome Lists containing this project

README