composio-client

What it is and what it does

Composio-client is an official Python SDK for the Composio REST API, generated using Stainless and built on httpx. It provides both synchronous (Composio) and asynchronous (AsyncComposio) clients with full type definitions for all request parameters and response fields, enabling IDE autocomplete and type checking. The library handles authentication via API key, manages retries automatically for transient errors, and includes specialized error classes for different HTTP status codes.

The package is designed for developers integrating Composio's tool execution capabilities into Python applications. It supports nested typed parameters using TypedDict, Pydantic response models with serialization helpers, and configurable timeouts and retry behavior. An optional aiohttp backend is available for improved async concurrency. The library is actively maintained, supports modern Python versions (3.9–3.14), and includes comprehensive error handling and logging capabilities.

Use it for:

• Execute remote tools via the Composio API from a Python application with full type safety and error handling.
• Build async workflows that call multiple Composio tools concurrently using AsyncComposio and await syntax.
• Integrate Composio tool execution into a larger Python service with automatic retries and configurable timeouts.
• Develop IDE-friendly integrations where type hints and autocomplete guide correct API usage.
• Handle authentication and API errors consistently across synchronous and asynchronous code paths.

Worth the install?

AI-flagged interpretation of the facts on this page — verify before relying

A Python client library for the Composio REST API, providing synchronous and asynchronous access to tool execution and API operations with full type hints and error handling.

Yes. The library is actively maintained, has no known vulnerabilities, carries a permissive Apache-2.0 license, and installs with low friction. It supports current Python versions and provides both sync and async clients with comprehensive type hints. Install it if you need to call the Composio API from Python; the typing and error handling will save integration time.

Install

composio-client on PyPI

pip install composio-client

uv add composio-client

poetry add composio-client

Installing composio-client

Before you install

Low friction installation as a pure-Python wheel. Active maintenance with recent releases; last commit 2026-08-12. Supports Python 3.9 through 3.14 across major platforms.

License in practice

Licensed under Apache-2.0 (permissive), allowing free use, modification, and distribution in both open-source and commercial projects with minimal restrictions.

Quickstart

pip install composio-client

import os
from composio_client import Composio

client = Composio(api_key=os.environ.get("COMPOSIO_API_KEY"))
response = client.tools.execute(tool_slug="tool_slug")
print(response.log_id)

Requires COMPOSIO_API_KEY environment variable or explicit api_key parameter to authenticate with the Composio service.

Verify before relying

• Whether the library's retry logic (2 times by default) and timeout handling (1 minute default) are suitable for your use case.
• Performance characteristics when using aiohttp backend versus default httpx for async operations.
• Rate limiting behavior and how the RateLimitError is handled in production workflows.

Package facts

Evidence: composio_client-1.43.0-py3-none-any.whl

Tags

More Python Modules packages