A project which tries to define the social networks that can be defined from
letters written in the nineteenth century. Currently the project focuses on
Charles Dickens but this will be expanded as new datasets are created. 

Project home page (wiki): http://wiki.okfn.org/p/Open_Letters

Installation and Setup
======================

You will need to have python, mercurial, setuptools, virtualenv and pip to
install ``openletters`` (all other dependencies will be automatically installed
using pip)::

    # check out the code to openletters directory
    hg clone https://knowledgeforge.net/letters/hg openletters

    # move into the directory
    cd openletters

    # now install it to virtualenv at ../pyenv-openletters using pip
    pip -E ../pyenv-openletters install -r pip-requirements.txt


Make a config file as follows::

    paster make-config openletters development.ini

Tweak the config file as appropriate and then setup the application::

    paster setup-app config.ini

Then you are ready to go.


Using the Command Line Tools
============================

Our command line tools have been created as `paster commands` (and found in
openletters/cli.py). To get a list do::

    paster -h

And look at commands in openletters section (some of other commands may be
useful to). To get more info on a given command do::

    paster {command} -h

.. _paster commands: http://pythonpaste.org/script/developer.html