feat(discover): artists I may like, with a score I can explain

- GET /discover suggests artists, in my library or not, with a score from 0 to 1
  and its parts: affinity (similar to the artists I like), genre (tags close to
  mine), preference (what my listening says) and discovery (a bonus for what I
  have not played). Default weights 0.40, 0.25, 0.25, 0.10, set in [scoring].
- A part with no data (no tags) is left out and the others rescaled; the answer
  says which parts were there, and which seeds led to each suggestion.
- Seeds are the artists I name with ?seed=, or, only when I turned on
  discover_from_listening, the artists I play most. Without either the request is
  refused and nothing is sent to anyone.
- The tags of the best candidates are read from Last.fm only, only for those with
  none stored, a few at a time.
- taste.Service.Learn gives the whole picture (every preference, the liked
  artists, the tag profile); TagService.ProviderTags asks one provider.
- Spec, contract test, README and example config updated.

Closes #33
This commit is contained in:
tgiachi 2026-11-11 19:42:09 +01:00
commit 28c249c268

View file

@ -29,4 +29,10 @@ min_listen_seconds = 20 # a play counts as a listen after this long, or when
[taste]
half_life_days = 90 # an old listen weighs half as much after this many days
[scoring] # weights of the parts of a Discover score (only their proportions matter)
weight_affinity = 0.40 # similar to the artists I like
weight_genre = 0.25 # tags close to the tags I like
weight_preference = 0.25 # what my listening says about the artist
weight_discovery = 0.10 # bonus for what I have not played yet
# Last.fm and MusicBrainz are set up through the API, not here: PUT /api/v1/providers/{name}.