RapidSMS Documentation

RapidSMS is a free and open-source framework for dynamic data collection, logistics coordination and communication, leveraging basic short message service (SMS) mobile phone technology. It is written in Python and uses Django.



How to install RapidSMS on your computer and how to get started with community-contributed apps or developing your own.

Rapid SMS Explained

Various pages providing overviews, repository structures, and the technical architecture of RapidSMS. Think of this as a “RapidSMS for Dummies” type of section. A good place to peruse and learn concepts and vocabulary before digging into the code.

RapidSMS Examples

A few code examples of simple RapidSMS concepts.

Sending and Receiving SMS

How to get SMS into the real world (modems, gateways, etc.)

Differences with the new and old RapidSMS

Here is a short explanation of a few of the new things that RapidSMS has for those who are used to the old RapidSMS. Also includes instructions for porting your apps to work with the latest version RapidSMS.


Tips and tricks for when you’re ready to shove RapidSMS into the real world


A FAQ containing Frequently Asked Questions


How to get involved and contribute to RapidSMS

RapidSMS Apps

One day soon, all usable RapidSMS apps will be found or linked to from the following repositories:


PyCharm License

How to get RapidSMS’s open source license for PyCharm, JetBrains Python/Django IDE.




Writing and running tests


Find out how you can edit this wiki and what markup it uses

Tutorial Videos

Tips on recording RapidSMS tutorial videos in Linux

Kannel Configuration

Configuring RapidSMS to work with the Kannel SMS gateway

In Development

A list of other repositories, all works in progress, of new apps for RapidSMS

Previous topic

Frequently Asked Questions

This Page