RubySMS is a Ruby library (not a framework, although it's coming dangerously close) which aims to make developing and deploying SMS applications easy. The sending and receiving of "real" SMS is handled by RubyGSM[http://github.com/adammck/rubygsm], but RubySMS also provides a couple of ways to interact with "mock" SMS via a web interface (the HTTP Backend) and GTK GUI (the DRB backend).
RubySMS was initially developed in Malawi by {The UNICEF Innovation Team}[http://unicefinnovation.org/about.php] and a group from Columbia University's {SIPA}[http://sipa.columbia.edu/] as the technical foundation of the {RapidSMS Child Malnutrition Survelliance}[http://netsquared.org/projects/child-malnutrition-surveillance-and-famine-response] (see {the source code}[http://github.com/adammck/columbawawi]) entry to the {USAID Development 2.0 Challenge}[http://netsquared.org/usaid]... which[http://globaldevelopmentcommons.net/node/876] we[http://unicef.org/infobycountry/usa_47068.html] won[http://sipa.columbia.edu/news_events/announcements/sipanews10.html].
=== Sample Application
require "rubygems" require "rubysms"
class DemoApp < SMS::App def incoming(msg) msg.respond("Wow, that was easy!") end end
DemoApp.serve!
=== Installing RubySMS is distributed via GitHub[http://github.com/adammck/rubysms], which you must add as a Gem source before installing:
$ sudo gem sources -a http://gems.github.com
Then install the Gem, which will automatically pull in the dependencies:
$ sudo gem install adammck-rubysms
=== Dependencies If you'd prefer to run RubySMS from the trunk, you'll need to install the following Gems manually (otherwise, the HTTP backend will explode on startup. Remind me to fix that some time).
$ sudo gem install rack mongrel
If you'd like to send real SMS via a GSM modem, you'll also need RubyGSM:
$ sudo gem install adammck-rubygsm