ActsAsRecommendable =================== ActsAsRecommendable is a plugin for Rails that simplifies collaborative filtering The plugin provides a mechanism for finding loose associations between users and items which we can tell you * Given a user, return other similar users based on what items they have all bought/bookmarked/rated/etc * Given a user, return recommended items based on the items bought/bookmarked/rated/etc by that user and the items bought/bookmarked/rated/etc by other users. The plugin calculations can be made online and offline and stored using the rails cache (such as memcache) for online retrieval. Online retrieval of recommendations uses item-based collaborative filtering using the offline items similarity matrix stored in the cache. This can give up-to-date results with a much lower processing overhead. Much thanks to Toby Segaran and his excellent book Programming Collective Intelligence (http://oreilly.com/catalog/9780596529321/). Features ======== Use join rating scores Using abitary calculated scores Similar Items Recommended Users Cached dataset Current Release =============== v0.1 should be considered early alpha and not ready for production applications. Lots of performance optimisations still to be done. Example ======= class Book < ActiveRecord::Base has_many :user_books has_many :users, :through => :user_books end class UserBook < ActiveRecord::Base belongs_to :book belongs_to :user end class User < ActiveRecord::Base has_many :user_books has_many :books, :through => :user_books acts_as_recommendable :books, :through => :user_books end user = User.find(:first) user.similar_users #=> [...] user.recommended_books #=> [...] book = Book.find(:first) book.similar_books #=> [...] Example 2 ========= class Movie < ActiveRecord::Base has_many :user_movies has_many :users, :through => :user_movies end class UserMovie < ActiveRecord::Base belongs_to :movie belongs_to :user end class User < ActiveRecord::Base has_many :user_movies has_many :movies, :through => :user_movies acts_as_recommendable :movies, :through => :user_movies, :score => :score # 'score' is an attribute on the users_movies table end user = User.find(:first) user.similar_users #=> [...] user.recommended_movies #=> [...] Example 3 ========= class Book < ActiveRecord::Base has_many :user_books has_many :users, :through => :user_books, :use_dataset => true # Uses cached dataset end class UserBook < ActiveRecord::Base belongs_to :book belongs_to :user end class User < ActiveRecord::Base has_many :user_books has_many :books, :through => :user_books acts_as_recommendable :books, :through => :user_books end user = User.find(:first) user.recommended_books #=> [...] # The example above uses a cached dataset. # You need to generate a cached dataset every so often (depending on how much your content changes) # You can do that by calling the rake task recommendations:build, you should run this with a cron job every so often. # If you only want to use the dataset in production put this in production.rb: User.aar_options[:use_dataset] = true # Note: # user.similar_users doesn't use the dataset # # The advantage of using a dataset is that you don't need to load all the users & items into # memory (which you do normally). The disadvantage is that you won't get as accurate results. # Contact ======= alex@madebymany.co.uk Copyright (c) 2008 Made by Many Ltd, released under the MIT license