Hardware Requirements

One of our goals with PySoy is support games for everyday desktop and mobile users so our hardware requirements are quite low. Any modern video card or mobile device should support OpenGL ES 2.0.


See INSTALL in both the libsoy and pysoy source trees. This file contains our current dependencies and easy copy/paste command lines for most popular GNU/Linux distributions.

Development Essentials

To work on PySoy you must first get a working copy of  Mercurial and clone the repositories to your computer:

hg clone http://hg.pysoy.org/libsoy
hg clone http://hg.pysoy.org/pysoy

Beyond the runtime dependencies, you will also need a copy of  valac to compile the Genie source (.gs) to C source (.c). You will also need the C headers (.h) for all our runtime dependencies, Redhat and Debian based distributions (including Ubuntu and Fedora) provide these in separate *-dev packages.

Once all these requirements are met, you can use  waf to build libsoy. Waf is self-contained in our source tree and only depends on Python to run:

./waf configure
./waf build
sudo ./waf install

During the configure step waf will check to ensure all dependencies are met and report any that are missing.

PySoy itself depends only on Python 3.1+ and libsoy, and is a bit more complex since most Linux distributions are not setup for Python 3 or search /usr/local for pkgconfig:

PKG_CONFIG_PATH="/usr/local/lib/pkgconfig" python3 waf configure
python3 waf build
sudo python3 waf install

With these steps you should be able to modify and test changes to the source. Join #PySoy on irc.freenode.net for help and how to commit improvements back to the Mercurial repository.