sudo social aims to be the an awesome stream publishing environment, suitable for self-hosted homepages, topic hubs, and distributed social networks.
JavaScript Python Shell
Switch branches/tags
Nothing to show
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Failed to load latest commit information.



sudoSocial is a labs experiment around creating a stream publishing platform. Lifestreams, Friendstreams, homepages, and topichubs all rely on streams for data.

Content aggregation has been around for a long time, but there isn't a popular open source self-hosted web app for owning the content and presentation of streams.


Respect for privacy and privacy control preferences are critical features that many users don't notice or care about currently. Privacy isn't an easy choice, there are no set it and forget it preferences. We [builders] can make many nuanced decisions. Example: Don't display timestamps in streams by default. You're leaking information (oh they're writing yelp reviews at work?) that isn't a primary concern. Authoring a lifestream that is displayed on a timeline... then include timestamps as it's relevant data.

Cloud control - full access to the user. Self-hosted, Import, export, delete account. The stream editor could show which entries are public, shared, and private.

Mozilla wants to broaden the community. One goal of this project is to be approachable and hackable for many different types of people.

            ____| CSS - Designer
       _____| Processing.js - Artist
   ____| JS - Web Developer
__| Python - Web Developer

Another goal is to demonstrate a well behaved distributed content publishing system. We want to republish content, but to push the value back into the originating source. Example: Display Flick photos in a really attractive way, send users to Flick as soon as possible, since that app is optimized for viewing and editing photos. Provide 'Like' and 'comment' features, but send that data back to Flickr (OpenLike? and Salmon?). The data the platform provides should be in standard formats (ActivityStreams) and be published with standards based markup (Microformats).

And of course, the overall Mozilla mission of keeping the web open and accessible.


This codebase is tri-licensed


Jeff Balogh James Socol (Bleach) Zach Hale Ian Bicking (Silver Lining)


This code and data is very early days and subject to change.

If you run into trouble installing or hacking, this framework is Django plus enhancements from from and, so you can refer to the docs from the zamboni project as well as Django 1.1 docs.


You'll need easy_install, MySQL client and server, and Python 2.5 or greater.

For Ubuntu you could do sudo apt-get install python-setuptools libmysqlclient-dev libxml2-dev libxslt1-dev python-dev sudo easy_install pip

  1. Grab the source

     git clone git://
     cd sudosocial
  2. Optional setup a virtualenv for sudosocial (See link above for zamboni virtual env setup and pro tips)

     easy_install virtualenv
     virtualenv --no-site-packages ~/.sudosocial
     source ~/.sudosocial/bin/activate

    Your command line should now show something like:

    pip install -r requirements.txt
  1. Any errors?

  2. create a database

     $ mysql -uroot -p 
     mysql> create database sudosocial_dev charset 'utf8';
     mysql> exit
  3. Create Django settings file and then edit mysql username and password

  4. run

     python syncdb
    python runserver
  1. Install cron job (or run manually once and a while)

Assuming your using virtualenv

    ~/.sudosocial/bin/python ~/sudosocial/cron/

(more details on setting up a cron are furth down in this README)

  1. Go to http://localhost:8000 Click "create your own Homestream"

Step 847, there is no step 847. It's that easy.

Updating after git pull

Things are still under development, so you have two choices after a git pull brings down changes (and migration files)

  1. Update the database Drop database and syncdb or From mysql prompt, execute the migrations under docs/database/migrations/

    pip install -r requirements.txt
  1. Check for updates to the file



What is "patchouli" in the code? This was the working name of the project. This project is a small step towards personal cloud control. In meatspace, Hippies use patchouli instead of showers and deodorant. Respect... I'm a neo-hippie, I'm just say'n.

sudoSocial is a slightly better name. Patches welcome :)


Feeds are fetch and entries are pickled and stored in the database. When a stream is viewed, the appropriate entries are retrieved, and a mapping is made from feed url to an importer. The importer gets to prepare the feed via and then render it via entry.html

Want to customize how a certain feed is handled?

  1. Run bin/
  2. Add a regex to lifestream/ in the websiteFeedType function
  3. Edit lifestream//
  4. Edit templates//entry.html

TODO Put these three items into the same directory.


Feed Fetcher

Assuming you had this code in /home/ozten/sudosocial and a virtualenv under /home/ozten/.virtualenvs/sudosocial, you would

  1. cp /home/ozten/sudosocial/cron/ /home/ozten/sudosocial/cron/

  2. Edit /home/ozten/sudosocial/cron/ (optional)

  3. install the following cron:

     # m h dom mon dow   command
     */5 * *   *   *     /home/ozten/.virtualenvs/sudosocial/bin/python /home/username/sudosocial/cron/ > /home/username/sudosocial/cron/feeder.log


There is the begginings of a Plugin system. Poke around under the plugins directory. APIs are not frozen. "I must break you"