Python Version

Clickhouse-driver supports Python 3.4 and newer, Python 2.7, 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: 2.7, 3.4, 3.5, 3.6, 3.7, 3.8.

Packages for Windows are available for python: 2.7, 3.5, 3.6, 3.7, 3.8.


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]

Installation from github

Development version can be installed directly from github:

pip install git+[email protected]#egg=clickhouse-driver