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 (imported from Plex into the local store), 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.
• HTTP API — server modes, request encoding, jobs, and playlist writes.
• CLI reference — commands and options generated from the Typer app.
• MCP reference — agent tools, transports, and preview/approval workflows.
• Building the docs — update source pages and regenerate site/.

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