Skip to content

HTTPS clone URL

Subversion checkout URL

You can clone with
or
.
Download ZIP
Language sentiment analysis and neural networks... for trolls.
JavaScript
tree: 48e157eb78

Fetching latest commit…

Cannot retrieve the latest commit at this time

Failed to load latest commit information.
lib
test
.gitignore
.travis.yml
LICENSE.md
README.md
makefile
package.json

README.md

troll

Language sentiment analysis and neural networks... for trolls.

Build Status

Troll is a tool for performing sentiment analysis (ie: "is this naughty or nice") on arbitrary blocks of text and associating it with a unique user. Using this data, combined with a rather naïve neural network and some training data, users can be indentified as "trolls".

Installation

Troll uses Redis for data storage. Once Redis is up and running, you can install Troll using NPM:

npm install troll

String Analysis

var troll   = require('troll');

troll.analyze('This is totally awesome!', 'user123', function (err, result) {
    console.log(result);    // 4
});

troll.analyze('This is lame.', 'user456', function (err, result) {
    console.log(result);    // -2
});

Training

Before attempting to classify a user, you'll need to train Troll. You can specify your own training data or use a basic set that is included. To load the included training set:

troll.train(function (err, result) {
    console.dir(result);    // { error: 0.0049931996067587685, iterations: 802 }
});

User Classification

Once trained, now you can classify:

troll.classify('user123', function (err, result) {
    console.dir(result);    // { total: 9, sum: 36, troll: 0.010294962292857838 }
});

The value returned for the troll key represents the probability of that user being a troll. In other words, a value of 0 would likely represent a particularly friendly user, while a value of 1 would be... uh, Ted Dziuba?


Redis Connection Options

Troll uses your environment by looking at process.env for connection settings. If none are found, default Redis connection settings are used:

TROLL_HOST: null
TROLL_PORT: null
TROLL_PASS: null

Testing

npm test

Credits

Something went wrong with that request. Please try again.