This is the Mwana MNCH RapidSMS project for deployment in Zambia and Malawi. It includes Results160, a tool for delivering DBS test results to health clinic workers, and RemindMi, a birth registration and appointment reminder system for community based agents (such as CHWs and HSAs).
We are using git-flow to help manage our development process.
- Learn how to use git-flow at:
- You can download and install git-flow from:
- Learn more about the methodology behind it at:
A Linux-based development environment including Python 2.6. Ubuntu 10.04 or later is recommended. At present, Windows-based environments are not actively supported.
PostgreSQL and the appropriate Python bindings (psycopg2). In Debian-based distributions, you can install these using apt-get, e.g.:
sudo apt-get install postgresql python-psycopg2
Install pip and virtualenv, and make sure virtualenv is up to date, e.g.:
easy_install pip pip install -U virtualenv pip install -U virtualenvwrapper
Install git-flow (see above).
To setup a local development environment, follow these steps:
Clone the code from git, checkout the develop branch, and initialize git-flow:
git clone firstname.lastname@example.org:mwana/mwana.git cd mwana/mwana git checkout develop git flow init # just accept all the default answers
Create a Python virtual environment for this project:
mkvirtualenv --distribute mwana-dev workon mwana-dev
Install the project dependencies into the virtual environment:
Create local settings file and initialize a development database:
cp localsettings.py.example localsettings.py gedit localsettings.py # replace <country> with zambia or malawi in the first line createdb mwana_devel ./manage.py syncdb
In one terminal, start RapidSMS router:
mkdir logs ./manage.py runrouter
In another terminal, start the Django development server:
Open http://localhost:8000 in your web browser and you should see an Installation Successful! screen.