0.0
The project is in a healthy, maintained state
This gem provides recommendations by calculating similarity scores using the Jaccard Index, Dice-Sørensen Coefficient, and collaborative filtering.
2005
2006
2007
2008
2009
2010
2011
2012
2013
2014
2015
2016
2017
2018
2019
2020
2021
2022
2023
2024
 Dependencies

Development

~> 1.1
~> 3.9.0
~> 0.3

Runtime

 Project Readme

Recommender Gem

The Recommender gem is a versatile recommendation engine built for Ruby on Rails applications. It leverages collaborative filtering techniques to generate personalized recommendations based on user interactions and similarities. This gem supports various association types, including has_and_belongs_to_many, has_many :through, and has_many, making it flexible and easy to integrate into different relational database models.

Features

  • Advanced Similarity Measures: Utilizes the Jaccard Index, Dice-Sørensen Coefficient, and custom collaborative weighting to provide highly accurate recommendations. These measures calculate the similarity between users based on their shared preferences.
  • Multiple Association Support: Compatible with has_and_belongs_to_many, has_many :through, and has_many associations, allowing seamless integration with different data models.
  • Customizable Recommendations: Easily extendable and configurable to fit the specific needs of your application.
  • Lightweight and Efficient: Designed to be efficient and minimalistic, ensuring fast recommendation calculations without heavy overhead.
  • Feature: Similarity based on multiple associations combined with weights.
  • Feature: User-item recommendations based on all their items.

Coming soon:

  • Feature: Recommendations based on a weighted mix of various associations.

Installation

Add this line to your application's Gemfile:

gem 'recommender'

And then execute:

bundle install

Usage

Include the Recommender::Recommendation module in your model and set the association:

  class User < ApplicationRecord
    include Recommender::Recommendation

    has_many :movie_likes, dependent: :destroy
    has_many :movies, through: :movie_likes

    validates :name, presence: true,  uniqueness: { case_sensitive: false }

    set_association :movies
  end

Now you can get recommendations for an instance:

  user = User.find(1)
  recommendations = user.recommendations(results: 5)
  recommendations.each do |recommended_movie, score|
    puts "#{recommended_movie.name} - Score: #{score}"
  end

How It Works

The gem computes recommendations by comparing the preferences of different users. It uses the following measures to calculate similarity:

  • Jaccard Index: Measures the similarity between two sets by dividing the size of the intersection by the size of the union of the sets.
  • Dice-Sørensen Coefficient: Calculates similarity as twice the size of the intersection divided by the sum of the sizes of the two sets.
  • Collaborative Weighting: Further refines recommendations by considering the commonality and diversity of preferences.

These measures are combined to generate a final similarity score, which is then used to recommend items that the user has not yet interacted with but are popular among similar users.

Contributing

Bug reports and pull requests are welcome on GitHub at https://github.com/Mutuba/recommender. This project is intended to be a safe, welcoming space for collaboration, and contributors are expected to adhere to the Contributor Covenant code of conduct.

License

The gem is available as open source under the terms of the MIT License.