> ## Documentation Index
> Fetch the complete documentation index at: https://docs.cow.bleu.builders/llms.txt
> Use this file to discover all available pages before exploring further.

# Installation

> Learn how to install the CoW Protocol Python SDK

## Prerequisites

Before installing the CoW Protocol Python SDK, ensure you have the following:

**Python Version**: Python 3.10 or higher is required.

<Note>
  The SDK is tested on Python 3.10, 3.11, and 3.12. We recommend using the latest stable Python version for the best experience.
</Note>

## Installation via pip

The easiest way to install the CoW Protocol Python SDK is via pip:

```bash theme={null}
pip install cowdao-cowpy
```

<Tip>
  It's recommended to use a virtual environment to manage your project dependencies. You can create one using `venv` or `poetry`.
</Tip>

## Using Poetry

If you're using Poetry for dependency management, add the SDK to your project:

```bash theme={null}
poetry add cowdao-cowpy
```

## Development Installation

For contributors or developers who want to work with the source code:

```bash theme={null}
git clone https://github.com/cowdao-grants/cow-py.git
cd cow-py
```

```bash theme={null}
poetry install
```

```bash theme={null}
poetry shell
```

## Verify Installation

After installation, verify that the SDK is working correctly:

```python theme={null}
from cowdao_cowpy.order_book.api import OrderBookApi
from cowdao_cowpy.common.chains import Chain

# Initialize the API client
order_book_api = OrderBookApi()

print("CoW Protocol SDK installed successfully!")
```

<Warning>
  If you encounter import errors, ensure your Python version meets the minimum requirement (3.10+) and all dependencies are properly installed.
</Warning>

## Environment Setup

For interacting with the CoW Protocol, you'll need:

<Steps>
  <Step title="Private Key">
    An Ethereum wallet private key (for signing transactions)
  </Step>

  <Step title="RPC Endpoint">
    Access to an Ethereum/Gnosis Chain node (optional, but recommended for production)
  </Step>
</Steps>

<Warning>
  Never commit your private keys to version control. Use environment variables or `.env` files (with `.gitignore`) to manage sensitive credentials.
</Warning>

## Next Steps

Now that you have the SDK installed, continue to the [Quickstart](/cow-py/quickstart) guide to learn how to execute your first token swap.