Python Version

Clickhouse-driver supports Python 3.4 and newer and PyPy.

Build Dependencies

Starting from version 0.1.0 for building from source gcc, python and linux headers are required.

Example for python:alpine docker image:

apk add gcc musl-dev

By default there are wheels for Linux, Mac OS X and Windows.

Packages for Linux and Mac OS X are available for python: 3.5 – 3.10.

Packages for Windows are available for python: 3.5 – 3.10 .


These distributions will be installed automatically when installing clickhouse-driver.

  • pytz library for timezone calculations.
  • enum34 backported Python 3.4 Enum.

Optional dependencies

These distributions will not be installed automatically. Clickhouse-driver will detect and use them if you install them.

Installation from PyPI

The package can be installed using pip:

pip install clickhouse-driver

You can install extras packages if you need compression support. Example of LZ4 compression requirements installation:

pip install clickhouse-driver[lz4]

You also can specify multiple extras by using comma. Install LZ4 and ZSTD requirements:

pip install clickhouse-driver[lz4,zstd]

NumPy support

You can install additional packages (NumPy and Pandas) if you need NumPy support:

pip install clickhouse-driver[numpy]

NumPy supported versions are limited by numpy package python support.

Installation from github

Development version can be installed directly from github:

pip install git+