Skip to content
This repository was archived by the owner on Jun 21, 2021. It is now read-only.

rhenium/aclog

Folders and files

NameName
Last commit message
Last commit date

Latest commit

032f105 · Feb 18, 2016
Feb 10, 2016
Aug 7, 2015
Jan 22, 2016
Jan 22, 2016
Sep 1, 2015
Feb 18, 2016
Feb 18, 2016
Feb 18, 2016
Aug 29, 2015
Jun 8, 2013
Aug 7, 2015
Dec 5, 2015
Feb 3, 2016
Dec 5, 2015
Aug 7, 2015
Aug 7, 2015
Jan 19, 2016
Feb 10, 2016
Aug 7, 2015
Jan 19, 2016
Sep 14, 2014
Jan 19, 2016
Feb 18, 2016
Mar 13, 2014
Apr 19, 2015

Repository files navigation

Aclog Build Status Coverage Status

is a web application that tracks users' retweeting and favoriting on Twitter in real-time.

  • is powered by Ruby, EventMachine, Ruby on Rails and Vue.js
  • is completely free and open source (The MIT License)
  • has scalable structure: capable of handling over 6k users = 6k simultaneous UserStream connections.

Status

Features

  • Collecting likes and retweets via Twitter Streaming API
  • Protected accounts support
  • JSON API (with OAuth Echo)
  • Atom feed

Requirements

  • Linux (WorkerNode optionally needs epoll)
  • Ruby 2.3.0
  • MySQL/MariaDB >= 5.5.14 (utf8mb4 support is required)
  • memcached
  • Node.js >= 4.0

Installation

Aclog has 3 components:

  • / - application backend (Rails, requires MySQL and memcached)
  • /frontend - client side code (Node.js)
  • /worker_node - event collecter node (plain Ruby, requires memcached)

So, there are some files you have to configure:

  • /config/settings.yml - Main configuration
  • /config/database.yml - Database user / password
  • /config/secrets.yml - Rails's secret_key_base
  • /frontend/settings.js - Frontend configuration
  • /worker_node/settings.yml - WorkerNode configuration

For production, read INSTALL.md for details.
For development, you can run aclog on your machine with foreman, after configuration.

cd /path/to/aclog
bundle install
bundle exec rake db:setup

cd worker_node && bundle install && cd ..
cd frontend && npm install && cd ..

foreman run
# will run all components in foreground (this currently listens tcp/3000 (backend), tcp/3001 (frontend), tcp/3002 (reverse proxy)
# you will be able to access your aclog at http://localhost:8001/

Special Thanks

License

MIT License. See the LICENSE file for details.