composio-autogen

Adapts Composio tools to AutoGen FunctionTool objects and registers them with your caller and executor agents, so your AutoGen agents can take action across 1000+ apps.

Installation

pip install composio composio-autogen 'ag2[openai]'

Set COMPOSIO_API_KEY (from the dashboard) and OPENAI_API_KEY in your environment.

Quickstart

import os

from autogen import AssistantAgent, LLMConfig, UserProxyAgent
from composio import Composio
from composio_autogen import AutogenProvider

composio = Composio(provider=AutogenProvider())

# Each session is scoped to one of your users
session = composio.create(user_id="user_123")
tools = session.tools()

chatbot = AssistantAgent(
    "chatbot",
    system_message="Reply TERMINATE when the task is done or when user's content is empty",
    llm_config=LLMConfig({
        "api_type": "openai",
        "model": "gpt-5.2",
        "api_key": os.environ["OPENAI_API_KEY"],
    }),
)

user_proxy = UserProxyAgent(
    "user_proxy",
    is_termination_msg=lambda msg: "TERMINATE" in (msg.get("content", "") or ""),
    human_input_mode="NEVER",
    code_execution_config={"use_docker": False},
)

# Register tools with both agents
composio.provider.register_tools(caller=chatbot, executor=user_proxy, tools=tools)

response = user_proxy.initiate_chat(
    chatbot,
    message="Send an email to john@example.com with the subject 'Hello' and body 'Hello from Composio!'",
)

print(response.chat_history)

For multi-turn use, store session.session_id and reuse it with composio.use(session_id) instead of calling create() again.

Provider specifics

AutoGen needs tools registered with two agents, not passed once. Call composio.provider.register_tools(caller=..., executor=..., tools=tools): the caller decides which tool to invoke, and the executor runs it. This method is unique to the AutoGen provider.

AutoGen caps function names at 64 characters, so the provider hashes and truncates long tool slugs to stay under the limit. The registered name will not always match the original Composio slug.

Release files for composio-autogen 0.22.0

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for composio-autogen 0.22.0
File	Size	Uploaded
composio_autogen-0.22.0.tar.gz	4.2 kB	Sep 21, 2026	Details

Built distribution (wheel)

Table of built distributions (wheels) for composio-autogen 0.22.0
File	Interpreter	ABI	Platform	Reset
composio_autogen-0.22.0-py3-none-any.whl 4.3 kB Sep 21, 2026	Python 3	none	any	Details

Total release size: 8.5 kB

Release files / composio_autogen-0.22.0.tar.gz

Download URL	composio_autogen-0.22.0.tar.gz
Size	4.2 kB
Tags	Source
SHA-256 checksum How to use checksums	`4ab3296432a32c1c4c9a8fe1e69684b5d9315fa3540d2107facc1e9d80390b96`
BLAKE2b-256 checksum How to use checksums	`0ddf57c70bce0adc8fef23d8be70fcfc212df3e762aff04e82e15f0caf33d4dd`
Upload date	Sep 21, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	No
Uploaded via	`twine/7.0.0 CPython/3.13.14`

Release files / composio_autogen-0.22.0-py3-none-any.whl

Download URL	composio_autogen-0.22.0-py3-none-any.whl
Size	4.3 kB
Tags	Python 3
SHA-256 checksum How to use checksums	`12e7a4f8a84d61bfa971385e3fc0ca43bb40546f494b06aead9d1126a06adbb7`
BLAKE2b-256 checksum How to use checksums	`9f43aeaf1d7b551dcd7a53ea11c9a236a308f07fdf8c7cc308a8321e9edca496`
Upload date	Sep 21, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	No
Uploaded via	`twine/7.0.0 CPython/3.13.14`