How demotione/osu-coach works
osu! coach is a local osu!standard replay-analysis and training app, with a web UI and optional desktop shell. The main workflow is to scan or upload replays, select and analyse them, aggregate results into a player profile, then explore statistics, tips, progress, and practice or play-goal recommendations. The graph includes documented capability branches and sampled call relationships; several feature implementations were not sampled, so their internal links are omitted rather than inferred.
Main entry points: records.py Profile records · build.py Profile aggregation · session.py Replay session · routes.py Replay API
Components 21
App entry
- Web app
backend/src/osu_coach/app/server.py - Workspace state
backend/src/osu_coach/app/workspace.py
Replay analysis
- Replay API
backend/src/osu_coach/features/library/routes.py - Replay session
backend/src/osu_coach/features/library/session.py - Replay services
backend/src/osu_coach/features/library/service.py - Replay models
backend/src/osu_coach/domain/analysis/models.py
Player model
- Profile aggregation
backend/src/osu_coach/domain/player/build.py - Play summaries
backend/src/osu_coach/domain/player/summary.py - Profile records
backend/src/osu_coach/domain/player/records.py - Comfort ratings
backend/src/osu_coach/domain/player/engines/comfort/engine.py - Star-scale ratings
backend/src/osu_coach/domain/player/engines/irt/engine.py
Coaching features
- Statistics dashboard
backend/src/osu_coach/features/dashboard/service.py - Tips and setup
backend/src/osu_coach/features/tips/rules/engine.py - Skill playlists
backend/src/osu_coach/features/maps/service.py - Play goals
backend/src/osu_coach/features/play_goals/service.py - Progress tracking
backend/src/osu_coach/features/progress/service.py
User interface
- Web interface
frontend/src/app/App.tsx - API client
frontend/src/api/client.ts
Other components
- Player
- Beatmap downloads
- osu! game
Connections 24
- Player → Web interface: uses
- Web interface → API client: requests
- API client → Web app: calls API
- Web app → Workspace state: provides state
- Player → Replay API: adds replays
backend/src/osu_coach/features/library/routes.py - Replay API → Replay services: delegates to
backend/src/osu_coach/features/library/routes.py - Replay API → Replay session: starts jobs
backend/src/osu_coach/features/library/routes.py - Replay session → Workspace state: updates
- Replay session → Replay models: analyses
- Replay session → Profile aggregation: builds profile
- Profile aggregation → Play summaries: summarizes plays
backend/src/osu_coach/domain/player/__init__.py - Profile aggregation → Profile records: produces
- Comfort ratings → Profile records: rates skills
backend/src/osu_coach/domain/player/engines/comfort/engine.py - Star-scale ratings → Profile records: rates skills
backend/src/osu_coach/domain/player/engines/irt/engine.py - Profile aggregation → Comfort ratings: selects engine
- Profile aggregation → Star-scale ratings: selects engine
- Statistics dashboard → Workspace state: reads profile
backend/src/osu_coach/features/dashboard/service.py - Tips and setup → Profile records: uses profile data
backend/src/osu_coach/features/tips/rules/engine.py - Skill playlists → Profile records: uses skill ratings
- Play goals → Profile records: uses play evidence
- Progress tracking → Workspace state: reads progress
- Skill playlists → Beatmap downloads: downloads maps
- Play goals → osu! game: exports training
- Web interface → Replay API: scans and analyses