Find trending social activity in meatspace
Switch branches/tags
Nothing to show
Clone or download
Latest commit 9d03879 Mar 7, 2017

happening README


This Is Happening was a web application developed over three weeks during the fall of 2014 when I was a fellow at Insight Data Science. See this PDF for a quick overview.


  • Aggregate streaming social activity to find events that you might not otherwise stumble upon!
  • Not just a real-time social media mapper, find anomalous events that stand out above typical background activity!
  • That is to say: Locate trending social activity in meatspace!

Getting Started


  • twitter: A twitter account, an application, and its authentication keys.

  • tweepy: pip install tweepy


Make a file named twitauth.cfg in the project's root directory your application's keys from


Stream data from a geographic region


Currently writes data to disk.

Search for data within a geographic region


Currently does not write data to disk.

Running the app

  1. Recommended: Install virtualenv and fire up a virtual environment.
# Install virtualenv
sudo pip install virtualenv

# Create virtualenv folder `venv`
virtualenv venv

# Activate the virtual environment
source venv/bin/activate
  1. Install Python project dependencies.
pip install -r requirements.txt
  1. To test your application, run the file: python runserver, and open your web browser to localhost:5000.