composio

pip install composio-openai  # For OpenAI
# Or: pip install composio-langchain, composio-crewai, composio-anthropic

# connect.py — Connect a user's GitHub account
from composio import ComposioToolSet

toolset = ComposioToolSet(api_key="your-composio-key")

# Generate a connection URL for the user
connection = toolset.initiate_connection(
    app="github",
    entity_id="user-123",  # Your user ID
)
print(f"Connect GitHub: {connection.redirectUrl}")
# User clicks this URL → OAuth flow → account connected

# agent.py — AI agent with GitHub tools
from openai import OpenAI
from composio_openai import ComposioToolSet, Action

client = OpenAI()
toolset = ComposioToolSet()

# Get GitHub tools for the connected user
tools = toolset.get_tools(
    actions=[
        Action.GITHUB_CREATE_ISSUE,
        Action.GITHUB_LIST_REPOS,
        Action.GITHUB_CREATE_PR,
        Action.SLACK_SEND_MESSAGE,
    ],
    entity_id="user-123",
)

# Agent with tool use
response = client.chat.completions.create(
    model="gpt-4o",
    messages=[
        {"role": "system", "content": "You are a helpful developer assistant with access to GitHub and Slack."},
        {"role": "user", "content": "Create a GitHub issue in myorg/myrepo titled 'Fix login bug' with details about the session timeout, then notify #engineering on Slack."},
    ],
    tools=tools,
)

# Execute tool calls
result = toolset.handle_tool_call(response)
print(result)

# langchain_agent.py — LangChain agent with Composio tools
from langchain_openai import ChatOpenAI
from langchain.agents import AgentExecutor, create_openai_functions_agent
from composio_langchain import ComposioToolSet, Action

toolset = ComposioToolSet()
tools = toolset.get_tools(
    actions=[
        Action.GMAIL_SEND_EMAIL,
        Action.GOOGLE_CALENDAR_CREATE_EVENT,
        Action.NOTION_CREATE_PAGE,
    ],
    entity_id="user-123",
)

llm = ChatOpenAI(model="gpt-4o")
agent = create_openai_functions_agent(llm, tools, prompt)
executor = AgentExecutor(agent=agent, tools=tools)

result = executor.invoke({
    "input": "Schedule a meeting for tomorrow at 2 PM with the team, create a Notion agenda page, and send a Gmail invite to team@example.com."
})

// agent.ts — TypeScript with OpenAI
import { OpenAI } from "openai";
import { OpenAIToolSet } from "composio-core";

const toolset = new OpenAIToolSet({ apiKey: process.env.COMPOSIO_API_KEY });
const openai = new OpenAI();

const tools = await toolset.getTools({
  actions: ["GITHUB_CREATE_ISSUE", "SLACK_SEND_MESSAGE"],
  entityId: "user-123",
});

const response = await openai.chat.completions.create({
  model: "gpt-4o",
  messages: [{ role: "user", content: "Create a bug report on GitHub..." }],
  tools,
});

const result = await toolset.handleToolCall(response);