Registry / communication / composio-client

composio-client

library1.43.0pypypi✓ verified 21d ago

Composio Client is the official Python library for interacting with the Composio API. It enables developers to integrate and automate actions across various tools and platforms. The library maintains a rapid release cadence, with frequent updates to its API surface to reflect changes and additions in the underlying Composio platform.

communication crm-productivity http-networking

pip install composio-client

github ↗package ↗homepage ↗

INSTALL

IMPORT

SIG · COMPOSIO-CLIENT

composio-client

communicationpythonv1.43.0

Install

4.0s avg

Import

2037ms

Disk

34MB

Pass rate

10/ 10

Env Coverage10 / 10

glibc

3.9–3.13

musl

3.9–3.13

Install & Compatibility

Where this runs

tested against v1.43.0 · pip install

no network on importno background threads

Install × environment matrix

Each cell = how many times install + import succeeded across repeated harness runs. Partial = flaky.
glibc = Debian/Ubuntu slim · musl = Alpine Linux

musl

py 3.10–3.95 runs

installs and imports cleanly · install 0.0s · import 2.098s · 35.3MB

glibc

py 3.10–3.95 runs

installs and imports cleanly · install 4.0s · import 1.976s · 35MB

34MB installed

● package 34MB

Code

Verified usage

Verified import paths — ran on the pinned version, not inferred.

Composio

✓ from composio_client import Composio

✗ from composio_client import ComposioClient

Client

✓ from composio_client import Client

AsyncComposio

✓ from composio_client import AsyncComposio

Initializes the ComposioClient and fetches a list of currently installed tools. This demonstrates basic connectivity and authentication. Ensure `COMPOSIO_API_KEY` is set in your environment variables.

import os from composio_client import ComposioClient # Ensure COMPOSIO_API_KEY is set in your environment # Example: export COMPOSIO_API_KEY="your_api_key_here" api_key = os.environ.get('COMPOSIO_API_KEY', '') if not api_key: print("Error: COMPOSIO_API_KEY environment variable not set.") print("Please set it before running the quickstart.") else: try: client = ComposioClient(api_key=api_key) # Fetch a list of installed tools tools = client.tool.get_installed_tools() print(f"Successfully initialized ComposioClient. Found {len(tools)} installed tools:") for tool in tools: print(f"- {tool.name} (ID: {tool.id})") except Exception as e: print(f"An error occurred: {e}")

composio --version

Debug

Known issues

gotchaThe Composio API client is frequently updated, often multiple times a week. While semantic versioning (v1.x.y) is used, rapid 'api update' commits can sometimes introduce subtle changes to method signatures or return types within minor versions, requiring careful attention during upgrades.

fix

Always check the latest changelog or GitHub releases when upgrading, especially before deploying to production. Pinning exact minor versions (`composio-client==1.x.y`) can help, but regular updates are recommended for new features and bug fixes.

affects: 1.0.0+

gotchaAuthentication requires a `COMPOSIO_API_KEY`. The client expects this to be provided either as an environment variable or explicitly passed during client instantiation. Failing to provide a valid key will result in authentication errors.

fix

Set the `COMPOSIO_API_KEY` environment variable (e.g., `export COMPOSIO_API_KEY="your_key"`) or pass it directly: `client = ComposioClient(api_key="your_key")`.

affects: 1.0.0+

gotchaThe library primarily interacts with 'tools' registered within the Composio platform. To perform meaningful actions (e.g., calling `client.action.run_action`), you must have corresponding tools configured and installed in your Composio account.

fix

Before using the client to interact with specific tools, ensure they are set up in your Composio dashboard. Use `client.tool.get_installed_tools()` to verify available tools and their IDs.

affects: 1.0.0+

Upgrade

Version history

1.43.0latest on PyPI · released Jul 8, 2026

Audit

Dependencies

httpxrequiredUsed for making HTTP requests to the Composio API.

pydanticrequiredUsed for data validation and parsing API responses.

Agent activity

49 hits · last 30 days

node

OpenAI (training)

Resources

githubhttps://github.com/ComposioHQ/composio-base-py ↗

packagehttps://pypi.org/project/composio-client/ ↗

homepagehttps://composio.ai ↗