osu! PP Recommender

A performance profiler for osu! that analyzes replay files (.osr) and beatmaps (.osu) and recommends maps.

Architecture

• Server (server/): FastAPI backend for parsing replays, extracting feature metrics, and managing SQLite/Redis storage.
• Frontend (frontend/): React + Vite app for browsing user profiles, beatmap analytics, and hit distribution charts.

Model training folder is coming soon :D

Quickstart

Development

# Server
pip install -r requirements.txt
uvicorn server.main:app --reload --port 8000

# Frontend
cd frontend
npm install
npm run dev

You can also use Docker Compose instead:

# Build frontend static bundle first
cd frontend && npm install && npm run build

# Start services
docker-compose -f server/dokcer-compose.dev.yml up -d --build

Project Layout

• frontend/ - React frontend application
• server/ - FastAPI application, database logic, and feature extraction