The first step to using any software package is getting it properly installed.

From PyPI

Flipper is available on the Python Package Index. The preferred method for installing the latest stable release is to use pip (included in Python 2.7.9+ and Python 3.4+ by default):

$ pip install flipper --user --upgrade

If you don’t have Python installed, this Python installation guide can guide you through the process.


In order to use the flipper GUI on OS X, users must first update their copy of Tk/Tcl as described here. Flipper has been tested with ActiveTcl 8.5.18.

From source

Flipper is under active development and there are several ways to obtain its source code. As well as PyPI (and its mirrors), GitHub is the official distribution source; alternatives are not supported.

Via git

A git repository of Flipper’s source code is available on GitHub. You can either clone the public repository:

$ git clone git://

Or, download the tarball:

$ curl -OL
# optionally, zipball is also available (for Windows users).

Installing from source

Once you have a copy of the source, you can embed it in your own Python package, or install it into your site-packages easily:

$ cd flipper
$ pip install . --user