Skip to main content

Board games recommender engine

Project description

🎲 Board Game Recommender 👍

Board game recommendation engine. View the recommendations live at Recommend.Games! Install via

pip install board-game-recommender

Training new recommender models


Requires Python 3. Make sure Pipenv is installed and create the virtual environment:

python3 -m pip install --upgrade pipenv
pipenv install --dev
pipenv shell


In order to train the models you will need appropriate game and rating data. You can either scrape your own using the board-game-scraper project or take a look at the BoardGameGeek guild to obtain existing datasets.

At the moment there are recommender implementations for two sources: BoardGameGeek and Board Game Atlas.


We use the recommender implementation by Turi Create. Two recommender models are supported out of the box:

  • RankingFactorizationRecommender (default): Learns latent factors for each user and game, generally yielding very interesting recommendations.
  • ItemSimilarityRecommender: Ranks a game according to its similarity to other ratings by a user, often resulting in less interesting recommendations. However, this model is also able to find games similar to a given game.

Run the training

Run the training via the main script:

python -m board_game_recommender --help

E.g., train the default BGG mode like so:

python -m board_game_recommender \
    --train \
    --games-file bgg_GameItem.jl \
    --ratings-file bgg_RatingItem.jl \
    --model model/output/dir


Project details

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

board-game-recommender-2.3.0.tar.gz (17.0 kB view hashes)

Uploaded source

Built Distribution

Supported by

AWS AWS Cloud computing Datadog Datadog Monitoring Facebook / Instagram Facebook / Instagram PSF Sponsor Fastly Fastly CDN Google Google Object Storage and Download Analytics Huawei Huawei PSF Sponsor Microsoft Microsoft PSF Sponsor NVIDIA NVIDIA PSF Sponsor Pingdom Pingdom Monitoring Salesforce Salesforce PSF Sponsor Sentry Sentry Error logging StatusPage StatusPage Status page