Download and compilation


[NEW] - debian packages on Launchpad

You can download a package directly from


The rest of the instructions here are for building Hermes from source.

If you are using a Debian-based system, install the (required) libraries first:

apt-get install git git-core cmake g++ freeglut3-dev libsuitesparse-dev libglew-dev libxerces-c-dev xsdcxx libmatio-dev

If you want to use fast saving / loading of Hermes entities, install

For thread caching memory allocator from Google, see

To obtain the source code, clone the Git repository from Github:

git clone

These two repositories are synchronized. For more advanced users we recommend to create a free account at Github (if you do not have one yet), fork the Hermes repository, and then clone your Github copy of Hermes to your local computer. This will establish links between your local copy and the master repository, and you’ll become part of the Hermes network at Github.

Once you have a local copy of the Hermes repository on your computer, change dir to hermes/. There you will find a CMake.vars.example.Linux file that looks like this:

  # On linux, there should be no need to set up *_ROOT directories, in the default settings, they all point to /usr/local, as should be true on Debian systems.
  # We mainly support gcc and CLang compilers with C++11 support.


  # Global
# Generate static libs (instead of dynamic)
  # Target path
  set(CMAKE_INSTALL_PREFIX "/usr/local")

  # Paths for compulsory dependencies
  set(XERCES_ROOT "/usr/local")
  set(XSD_ROOT "/usr/local")

  # HermesCommon

    # Release and debug versions

Copy this file to “CMake.vars” and set the variables according to your needs. After that, type:

cmake .

If you have more than one CPU, you can use “make -jN” where N is the number of CPUs of your computer.

Debugging with Eclipse

To use eclipse as debugger, in the root folder of the project:

mkdir eclipse_build
cd eclipse_build
cmake -G"Eclipse CDT4 - Unix Makefiles" -D CMAKE_BUILD_TYPE=Debug ../

In Eclipse:

  • Import project using Menu File->Import
  • Select General->Existing projects into workspace:
  • Browse where your build tree is and select the root build tree directory.
  • Keep “Copy projects into workspace” unchecked.

Install Hermes

make install

Table Of Contents

Previous topic


Next topic