Production Ready Toolset for AI Agents
🚀 Now launching Composio MCP🚀
We're excited to announce the launch of Composio MCP Servers! Connect Claude, Cursor and Windsurf to 100+ fully-managed MCP Servers with built-in auth! Check it out here
What is Composio?
Composio provides production-ready toolset for AI agents, offering:
- Support for over 250+ tools across multiple categories:
- Comprehensive framework support including OpenAI, Groq, Claude, LlamaIndex, Langchain, CrewAI, Autogen, Gemini, and more
- Managed authentication supporting multiple protocols (OAuth, API Keys, Basic JWT)
- Up to 40% improved tool call accuracy through optimized design
- Whitelabel solution for backend integration
- Pluggable architecture supporting custom tools and extensions
Table of contents
- Getting Started with Python
- Getting Started with Javascript
- Examples
- Star History
- Getting help
- Contributions
- Request a feature
- Thanks To All Contributors
Getting Started with Python
1. Installation
Start by installing the package
pip install composio-core
If you want to install the 'composio' package along with its openai plugin: pip install composio-openai.
2. Creating an agent & executing a tool
Let's create an AI Agent using OpenAI and use Composio's GitHub tool to star a GitHub repository
[!NOTE] Set your COMPOSIO_API_KEY & OPENAI_API_KEY in your environment variables.
Connect your GitHub account to Composio
composio add github # Run this in terminal
from openai import OpenAI
from composio_openai import ComposioToolSet, App, Action
# Initialize OpenAI client
openai_client = OpenAI(
api_key="{{OPENAIKEY}}"
)
# Initialize the Composio Tool Set
composio_tool_set = ComposioToolSet()
# Get GitHub tools that are pre-configured
actions = composio_tool_set.get_actions(
actions=[Action.GITHUB_STAR_A_REPOSITORY_FOR_THE_AUTHENTICATED_USER]
)
my_task = "Star a repo composiodev/composio on GitHub"
# Setup OpenAI assistant
assistant_instruction = "You are a super intelligent personal assistant"
assistant = openai_client.beta.assistants.create(
name="Personal Assistant",
instructions=assistant_instruction,
model="gpt-4-turbo",
tools=actions,
)
# Create a thread
thread = openai_client.beta.threads.create()
# Add user message to thread
message = openai_client.beta.threads.messages.create(
thread_id=thread.id,
role="user",
content=my_task
)
# Execute Agent with integrations
run = openai_client.beta.threads.runs.create(
thread_id=thread.id,
assistant_id=assistant.id
)
# Execute Function calls
response_after_tool_calls = composio_tool_set.wait_and_handle_assistant_tool_calls(
client=openai_client,
run=run,
thread=thread,
)
print(response_after_tool_calls)
Getting Started with JavaScript
To get started with the Composio SDK in JavaScript, follow these steps:
1. Installation:
npm install composio-core
2. Creating an agent & executing a tool
Let's create an AI Agent using OpenAI and use Composio's GitHub tool to star a GitHub repository
[!NOTE] Set your COMPOSIO_API_KEY & OPENAI_API_KEY in your environment variables.
Connect your GitHub account to Composio
composio add github # Run this in terminal
import { OpenAIToolSet } from "composio-core";
import OpenAI from "openai";
const toolset = new OpenAIToolSet({ apiKey: process.env.COMPOSIO_API_KEY });
const openai = new OpenAI({ apiKey: process.env.OPENAI_API_KEY });
const tools = await toolset.getTools({
actions: ["GITHUB_STAR_A_REPOSITORY_FOR_THE_AUTHENTICATED_USER"]
});
async function createGithubAssistant(openai, tools) {
return await openai.beta.assistants.create({
name: "Github Assistant",
instructions: "You're a GitHub Assistant, you can do operations on GitHub",
tools: tools,
model: "gpt-4o"
});
}
async function executeAssistantTask(openai, toolset, assistant, task) {
const thread = await openai.beta.threads.create();
const run = await openai.beta.threads.runs.create(thread.id, {
assistant_id: assistant.id,
instructions: task,
tools: tools,
model: "gpt-4o",
stream: false
});
const call = await toolset.waitAndHandleAssistantToolCalls(openai, run, thread);
console.log(call);
}
(async () => {
const githubAssistant = await createGithubAssistant(openai, tools);
await executeAssistantTask(
openai,
toolset,
githubAssistant,
"Star the repository 'composiohq/composio'"
);
})();
Examples
Python Examples
Javascript Examples
Star History
Getting help
- Read the docs at docs.composio.dev
- Post your questions on discord
Contributions
We're an open-source project and welcome contributions. Please read the contributing guide for more information and check our code of conduct before you start.
Request a feature
- If you have a feature request, please open an issue, make a pull request, or submit it in our feature requests channel.
- If you have ideas for improvements, you can also start a discussion in our GitHub repository.
Thanks To All Contributors
1 maintainer
Release files for composio-core 0.7.21
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | |
|---|---|---|---|
| composio_core-0.7.21.tar.gz | 334.8 kB | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| composio_core-0.7.21-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 836.0 kB
Release files / composio_core-0.7.21.tar.gz
| Download URL | composio_core-0.7.21.tar.gz |
|---|---|
| Size | 334.8 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
776e8961ffcaaa422d2ce53516fb80a3832cef25be13475cf5282f8626a9abdc
|
|
BLAKE2b-256 checksum How to use checksums |
42e4b0fadae584fd09290b4244f5bb5b7a067a3bb2b56562115ea55b66246949
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/6.1.0 CPython/3.13.7
|
Release files / composio_core-0.7.21-py3-none-any.whl
| Download URL | composio_core-0.7.21-py3-none-any.whl |
|---|---|
| Size | 501.2 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
e9d296479b259ff8e41bfae2b211a71c5d97f682f4e2ccd0e8e2cd4c2a624f64
|
|
BLAKE2b-256 checksum How to use checksums |
6f2724d6f8a089e2c319a06da81f3350fb7f3214f22d1f363663eeb3ec2fc241
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/6.1.0 CPython/3.13.7
|
