Class Composio

python/composio/sdk.py:49–241

Composio SDK for Python. Generic parameters: TTool: The individual tool type returned by the provider (e.g., ChatCompletionToolParam for OpenAI). TToolCollection: The collection type returned by get_tools (e.g., list[ChatCompletionToolParam]). The generic types are aut

class Composio(t.Generic[TTool, TToolCollection], WithLogger):
    """
    Composio SDK for Python.

    Generic parameters:
        TTool: The individual tool type returned by the provider (e.g., ChatCompletionToolParam for OpenAI).
        TToolCollection: The collection type returned by get_tools (e.g., list[ChatCompletionToolParam]).

    The generic types are automatically inferred from the provider passed to __init__.
    When no provider is passed, defaults to OpenAI types.

    Examples:
        # Implicit type inference - recommended
        composio = Composio(provider=OpenAIProvider())  # Composio[OpenAITool, list[OpenAITool]]
        composio = Composio(provider=AnthropicProvider())  # Composio[ToolParam, list[ToolParam]]
        composio = Composio()  # Composio[OpenAITool, list[OpenAITool]] (default)

        # Custom provider - types are inferred automatically
        composio = Composio(provider=MyCustomProvider())  # Composio[MyTool, list[MyTool]]
    """

    tools: "Tools[TTool, TToolCollection]"

    @t.overload
    def __init__(
        self: "Composio[OpenAITool, OpenAIToolCollection]",
        provider: None = None,
        **kwargs: te.Unpack[SDKConfig],
    ) -> None:
        """Initialize with default OpenAI provider."""
        ...

    @t.overload
    def __init__(
        self,
        provider: BaseProvider[TTool, TToolCollection],
        **kwargs: te.Unpack[SDKConfig],
    ) -> None:
        """Initialize with an explicit provider. Types are inferred from the provider."""
        ...

    def __init__(
        self,
        provider: t.Optional[BaseProvider[t.Any, t.Any]] = None,
        **kwargs: te.Unpack[SDKConfig],
    ) -> None:
        """
        Initialize the Composio SDK.

        :param provider: The provider to use for the SDK. Defaults to OpenAIProvider.
        :param environment: The environment to use for the SDK.
        :param api_key: The API key to use for the SDK.
        :param base_url: The base URL to use for the SDK.
        :param timeout: The timeout to use for the SDK.
        :param max_retries: The maximum number of retries to use for the SDK.
        :param toolkit_versions: A dictionary mapping toolkit names to specific versions:
                                - A dictionary mapping toolkit names to specific versions
                                - A string (e.g., 'latest', '20250906_01') to use the same version for all toolkits