Installation¶

Python Version¶

Clickhouse-driver supports Python 3.4 and newer, Python 2.7, and PyPy.

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.

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

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

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

clickhouse-cityhash provides CityHash algorithm of specific version, see CityHash algorithm notes.
lz4 enables LZ4/LZ4HC compression support.
zstd enables ZSTD compression support.

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]

Development version can be installed directly from github:

pip install git+https://github.com/mymarilyn/clickhouse-driver@master#egg=clickhouse-driver