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

README.md

happening README

Description

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.

Purpose:

  • 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

Dependencies

  • twitter: A twitter account, an application dev.twitter.com/apps, and its authentication keys.

  • tweepy: pip install tweepy

Keys

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

apikey=
apikeysecret=
accesstoken=
accesstokensecret=

Stream data from a geographic region

python streamFromGeo_twitter.py

Currently writes data to disk.

Search for data within a geographic region

python searchForGeo_twitter.py

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 manage.py file: python manage.py runserver, and open your web browser to localhost:5000.