Installation

Install the Composio Python SDK and provider packages

Core Package

Install the core Composio SDK:

pip install composio-core

Or use the composio package which includes the core:

pip install composio

Provider-Specific Packages

For AI framework integrations, install the corresponding provider package:

OpenAI

pip install composio-openai

Anthropic (Claude)

pip install composio-anthropic

LangChain

pip install composio-langchain

LangGraph

pip install composio-langgraph

LlamaIndex

pip install composio-llamaindex

CrewAI

pip install composio-crewai

AutoGen

pip install composio-autogen

Google AI (Gemini)

pip install composio-gemini

Google Generative AI

pip install composio-google

Google ADK

pip install composio-google-adk

Requirements

• Python 3.10 or higher
• pip package manager

Environment Variables

Set up your environment variables:

# Required: Your Composio API key
export COMPOSIO_API_KEY="your-api-key"

# Optional: Custom API base URL
export COMPOSIO_BASE_URL="https://api.composio.dev"

# Optional: Logging level (silent, error, warn, info, debug)
export COMPOSIO_LOGGING_LEVEL="info"

# Optional: Disable telemetry
export COMPOSIO_DISABLE_TELEMETRY="true"

# Optional: Specific toolkit versions
export COMPOSIO_TOOLKIT_VERSION_GITHUB="20250906_01"

Verify Installation

Verify your installation:

import composio
from composio import Composio

print(f"Composio version: {composio.__version__}")

# Initialize with API key
client = Composio(api_key="your-api-key")
print("Successfully initialized Composio SDK")

Development Installation

For development, clone the repository and install in editable mode:

git clone https://github.com/composiohq/composio.git
cd composio/python

# Create virtual environment
python -m venv .venv
source .venv/bin/activate  # On Windows: .venv\Scripts\activate

# Install in development mode
make env  # Installs all dependencies including dev tools

Troubleshooting

Import Errors

If you encounter import errors, ensure you’ve installed the correct package:

# Core SDK
from composio import Composio

# Provider-specific imports
from composio_openai import OpenAIProvider
from composio_anthropic import AnthropicProvider
from composio_langchain import LangchainProvider

API Key Issues

If you get ApiKeyNotProvidedError, ensure your API key is set:

import os
from composio import Composio

# Option 1: Environment variable
os.environ["COMPOSIO_API_KEY"] = "your-api-key"
composio = Composio()

# Option 2: Direct initialization
composio = Composio(api_key="your-api-key")

Version Conflicts

If you experience version conflicts, use a virtual environment:

python -m venv composio-env
source composio-env/bin/activate
pip install composio-openai

Next Steps

Quick Start

Get started with Composio Python SDK

Composio Client

Learn about SDK configuration

Providers

Choose your AI framework integration

Tools

Start using tools