Composio OpenAI Agents SDK

0.12.0 verified Fri May 01 auth: no python

Provides strongly typed tools for OpenAI Agents SDK via Composio, a platform for integrating external APIs and services as tools. Current version 0.12.0. Releases are frequent (weekly/monthly).

pip install composio-openai-agents

Common errors

error ModuleNotFoundError: No module named 'composio_openai_agents' ↓

cause Package not installed or import name mismatch.

fix

Run 'pip install composio-openai-agents'. Then import with 'from composio_openai_agents import ComposioOpenAIAgents'.

error AttributeError: module 'composio_openai_agents' has no attribute 'ComposioOpenAI' ↓

cause Wrong class name used in import.

fix

Use 'ComposioOpenAIAgents' instead of 'ComposioOpenAI'.

error composio_openai_agents.exceptions.ComposioError: App GitHub not connected ↓

cause The tool requires an active connection to the external service (e.g., GitHub).

fix

Use Composio dashboard or API to connect the app, then set COMPOSIO_API_KEY environment variable.

Warnings

breaking Automatic file upload/download is now opt-in (since 0.12.0). Previous versions auto-staged local paths for file_uploadable inputs. ↓

fix Set Composio(dangerously_allow_file_upload=True) to restore old behaviour, or handle file uploads manually.

gotcha The package name is 'composio-openai-agents', but import uses underscores: 'composio_openai_agents'. ↓

fix Install via pip using hyphens, import using underscores.

deprecated The 'get_tools' method may return tool schemas that require app-specific authentication. Failing to authenticate will cause runtime errors. ↓

fix Ensure you have connected the app via Composio dashboard or API before using tools.

Imports

ComposioOpenAIAgents

wrong

from composio_openai_agents import ComposioOpenAI

correct

from composio_openai_agents import ComposioOpenAIAgents

Class name is exactly 'ComposioOpenAIAgents', not 'ComposioOpenAI'

OpenAIWrapper

from composio_openai_agents import OpenAIWrapper

Quickstart

Initialize the Composio wrapper for OpenAI Agents SDK.

import os
from composio_openai_agents import ComposioOpenAIAgents

composio_tools = ComposioOpenAIAgents()
# tools = composio_tools.get_tools(tools=['github'])  # uncomment with valid app name
print('Composio OpenAI Agents SDK ready')