Skip to content

victoria-lo/Gameo

Repository files navigation

There's a Game for Everyone

Games are a form of entertainment and pleasure to many of us.

According to a market study, the global video game industry is valued at USD 151.06 billion in 2019 and is expected to grow at a Compound Annual Growth Rate (CAGR) of 12.9% from 2020 to 2027. This means that there will be more selection of games for us. For gamers and for people who are not familiar with video games, it can be daunting to find and choose a game that they will enjoy.

Gameo aims to become the number 1 game recommendation engine for anyone to use. At Gameo, we believe that there is a game for anyone. Whether or not you have played video games before, Gameo will have a game for you.

Start using Gameo at https://gameo-app.herokuapp.com

Devpost Link: https://devpost.com/software/gameo

Main Features

  • See trending games based on how popular it is on Twitch
  • View a personalized recommendation list of games based on games rated
  • Add games to your library and wish list
  • Games that are rated will have a rating of 1-10, which will be used to train the model
  • Modify the number of recommendations given in the settings page

Resources

Gameo uses the following resources:

  • Twitch API, which allows Gameo to fetch the newest and trending games. Official documentation can be found here.

  • RAWG API, which allows Gameo to access detailed information for each game. Official documentation can be found here.

  • Metacritic Game Dataset and Metacritic User Comments Dataset, which are used for training the model can be found here.

Tech Stack

  • Languages: Python, JavaScript, HTML, CSS
  • Frameworks: ReactJS, Python Flask
  • Database: MongoDB
  • APIs/Other: Twitch API, RAWG API, Firebase Authentication

Documentation

Visit https://victoria-lo.github.io/Gameo/ for detailed documentation made with Docusaurus.

How to Use Gameo

In order for Gameo to be your no.1 game recommendation engine, here's a brief explanation on the features for any Gameo users to refer to.

IMPORTANT

For best experience, Gameo users are advised to use devices with larger screens such as laptops or desktop PCs or iPad. Currently, the website is not well-suited for mobile devices but we are planning to make it fully compatible with any device in future updates.

Create a Gameo account

First, create a Gameo account at https://gameo-app.herokuapp.com It's free and takes less than 1 minute to create!

Trending

The first page you will see when visiting Gameo is the Trending page. This page fetches data from Twitch API to display the most popular games on Twitch right now. It is a good and general way to discover the latest trending games that people are playing.

This page can display any games from numerous genres and platforms. Gameo aims to be a recommendation engine that caters to any gamer after all; from console to PC games, from RPG to Shooter games, Gameo can recommend it to you!

Library

For a more personalized game recommendation, Gameo users should add games they have played to their Library and rate the game. This will tell Gameo what kinds of games the user prefers and so, it would be able to use Collaborative Filtering to determine which game the user would likely to enjoy next and recommend that game.

To add a game to Library, simply click on a game on the Trending page to open a pop-up window with the game's information. Then click on the 'Add to Library' button.

To rate the game you've played, head to the Library page and click 'Rate Game'. Give a rating from 1 (worst) to 10 (best). Gameo will then better understand your game tastes to recommend games for you using its Matrix Factorization model in PyTorch.

Wishlist

The Wishlist page is where you can add games that you're considering to play. There are many reasons why you may just want to wishlist a game before playing it and adding to your Library, such as:

  • Not yet planning to commit to purchasing the game
  • Still need more research on the game
  • Interested but no time to commit playing the game
  • Buying it later for a family or friend
  • Waiting for the game to be on sale
  • Waiting for game to release to a platform you want
  • Saving it for later to recommend to someone

Regardless of the reason, it is simple to add a game to your Wishlist. Simply click on a game on the Trending page. A pop-up window with the game's information will appear. Click on the 'Add to Library' button and it will be added to your wishlist.

Recommendations

The recommendations page is the highlight feature of Gameo. It displays the personalized games recommended just for you.

About

Game recommendation engine built with React and PyTorch. Facebook Developer Circle Hackathon Local Language Winner.

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published