Batucada is a ground up rewrite of drumbeat.org in Django.

To install Batucada, you must clone the repository:

git clone git://github.com/paulosman/batucada.git

If you're planning on contributing back to the project, fork the repository instead in the usual GitHub fashion.

Next, you'll need to install virtualenv and pip if you don't already have them:

sudo easy_install virtualenv
sudo easy_install pip

Using virtualenvwrapper is also recommended (see the installation instructions). Be sure to configure your shell so that pip knows where to find your virtual environments:

# in .bashrc or .bash_profile
export WORKON_HOME=$HOME/.virtualenvs
export PIP_VIRTUALENV_BASE=$WORKON_HOME
export PIP_RESPECT_VIRTUALENV=true
source /usr/bin/virtualenvwrapper.sh

Now create a virtual environment for batucada and install its dependencies:

cd batucada
mkvirtualenv --no-site-packages batucada
workon batucada
pip install -r requirements/compiled.txt
pip install -r requirements/dev.txt

There's a chance that packages listed in requirements/compiled.txt won't install cleanly if your system is missing some key development libraries. For example, lxml requires libxsml2-dev and libxslt-dev. These should be available from your system's package manager.

To be extra sure you're working from a clean slate, you might find it helps to delete .pyc files:

find . -name "*.pyc" | xargs rm

Create a settings_local.py based on the template provided in the checkout. Edit the database parameters as needed

cp settings_local.dist.py settings_local.py

Now sync the database and run migrations.

python manage.py syncdb --noinput

There's a problem with real databases (read: not sqlite) where south migrations are run in an order that violates foreign key constraints. See Bug # 623612 for details. Until that is fixed, you're best off running migrations in this order.

python manage.py migrate projects
python manage.py migrate users
python manage.py migrate activity
python manage.py migrate statuses
python manage.py migrate links
python manage.py migrate dashboard
python manage.py migrate relationships

What a pain!

Finally, start the development server to take it for a spin.

python manage.py runserver

To help out with batucada, join the Drumbeat mailing list and introduce yourself. We're currently looking for help from Django / Python and front-end (HTML, CSS, Javascript) developers.