Skip to main content

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

Build docs developers (and LLMs) love