Visualisations for rapidsms based on the polling app
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Failed to load latest commit information.



Ureport is a user-centered social monitoring tool designed to strengthen community-led development and citizen engagement. It allows users to speak out on what is happening in their community and feeds back useful information to assist users to enact change in your community.

Technically speaking, Ureport leverage the work of rapidsms-polls ( to provide an easy system for polling a large number of users, and adds a visualization layer to aggregate poll results exposed in as JSON in the polling app.

A running example of ureport can be viewed at



Before installation, be sure that your clickatell two-way callback points to:

This is essential if you want to receive incoming messages.

It's highly recommended that you use a virtual environment for a Ureport project. To set this up, create the folder where you want your Ureport project to live, and in a terminal, within this folder, type:

~/Projects/ureport$ pip install virtualenv
~/Projects/ureport$ virtualenv env
~/Projects/ureport$ source env/bin/activate

Ureport can be installed from a terminal or command prompt using:

~/Projects/ureport$ pip install -e git+


For linux, the provided script can be run immediately after installation:


This will do some basic configuration to get your install up-and-running. It makes some assumptions about the configuration of whatever database software you've installed, so if you're more confident with performing each step manually, here's a summary of what the script does:

  • Patches Django 1.3 (a bug that prevents the Ureport visualizations for working, acceptance pending)
  • Creates a project folder for Ureport (running startproject ureport-project)
  • Tweaks the file in your project to your parameters (settings.DATABASES, clickatell account information)
  • Creates the database tables (running syncdb)
  • Runs the server (running runserver)

After you've completed this configuration, you should be able to point your browser to http://localhost:8000/ and see your Ureport install up and running! To start uploading users, click on the "ureporters" tab to upload a spreadsheet.

#Commnent to test writability of repository