You can install batman with pip (recommended):

$ pip install batman-package

From source

You can also install directly from source. The most current stable release is up on PyPI and the development version can be found on GitHub.

Unpack the distribution with tar -xvf and navigate to the source root directory. To install, run the setup script:

$ sudo python install

Note that you’ll need to cd out of the source directory before you can import batman.

On Windows

Some intrepid users have braved the path of installing batman on Windows. Their advice is available on the issue tracker.


To check whether the install is working, I recommend running a few basic tests with:

$ python -c 'import batman; batman.test()'