This is the main repository for the Marble Initiative project.
Marble is an opinion mining platform, modular and open sourced. This is part of a PhD project, being developed by Miguel Fernandes for the University of Vigo, under the supervision of Ana Fernández Vilas and Rebeca Díaz Redondo.
The platform is able to extract tweets from Twitter, using both the Search (history) and the Streaming (real-time) API, process the tweets extracted and extract their polarity values, and visualize the results using charts and reports.
All modules for this project are published in docker hub for free (as in speech). As of today, the docker images available are:
(The python2 and python3 processor modules found in the project are just the base structure for future python processors, they don't perform any processing at the moment)
docker-compose.yml configuration file is available for you to use directly on a docker-capable server. You will only need access to internet to start using marble (you don't even need a database, as it will be provided by docker too!).
Before starting up, open the
docker/core-config/application.yml file, and fill out the data for users and passwords that you want of for the system. For example:
access: admin: username: 'admin' password: 'adminpass' oper: username: 'oper' password: 'operpass' guest: username: 'guest' password: 'guestpass'
NOTE: Please don't use the users and passwords of the example, they are not at all safe!
Then, just go to the
docker folder in a terminal, and execute the following command:
# docker-compose up -d
Docker will retrieve the latest version of all module images, and start the marble service. You will have two services available:
If you want to keep an eye on the logs of one or all the modules running, you can execute the
logs command of
# docker-compose logs -f # docker-compose logs -f <module_name>