{"id":48377720,"url":"https://github.com/recommend-games/board-game-recommender","last_synced_at":"2026-04-05T18:35:56.430Z","repository":{"id":53817062,"uuid":"154515240","full_name":"recommend-games/board-game-recommender","owner":"recommend-games","description":"Board game recommendation engine","archived":false,"fork":false,"pushed_at":"2024-12-12T20:46:10.000Z","size":2467,"stargazers_count":15,"open_issues_count":1,"forks_count":0,"subscribers_count":1,"default_branch":"master","last_synced_at":"2026-03-20T17:12:58.558Z","etag":null,"topics":["bgg","bgg-rating","board-game","board-game-recommender","board-games","boardgame","boardgamegeek","boardgames","games","ludoj","ludoj-recommender","python","ratings","recommendation-algorithm","recommendation-engine","recommendation-system","recommender","recommender-system","tabletop-games","turicreate"],"latest_commit_sha":null,"homepage":"https://recommend.games/","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/recommend-games.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":"CODE_OF_CONDUCT.md","threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null},"funding":{"github":"MarkusShepherd","patreon":"mshepherd","open_collective":null,"ko_fi":"mshepherd","tidelift":null,"community_bridge":null,"liberapay":"mshepherd","issuehunt":null,"otechie":null,"lfx_crowdfunding":null,"custom":["https://paypal.me/mschepke"]}},"created_at":"2018-10-24T14:25:24.000Z","updated_at":"2025-07-09T03:04:02.000Z","dependencies_parsed_at":"2023-09-22T00:34:28.055Z","dependency_job_id":"041ca032-7b4d-40dc-91dc-6259e81ed6c8","html_url":"https://github.com/recommend-games/board-game-recommender","commit_stats":null,"previous_names":[],"tags_count":24,"template":false,"template_full_name":null,"purl":"pkg:github/recommend-games/board-game-recommender","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/recommend-games%2Fboard-game-recommender","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/recommend-games%2Fboard-game-recommender/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/recommend-games%2Fboard-game-recommender/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/recommend-games%2Fboard-game-recommender/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/recommend-games","download_url":"https://codeload.github.com/recommend-games/board-game-recommender/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/recommend-games%2Fboard-game-recommender/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":31446530,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-04-05T15:22:31.103Z","status":"ssl_error","status_checked_at":"2026-04-05T15:22:00.205Z","response_time":75,"last_error":"SSL_connect returned=1 errno=0 peeraddr=140.82.121.5:443 state=error: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["bgg","bgg-rating","board-game","board-game-recommender","board-games","boardgame","boardgamegeek","boardgames","games","ludoj","ludoj-recommender","python","ratings","recommendation-algorithm","recommendation-engine","recommendation-system","recommender","recommender-system","tabletop-games","turicreate"],"created_at":"2026-04-05T18:35:55.164Z","updated_at":"2026-04-05T18:35:56.420Z","avatar_url":"https://github.com/recommend-games.png","language":"Python","funding_links":["https://github.com/sponsors/MarkusShepherd","https://patreon.com/mshepherd","https://ko-fi.com/mshepherd","https://liberapay.com/mshepherd","https://paypal.me/mschepke"],"categories":[],"sub_categories":[],"readme":"# 🎲 Board Game Recommender 👍\n\nBoard game recommendation engine. View the recommendations live at\n[Recommend.Games](https://recommend.games/)! Install via\n\n```bash\npip install board-game-recommender\n```\n\n## Training new recommender models\n\n### Environment\n\n[Requires Python 3](https://pythonclock.org/). Make sure\n[Pipenv](https://docs.pipenv.org/) is installed and create the virtual environment:\n\n```bash\npython3 -m pip install --upgrade pipenv\npipenv install --dev\npipenv shell\n```\n\n### Datasets\n\nIn order to train the models you will need appropriate game and rating data.\nYou can either scrape your own using the [board-game-scraper](https://gitlab.com/recommend.games/board-game-scraper)\nproject or take a look at the [BoardGameGeek guild](https://boardgamegeek.com/thread/2287371/boardgamegeek-games-and-ratings-datasets)\nto obtain existing datasets.\n\nAt the moment there is only one [recommender implementations](board_game_recommender/recommend.py): [BoardGameGeek](https://boardgamegeek.com/).\n\n### Models\n\nWe use the recommender implementation by [Turi Create](https://github.com/apple/turicreate).\nTwo recommender models are supported out of the box:\n\n* [`RankingFactorizationRecommender`](https://apple.github.io/turicreate/docs/api/generated/turicreate.recommender.ranking_factorization_recommender.RankingFactorizationRecommender.html)\n (default): Learns latent factors for each user and game, generally yielding\n very interesting recommendations.\n* [`ItemSimilarityRecommender`](https://apple.github.io/turicreate/docs/api/generated/turicreate.recommender.item_similarity_recommender.ItemSimilarityRecommender.html):\n Ranks a game according to its similarity to other ratings by a user, often\n resulting in less interesting recommendations. However, this model is also\n able to find games similar to a given game.\n\n### Run the training\n\nRun the training via the [main script](board_game_recommender/__main__.py):\n\n```bash\npython -m board_game_recommender --help\n```\n\nE.g., train the default BGG mode like so:\n\n```bash\npython -m board_game_recommender \\\n    --train \\\n    --games-file bgg_GameItem.jl \\\n    --ratings-file bgg_RatingItem.jl \\\n    --model model/output/dir\n```\n\n## Links\n\n* [board-game-recommender](https://gitlab.com/recommend.games/board-game-recommender):\n This repository\n* [Recommend.Games](https://recommend.games/): board game recommender website\n* [recommend-games-server](https://gitlab.com/recommend.games/recommend-games-server):\n Server code for [Recommend.Games](https://recommend.games/)\n* [board-game-scraper](https://gitlab.com/recommend.games/board-game-scraper):\n Board game data scraper\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Frecommend-games%2Fboard-game-recommender","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Frecommend-games%2Fboard-game-recommender","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Frecommend-games%2Fboard-game-recommender/lists"}