Getting Started

Classifier Reborn is a fork of cardmagic/classifier under more active development. The Classifier Reborn library is released under the terms of the GNU LGPL-2.1. Currently, it has Bayesian Classifier and Latent Semantic Indexer (LSI) implemented.

Here is a quick example to illustrate the usage.

$ gem install classifier-reborn
$ irb
irb(main):001:0> require 'classifier-reborn'
irb(main):002:0> classifier = 'Ham', 'Spam'
irb(main):003:0> classifier.train "Ham", "Sunday is a holiday. Say no to work on Sunday!"
irb(main):004:0> classifier.train "Spam", "You are the lucky winner! Claim your holiday prize."
irb(main):005:0> classifier.classify "What's the plan for Sunday?"
#=> "Ham"

Here is a line-by-line explanation of what we just did.


To use classifier-reborn in your Ruby application add the following line into your application’s Gemfile.

gem 'classifier-reborn'

Then from your application’s folder run the following command to install the gem and its dependencies.

$ bundle install

Alternatively, run the following command to manually install the gem.

$ gem install classifier-reborn


The only runtime dependency of this gem is Roman Shterenzon’s fast-stemmer gem. This should install automatically with RubyGems. Otherwise manually install it as following.

gem install fast-stemmer

To speed up LSI classification by at least 10x consider installing following libraries.

Note that LSI will work without these libraries, but as soon as they are installed, classifier will make use of them. No configuration changes are needed, we like to keep things ridiculously easy for you.

Further Readings

For more information read the following documentation topics.