AlphaOsu!

Using advanced machine learning technology to help you farm PP in osu! .

Link: https://alphaosu.keytoix.vip/

PR is welcome!

Setup environment

• First, install the python requirements.

pip install -r requirements.txt

• Second, clone the project osu-tools and setup the environment of osu-tools. You may need to install .NET 6.0 SDK.

• Finally, write a data/secret.json file. The content is like:

{
  "oauth_url": "<oauth_url>",
  "client_id": "<client_id>",
  "client_secret": "<client_secret>",
  "redirect_uri": "<redirect_uri>",
  "scope": "public",
  "osu_website": "https://osu.ppy.sh/",
  "osu_tools_command": [
    "dotnet",
    "run",
    "--project",
    "<path to osu_tools>/PerformanceCalculator"
  ]
}

Please setup an osu oauth application to get client_id, client_secret and redirect_uri. You may need a osu! supporter account to fetch DT/HT/Country rankings.

Run the whole pipeline

python pipeline.py

Struct

• fetch data: data_fetcher.py
• train the score model: train_score_als_db.py
• train the pass model: train_pass_kernel.py
• inference: recommender.py

About

Please visit https://alphaosu.keytoix.vip/about for more details about the algorithm.