Skip to content
Switch branches/tags
Go to file
Cannot retrieve contributors at this time

keyvi: C++



In addition to a working gcc build environment, install the following libraries, e.g. using apt: boost (dev packages, at least version 1.54), snappy, zlib, cmake.

For example on Ubuntu (> 16.04) should install all the dependencies you need:

apt-get install cmake cython g++ libboost-all-dev libsnappy-dev python-stdeb zlib1g-dev


In addition to a working build setup (Xcode) install the following libraries using Homebrew:

brew install boost
brew install snappy
brew install lzlib
brew install cmake

Now you should be able to compile as explained above.

Windows (experimental)

The following procedure has been confirmed working with Visual Studio Community 2019, other versions or environments should work, too.


Use cmake to build keyvi executables along with unit tests.


mkdir build_dir_<BUILD_TYPE>
cd build_dir_<BUILD_TYPE>

<BUILD_TYPE> can be release, debug, coverage or any other available by default in cmake

To run cpp unit tests just execute unit_test_all executable.

Windows (experimental)

example windows command (make it 1 line):

-DSnappy_INCLUDE_DIR="C:\Program Files (x86)\Snappy\include"
-DSnappy_LIBRARY="c:\Program Files (x86)\Snappy\lib\snappy.lib"

(zlib should automatically be found if installed at the default location)

to build on the commandline (in addition cmake creates Visual Studio configs):

cmake --build . --config Release

Coding Rules

The cpp part of keyvi has to pass the checks as well as (5.0.0 at the moment, defined by our travis CI configuration).

The configuration of both tools is part of the project. You can check your changes against the config using the script. For your convenience consider using a plugin for your IDE of choice (e.g. CppStyle for Eclipse).

Formatting is not done automatically for you but code neads to be cleanly pushed.

The check must pass for all changed, including new, files.