AI Discovery

Natural-language playlist generation and library exploration powered by Claude.

What it does

Vynl uses your Anthropic API key (BYO) to:

• Generate playlists from prompts — "warm summer evening on the patio", "1980s synthwave for coding", "60-minute set for a dinner party"
• Refine genres — Library Doctor's Genre Normalize pass finds vague genres ("Vocal", "Pop") and proposes canonical replacements
• Suggest discoveries — "Songs from my library I haven't played in 6 months that I'd probably love right now"

Quick start

1. Settings → API Keys → enter your Anthropic API Key → Save
2. Sidebar → Discover → describe what you want → Generate

The LLM gets the relevant slice of your library (genre, BPM, era hints from your prompt) and returns a tracklist. You can save it as a playlist, shuffle through it, or refine the prompt and regenerate.

Cost ballpark

Each playlist generation uses ~5-15K input tokens (your library context) + ~1-3K output tokens. With Claude Sonnet at current pricing, that's roughly $0.02-$0.05 per playlist. Heavy users: budget $1-$3/month.

Privacy

• Vynl sends only the track metadata (title/artist/album/genre/year) needed for the prompt, not audio
• Your full library is never sent in one shot — Vynl pre-filters to relevant candidates first
• Anthropic's API does not train on customer prompts by default

Model selection

Settings → LLM → choose:

• claude-opus-4-7 — best quality, highest cost
• claude-sonnet-4-7 — recommended default
• claude-haiku-4-5-20251001 — fastest, cheapest, slightly worse at musical taste

You can also point at an OpenAI-compatible local endpoint (Ollama, LM Studio) if you want zero-cloud — quality varies wildly by local model.

Troubleshooting

Related

• Configuration — API key setup
• Playlists & Stats — what to do with the generated playlists