{"id":23448,"library":"composio-openai-agents","title":"Composio OpenAI Agents SDK","description":"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).","status":"active","version":"0.12.0","language":"python","source_language":"en","source_url":"https://github.com/ComposioHQ/composio","tags":["openai","agents","tools","integrations","composio"],"install":[{"cmd":"pip install composio-openai-agents","lang":"bash","label":"Install the package"}],"dependencies":[],"imports":[{"note":"Class name is exactly 'ComposioOpenAIAgents', not 'ComposioOpenAI'","wrong":"from composio_openai_agents import ComposioOpenAI","symbol":"ComposioOpenAIAgents","correct":"from composio_openai_agents import ComposioOpenAIAgents"},{"note":"","wrong":null,"symbol":"OpenAIWrapper","correct":"from composio_openai_agents import OpenAIWrapper"}],"quickstart":{"code":"import os\nfrom composio_openai_agents import ComposioOpenAIAgents\n\ncomposio_tools = ComposioOpenAIAgents()\n# tools = composio_tools.get_tools(tools=['github'])  # uncomment with valid app name\nprint('Composio OpenAI Agents SDK ready')","lang":"python","description":"Initialize the Composio wrapper for OpenAI Agents SDK."},"warnings":[{"fix":"Set Composio(dangerously_allow_file_upload=True) to restore old behaviour, or handle file uploads manually.","message":"Automatic file upload/download is now opt-in (since 0.12.0). Previous versions auto-staged local paths for file_uploadable inputs.","severity":"breaking","affected_versions":">=0.12.0"},{"fix":"Install via pip using hyphens, import using underscores.","message":"The package name is 'composio-openai-agents', but import uses underscores: 'composio_openai_agents'.","severity":"gotcha","affected_versions":"all"},{"fix":"Ensure you have connected the app via Composio dashboard or API before using tools.","message":"The 'get_tools' method may return tool schemas that require app-specific authentication. Failing to authenticate will cause runtime errors.","severity":"deprecated","affected_versions":"all"}],"env_vars":null,"last_verified":"2026-05-01T00:00:00.000Z","next_check":"2026-07-30T00:00:00.000Z","problems":[{"fix":"Run 'pip install composio-openai-agents'. Then import with 'from composio_openai_agents import ComposioOpenAIAgents'.","cause":"Package not installed or import name mismatch.","error":"ModuleNotFoundError: No module named 'composio_openai_agents'"},{"fix":"Use 'ComposioOpenAIAgents' instead of 'ComposioOpenAI'.","cause":"Wrong class name used in import.","error":"AttributeError: module 'composio_openai_agents' has no attribute 'ComposioOpenAI'"},{"fix":"Use Composio dashboard or API to connect the app, then set COMPOSIO_API_KEY environment variable.","cause":"The tool requires an active connection to the external service (e.g., GitHub).","error":"composio_openai_agents.exceptions.ComposioError: App GitHub not connected"}],"ecosystem":"pypi","meta_description":null,"install_score":null,"install_tag":null,"quickstart_score":null,"quickstart_tag":null}