Fast, complete Dota 2 game replay parser
Switch branches/tags
Nothing to show
Clone or download
Pull request Compare This branch is 3 commits behind skadistats:master.
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Failed to load latest commit information.


Skadi parses Dota 2 replay files.

This project does not yet use semantic versioning. There is no public/private API distinction at this point, though we are increasingly resisting changes to the main demo/streaming interface. For now, best to use Skadi with some caution. It may not be production ready.

The Wiki

We will be moving everything currently in this README into the wiki soon™.

Be sure to check out the "Pages" section, since organization is a work in progress.

In a Hurry?

Check out some simple usage in bin/skadi.


Skadi comes in two forms; as a pure Python library and as a cython optimised library. The cython version is significantly faster (from 2x to over 3x the speed), but may not work on all systems. To install the cython version, use:

python install

And, if that fails, the pure python version:

python install

If you are doing development work on skadi, or don't want to install it but still want to use the cython accelerated modules, you can build the cython modules in place:

python build_ext -i



The following C libraries and development headers are required

  • snappy
  • python-dev

And the python packages

  • protobuf

To install these dependencies with Ubuntu/Debian, the following may work:

apt-get install python-dev python-snappy python-protobuf

Pure Python

The following C libraries and python bindings are required:

  • snappy

And the python packages

  • protobuf
  • bitstring

To install these dependencies with Ubuntu/Debian, the following may work:

apt-get install python-snappy python-protobuf
pip install bitstring


I use the pioneering edith project as a reference implementation for parsing bit streams.

A big shoutout to the folks in #dota2replay on Quakenet. Feel free to stop by if you have any questions! (Be patient, we're around!)


We're counting on you: please mention Skadi when used in your projects. We ask for "Powered by Skadi" in the footer of your site template.

Skadi is offered under the MIT license.

This license applies to all revisions of source code until otherwise noted in the latest version of this document.