RapidSMS is a free and open source framework for building interactive SMS applications, which integrates tightly with Django to provide a rich reporting interface. It was created by the Innovation Team at UNICEF, and is under development by the RapidSMS Team.
- The very old RapidSMS codebase (AKA Tusker) that was living in rapidsms has been moved to rapidsms/rapidsms-legacy. If your clone or fork is still in use, you should update your repository's remote/origin.
- The combined repository of the contents of rapidsms-core-dev and rapidsms-contrib-apps-dev has replaced the old codebase in rapidsms.
- The
searchandtrainingapps that were in rapidsms-contrib-apps-dev have been removed and are now submodules of rapidsms-community-apps-dev. - The rapidsms-core-dev and rapidsms-contrib-apps-dev repositories will remain unchanged until the 1.0 release, but should now be considered deprecated.
- The PyPi package will now install from rapidsms.
This note will be removed from this README once RapidSMS 1.0 arrives.
RapidSMS is best installed via PyPi. To install the latest stable-ish version:
$ pip install rapidsms
Alternatively, to install the development version from GitHub:
$ pip install git+git://github.com/rapidsms/rapidsms.git#egg=RapidSMS
The RapidSMS project skeleton is identical to the Django project skeleton, with a few of our settings added. To quickly spawn a new project, we've bundled a wrapper around django-admin.py:
$ rapidsms-admin.py startproject myproject
The runrouter management command starts the router, sends and receives SMS (and other short messages) via the configurable backends:
$ python manage.py runrouter
The current documentation is at http://rapidsms.readthedocs.org/. For community policies and ongoing dicussions, you can also take a look at the RapidSMS wiki, but you may find more useful information on the mailing list for the time being.
RapidSMS is free software, available under the BSD license.
Please file bugs on the RapidSMS issue tracker, and/or submit a pull request.