pip and easy_install

Easiest way to install BFM is to use pip:

$ pip install django_bfm

And second to easiest is with easy_install:

$ easy_install django_bfm


Using easy_install is discouraged. Why? Read here.

GIT repository

Alternatively, you can clone and install from Github repository, where project is developed.

$ git clone git://
$ cd django-bfm
$ python2 install

or with pip:

pip install -e git+git://


Do not forget to compile .coffee files yourself if you are cloning repository from master. You can do so by running compile_coffee.


Enabling BFM

After downloading and installing BFM, you need to configure your Django project.

  1. Add 'django_bfm', to your INSTALLED_APPS in,
  2. Add url(r'^files/', include('django_bfm.urls')), to your urlpatterns in,
  3. Make sure you have staticfiles enabled (with a context processor) and run python collectstatic,
  4. Make sure, that static files are served correctly by your production server.


You don’t need to run collectstatic if you are working in develovepment server. It serves files automatically.