Skip to content

kelly-shen/eyebrowse-server

 
 

Repository files navigation

eyebrowse-server

Join the chat at https://gitter.im/haystack/eyebrowse-server

Eyebrowse allows users to automatically track and selectively publish their use of the Web in real-time. Currently, there is no simple way for the end-user to keep track of the vast time spent browsing the Web. Since there is no clear picture of how users access the Web as a whole, the Eyebrowse Project aims to allow public logging of Web usage through client-side services. Eyebrowse gives control to the user, while providing data for public use.

The concept of Eyebrowse is to gather browsing history from participating users. Depending on the particular distribution, it may either be used in a context where the data goes into a public repository, or it may be used in a context where the data is shared in a controlled way (such as among a group of users, but not publicly).

Get running in 5 minutes

First, check out the eyebrowse-server:

git clone [email protected]:haystack/eyebrowse-server.git
cd eyebrowse-server

The application requires some configuration variables for the database and a few other django-related things. We've provided config_template.py for you to add the required values, so use your favorite editor and fill that puppy out:

vim config_template.py

Next, you can install the python requirements and setup the config file you make.

Note: If you're setting up a dev with MYSQL, this might be helpful to get started:

$ sudo mysql
> CREATE USER 'admin'@'localhost' IDENTIFIED BY 'somepassword';
> CREATE DATABASE eyebrowse;
> USE eyebrowse;
> GRANT ALL PRIVILEGES ON eyebrowse.* TO 'admin'@'localhost';

Where the corresponding dictionary in config_template.py would read:

MYSQL_LOCAL = {
    'NAME': 'eyebrowse',
    'USER': 'admin',
    'PASSWORD': 'somepassword',
    'HOST': 'localhost',
}

Note: You need to use sudo if you are not working in a virtualenv.

make install
make run

The make install command has two arguments for setting up the environment

make install debug=[true|false] env=[prod|dev]

The default options are debug=true and env=dev.

There are several cron tasks that eyebrowse uses. If you want to install them, run

python manage.py installtasks

Most of them are not important for development purposes. The one exception would be the script for updating the popular feeds which should be run to populate them initially. Run the following at the python command line (with your eyebrowse virtual environment enabled):

from scripts.cron_tasks.populate_popular_history import *
populate_popular_history()

Common problems:

  1. DoesNotExist at /admin/ Site matching query does not exist.

For dev (stackoverflow reference):

 from django.contrib.sites.models import Site
 Site.objects.create(name='localhost:8000', domain='http://localhost:8000')

=======

Contact Info

Packages

No packages published

Languages

  • Python 73.2%
  • HTML 15.4%
  • JavaScript 9.5%
  • CSS 1.5%
  • PostScript 0.2%
  • Makefile 0.1%
  • Shell 0.1%