Install

Installation Instructions

On Ubuntu (recommended)

install python dev

sudo apt-get install python-dev

install tornado, follow instructions on:

http://www.tornadoweb.org/documentation#download

install the python setup tools

sudo apt-get install python-setuptools

upgrade setuptools

sudo easy_install -U setuptools

install required python modules

sudo easy_install Mako
sudo easy_install MongoKit
sudo easy_install python-dateutil
sudo easy_install pytz

install whirlwind

download a copy of whirlwind from https://github.com/trendrr/whirlwind/ or alternately clone a copy of the git repo

untar/unzip archive

tar -xzf trendrr-whirlwind-5c17ff8.tar.gz

change to whirlwind directory

cd whirlwind

run the setup script

sudo python setup.py install

On Windows

For instructions on how to install whirlwind on windows, visit this page.

Creating a new Application

If you came to this page via the Quickstart tutorial, you should probably not continue with the instructions below. Return back to the QuickStart tutorial.

After running the setup script, cd into the directory where you wish to create your new application (for example, you could cd to your home directory).

to create a whirlwind app

whirlwind-admin.py --create-application myapp

This creates a new whirlwind application myapp in the current directory.

fill in env specific settings in settings file [config/settings.py]

# generate a cookie secret (copy output to config/settings.py)
whirlwind-admin.py --gcs

This prints a cookie secret to standard output. Copy this cookie secret and set the variable cookie_secret to the printed out cookie secret.

to start app

python main.py

Refer to our FAQ should you encounter any problems in installation.