Collecting XForms data in Couch(DB)
Switch branches/tags
Nothing to show
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Failed to load latest commit information.


Cushions is a lightweight data-collection tool that uses XForms and CouchDB.
It's meant to be a server-side backend to JavaRosa or ODK.

It's named for the way that artifacts like spare change collect in the cushions
of a couch. Your data is collected here for you to find and use later on.

It is currently an extremely bare proof-of-concept collection of tools. Sorry
about how ugly it is.

This assumes you have couchdb, setuptools and pip installed. The easiest way 
to get couch is to grab an installer from We are 
compatible 1.0.1+. On Ubuntu, apt-get makes installation super easy:

$ sudo apt-get install couchdb


Download or clone the repository from git.

If needed, install setuptools and pip.

Initialize and update the submodules:

$ git submodule init
$ git submodule update

Install dependencies (must be run as root)

$ sudo pip install -r requirements.txt

If you run into problems when pip tries to install psycopg2, check out
the following solution on Stack Overflow:

If you need to make any changes to settings please add a file 
to the root directory. This is a good place to configure your django and couch 
databases. You can use the to get you started

$ cp  

Finally, sync and run server.

$ python syncdb
$ python runserver

Cushions should be running at http://localhost:8000