> ## Documentation Index
> Fetch the complete documentation index at: https://mintlify.com/composiohq/composio/llms.txt
> Use this file to discover all available pages before exploring further.

# Installation

> Install the Composio Python SDK and provider packages

## Core Package

Install the core Composio SDK:

```bash theme={null}
pip install composio-core
```

Or use the `composio` package which includes the core:

```bash theme={null}
pip install composio
```

## Provider-Specific Packages

For AI framework integrations, install the corresponding provider package:

### OpenAI

```bash theme={null}
pip install composio-openai
```

### Anthropic (Claude)

```bash theme={null}
pip install composio-anthropic
```

### LangChain

```bash theme={null}
pip install composio-langchain
```

### LangGraph

```bash theme={null}
pip install composio-langgraph
```

### LlamaIndex

```bash theme={null}
pip install composio-llamaindex
```

### CrewAI

```bash theme={null}
pip install composio-crewai
```

### AutoGen

```bash theme={null}
pip install composio-autogen
```

### Google AI (Gemini)

```bash theme={null}
pip install composio-gemini
```

### Google Generative AI

```bash theme={null}
pip install composio-google
```

### Google ADK

```bash theme={null}
pip install composio-google-adk
```

## Requirements

* Python 3.10 or higher
* pip package manager

## Environment Variables

Set up your environment variables:

```bash theme={null}
# 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:

```python theme={null}
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:

```bash theme={null}
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:

```python theme={null}
# 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:

```python theme={null}
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:

```bash theme={null}
python -m venv composio-env
source composio-env/bin/activate
pip install composio-openai
```

## Next Steps

<CardGroup cols={2}>
  <Card title="Quick Start" icon="rocket" href="/python/overview">
    Get started with Composio Python SDK
  </Card>

  <Card title="Composio Client" icon="code" href="/python/api/composio">
    Learn about SDK configuration
  </Card>

  <Card title="Providers" icon="plug" href="/python/providers/overview">
    Choose your AI framework integration
  </Card>

  <Card title="Tools" icon="wrench" href="/python/api/tools">
    Start using tools
  </Card>
</CardGroup>