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
Environment
Requires Python 3. Make sure Pipenv is installed and create the virtual environment:
python3 -m pip install --upgrade pipenv
pipenv install --dev
pipenv shell
Datasets
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.
Models
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
Links
- board-game-recommender: This repository
- Recommend.Games: board game recommender website
- recommend-games-server: Server code for Recommend.Games
- board-game-scraper: Board game data scraper
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Hashes for board-game-recommender-3.2.0.tar.gz
Algorithm | Hash digest | |
---|---|---|
SHA256 | c0b870fdfada8e4679f8383ebf4b9cd8d1aa1fd87f1bc49208a7d591754c980f |
|
MD5 | a89ab8b8dad947417611535966f0d5c4 |
|
BLAKE2b-256 | 840b5680ad37b3d293faa6c8adf8d2d1cda64e471de4d7feaa2926760a3182d4 |
Hashes for board_game_recommender-3.2.0-py2.py3-none-any.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | ec18cab95b34c2b023db224ac0b397da6334c7ab11c57bd4c5e814cd1ae8b189 |
|
MD5 | 398a2b82a2807d8c5d962eca3298aa0e |
|
BLAKE2b-256 | 94c8f8bf86b50c5d3b9fd19e3179f23fadf62e0cecba6a1bc345b8ca20a21c17 |