GameSoup is a two stage board game development environment written using Django.

The project dependencies can be easily installed using standard Python distribution tools. If you're not already using these tools, please install them now:

• pip
• virtualenv
• virtualenvwrapper

After installing these tools you might want to set some environment variables. Assuming Bash, put this into your .bashrc file:

# virtualenvwrapper
export WORKON_HOME=~/Envs
source /usr/local/bin/virtualenvwrapper.sh
export PIP_VIRTUALENV_BASE=$WORKON_HOME
export PIP_RESPECT_VIRTUALENV=true

Create a virtual environment for gamesoup:

mkvirtualenv gamesoup --no-site-packages

Clone the repo into the virtual environment:

workon gamesoup
cdvirtualenv
git clone git://github.com/ktonon/GameSoup.git

Install the project dependencies with pip:

cd GameSoup
pip install -r gamesoup/requirements.txt

Copy the local_settings example file:

cp gamesoup/local_settings.py.template gamesoup/local_settings.py

Create the database:

gamesoup/manage.py syncdb

Install sample data:

script/loaddata

Run the server:

gamesoup/manage.py runserver

If you want to see the flow charts of game objects, you will need to install GraphViz.

In your browser visit http://localhost:8000/admin and login using the account you creating while preparing the database.

• To play a game of boggle visit http://localhost:8000/admin/matches/match/1/play/
• To see the guts of the boggle game visit http://localhost:8000/admin/games/game/1/assemble/
• To dig deeper and see what the guts themselves are made of visit http://localhost:8000/admin/library/