This release is a pre-release and may not be stable for production use.
composio-client for Python
composio-client replaces the Stainless-generated package without requiring you to rewrite existing
1.43.x calls.
from composio_client import Composio
client = Composio(api_key="ak_...")
session = client.tool_router.session.create(user_id="user@example.com")
result = client.tool_router.session.execute(
session.session_id,
tool_slug="GITHUB_CREATE_ISSUE",
arguments={"owner": "composiohq", "repo": "composio", "title": "Example"},
)
The owned client preserves the public Python contract from composio-client==1.43.0 and adds the
rest of the v3.1 API. You get all 113 operations, including the 64 operations published by
Stainless and 49 additive operations generated from the checked-in OpenAPI document.
The September 2026 schema adds client.session_configs.list() and
client.session_configs.retrieve(id), premium usage settings, workbench tool-execution
controls, and trigger egress overrides. Generated public request and response types
include new fields while retaining existing Stainless declarations.
Install the client
pip install composio-client
With uv:
uv add composio-client
Set COMPOSIO_API_KEY or pass api_key when you construct the client.
Use from_env when configuration must come from a specific mapping instead of os.environ:
client = Composio.from_env(config, environment="staging")
Explicit keyword arguments replace mapped values. The factory recognizes COMPOSIO_API_KEY,
COMPOSIO_USER_API_KEY, COMPOSIO_ORG_API_KEY, COMPOSIO_BASE_URL, and
COMPOSIO_CUSTOM_HEADERS. Clients created with with_options() keep using the resolved mapping
and do not fall back to ambient values.
Use the async client
import asyncio
from composio_client import AsyncComposio
async def main() -> None:
async with AsyncComposio(api_key="ak_...") as client:
session = await client.tool_router.session.create(user_id="user@example.com")
print(session.session_id)
asyncio.run(main())
Read raw response metadata
Every released resource keeps the Stainless raw and streaming accessors:
from composio_client import Composio
client = Composio(api_key="ak_...")
response = client.tool_router.session.with_raw_response.retrieve("sess_123")
print(response.status_code)
session = response.parse()
with client.tool_router.session.with_streaming_response.retrieve("sess_123") as response:
print(response.headers)
The async resource exposes the corresponding async response objects and context managers.
Handle API errors
The exception hierarchy matches the Stainless package. Existing except blocks keep working:
from composio_client import Composio, NotFoundError
client = Composio(api_key="ak_...")
try:
client.tool_router.session.retrieve("missing")
except NotFoundError as error:
print(error.status_code)
Migrate pre-release owned-client calls
Earlier owned-client builds accepted aggregate body, query, and headers values. Those calls
remain valid during the transition:
client.tool_router.session.create({"user_id": "user@example.com"})
client.tool_router.session.config_history("sess_123", query={"limit": 25})
Prefer the flat Stainless form in new code:
client.tool_router.session.create(user_id="user@example.com")
client.tool_router.session.config_history("sess_123", limit=25)
See the Python migration guide for compatibility details and the stricter credential transport rules.
Develop the Python package
Generate from the repository root:
pnpm generate:python
pnpm codegen:check
Run Python checks from python/:
uv run ruff check
uv run ruff format --check
uv run mypy src scripts
uv run pytest
uv run python scripts/check_stainless_compatibility.py
uv build
uv run python scripts/check_stainless_compatibility.py --wheel dist/*.whl
The normal compatibility check is offline. It reads the committed 1.43.0 fixture and does not
install or call the Stainless client.
Release files for composio-client 2.0.0rc8
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | |
|---|---|---|---|
| composio_client-2.0.0rc8.tar.gz | 593.4 kB | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| composio_client-2.0.0rc8-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 1.0 MB
Release files / composio_client-2.0.0rc8.tar.gz
| Download URL | composio_client-2.0.0rc8.tar.gz |
|---|---|
| Size | 593.4 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
cd03a2a02d42c15dbb363c1dddaece1c2889aa8e10e36cd1ee62022e871aebb4
|
|
BLAKE2b-256 checksum How to use checksums |
b17635ce3aa815d18f611fbc402c443df73fb9d66035a013fe512d64620cce11
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.14
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Sep 21, 2026.
Transparency logRelease files / composio_client-2.0.0rc8-py3-none-any.whl
| Download URL | composio_client-2.0.0rc8-py3-none-any.whl |
|---|---|
| Size | 432.9 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
759f856aa132b10c1bb3ed503ab3d73c44d71fd48bfd62547b1a663be7d99543
|
|
BLAKE2b-256 checksum How to use checksums |
84b107e0972086a5d8c3859d2d340308333dd13eac669e6987b6a0f89a9011fe
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.14
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Sep 21, 2026.
Transparency log
