Fetching contributors…
Cannot retrieve contributors at this time
95 lines (58 sloc) 3.66 KB


Batucada is a ground up rewrite of in Django.


To install Batucada, you must clone the repository:

git clone 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
source /usr/bin/

virtualenvwrapper is sometimes installed to /usr/local/bin/ so if you set things up and are informed of missing file errors change the location accordingly.

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.

Problems have also been experienced with using Xcode4. If you're pip installs fail try giving things a kick by running the following and try it again:

ARCHFLAGS="-arch i386 -arch x86_64"

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 based on the template provided in the checkout. Edit the database parameters as needed


If you have yet to get a local version of mysql running you will want to do so now.

In order to run the migrations and syncd command you need to have an empty database set up. Default name is 'batucada', if you didn't change anything in then you can simply run, from an mysql command line:


Now sync the database and run migrations.

python 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 migrate projects
python migrate users
python migrate activity
python migrate statuses
python migrate links
python migrate dashboard
python migrate relationships
python migrate feeds
python migrate challenges

What a pain!

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

python runserver

Get Involved

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.