Get it


twyg is compatible with Python 2.5, 2.6 and 2.7. It can be used as a command line utility, in which case it requires the Cairo graphics library and the Pycairo Python bindings for graphics rendering. Python 2.5 users will also need to install simplejson.

You can also use twyg as a NodeBox1 library. Please refer to the documentation for details.


On Mac OS X and Unix-like systems, you can easily install twyg by issuing the following command from the terminal, providing you already have Cairo, Pycairo and pip installed:

pip install twyg

For detailed platform specific instructions, please refer to the Installation section of the documentation.

Distribution package

You can download the latest distribution package from the Python Package Index (PyPi). Note that the package contains some extras (e.g. example data) that you won't get if you just install it with pip.

Alternatively, you can download the latest development version as a ZIP file from the project's GitHub page, or just clone the repository if you are familiar with git.

You can also download a version of the documentation suitable for offline viewing here.