Install the requirements

$ pip install -r requirements-dev.txt


lxml, used in the tests, requires that libxslt and libxml2 be installed on the system.

Clone the git repository:

$ git clone
$ cd django-major-event-log

Initialize the database

$ python migrate

Create a superuser so you can create test events

$ python createsuperuser

Start the development server

$ python runserver

You should now be able to access the admin portion of the app at and the public-facing side of the app at


To run the tests in the development environment:

$ python test ./tests

You can also run the tests with Tox:

$ [sudo] pip install tox
$ tox