MusicSeed Docs

MusicSeed is a personal, local-first music recommendation tool for a Plex library. It generates Plex playlists from seed tracks using local library metadata, popularity enrichment, Plex sonic analysis vectors (read at query time), and play history.

Where to start

• Product overview — product intent and scope.
• Music recommendation domain — domain concepts.
• Recommendation resolvers — seed matching, candidate generation, scoring, and playlist selection.
• Local runtime — local services, config, logs, and verification.
• Troubleshooting — setup and job failure recovery.
• Harness engineering — harness strategy and maintenance loop.
• API Reference — auto-generated Python API docs for the core services, the recommender, and the API handlers.

The visual dependency/workflow explainer lives at musicseed-dependency-architecture.html (raw HTML).