Quick start


These steps assume that you have the following available on your system:

  • pip
  • Git
  • Mercurial

Set up a development environment

git clone
cd Arkestra
make develop
source .env/bin/activate

From this point you can wrestle Arkestra into submission on your own, or get started using the example project included.

Set up the supplied example project

Arkestra includes an example project for Django 1.4.

Assuming that your code was installed into src/arkestra in your virtualenv:

cd example
python syncdb --noinput --all # set up a new database; don't prompt for superuser and use syncdb even on applications with migrations
python loaddata example_database.json # load the example database from the fixture

Fire up the server

python runserver # go!

You should see the famous Institute of Mediaeval Medicine website, complete with images and all kinds of interesting content.

Username and password are both arkestra.


When you start up the server, you may not see any of the news/events/vacancies/studentships items you’d expect.

That’s because they’re out of date by now - this database was created some time ago.

Go into the news/events/vacancies/studentships and give them more appropriate dates.

Run tests

For tests, pytest test framework with nice pytest-django plugin is used instead of standard unittest approach recommended by Django.

To run tests:

py.test tests

For multipython testing, use just:


To see test coverage:

tox -e coveralls