javascript port of vader sentiment tool

Downloads in past


3601.1.35 years ago5 years agoMinified + gzip package size for vader-sentiment in KB


Javascript port of the VADER sentiment analysis tool. Sentiment from text can be determined in-browser or in a Node.js app.
Hutto, C.J. & Gilbert, E.E. (2014). VADER: A Parsimonious Rule-based Model for Sentiment Analysis of Social Media Text. Eighth International Conference on Weblogs and Social Media (ICWSM-14). Ann Arbor, MI, June 2014.


This JavaScript port of VADER is licensed under the terms of the Apache-2.0 License


install via npm
npm install --save vader-sentiment

Example use:
const vader = require('vader-sentiment');
const input = 'VADER is very smart, handsome, and funny';
const intensity = vader.SentimentIntensityAnalyzer.polarity_scores(input);
// {neg: 0.0, neu: 0.299, pos: 0.701, compound: 0.8545}

About the Scoring

  • The `compound` score is computed by summing the valence scores of each word in the lexicon, adjusted according to the rules, and then normalized to be between -1 (most extreme negative) and +1 (most extreme positive). This is the most useful metric if you want a single unidimensional measure of sentiment for a given sentence. Calling it a 'normalized, weighted composite score' is accurate.

It is also useful for researchers who would like to set standardized thresholds for classifying sentences as either positive, neutral, or negative.
Typical threshold values (used in the literature cited on this page) are:
#. positive sentiment: `compound` score >= 0.05 #. neutral sentiment: (`compound score > -0.05) and (compound` score < 0.05) #. negative sentiment: `compound` score <= -0.05
  • The `pos, neu, and neg` scores are ratios for proportions of text that fall in each category (so these should all add up to be 1... or close to it with float operation). These are the most useful metrics if you want multidimensional measures of sentiment for a given sentence.


Install dependencies by running
npm install

To make code consistent
npm run prettier

For tests
npm run tests