Welcome to whirlwind

The goal of whirlwind is to provide an easy to use python framework built on top of todays fastest tech. The whirlwind code base was originally developed as the underlying web framework for the social media metrics and analytics platform http://trendrr.com.

Take a look at our wiki for docs and more info.

Setup instructions

On Ubuntu (recommended)

install python dev

sudo apt-get install python-dev

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 tornado
sudo easy_install Mako
sudo easy_install MongoKit
sudo easy_install python-dateutil
sudo easy_install pytz

clone whirlwind

git clone git://github.com/trendrr/whirlwind.git

change to whirlwind directory

cd whirlwind

run the setup script

sudo python setup.py install

On Windows

download and install python

http://www.python.org/download/

download and install setup tools

http://pypi.python.org/pypi/setuptools#files

upgrade setuptools

easy_install -U setuptools

install required python modules

easy_install tornado
easy_install Mako
easy_install MongoKit
easy_install python-dateutil
easy_install pytz

clone whirlwind

git clone git://github.com/trendrr/whirlwind.git

change to whirlwind directory

cd whirlwind

run the setup script

python setup.py install

Now whirlwind is installed

to create a whirlwind app

whirlwind-admin.py --create-application myapp

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

to start app

python main.py

thats it! now just point your browser to the app start page to see whirlwind in action.

http://localhost:8000/