Embeat is an open-source music recommendation system that uses contrastive learning on Spotify acoustic features and multi-channel recall to deliver millisecond-level, genre-aware recommendations across 45 million tracks.

Stars

209

7-day growth

No data

Forks

28

Open issues

0

License

NOASSERTION

Last updated

2026-07-03

AI repository intelligence
FR-AI / ANALYSIS

Why it is worth attention

It combines a learned acoustic similarity model with genre filtering and playlist collaborative filtering, achieving strong blind-evaluation results against a major commercial service (Netease Cloud Music) while maintaining 30–100ms retrieval latency.

Who it is for

  • Music recommendation system engineers
  • Researchers in music information retrieval and contrastive learning
  • Developers building personalized music discovery applications
  • Spotify API developers seeking offline or self-hosted recommendation pipelines

Use cases

  • Generating top-K similar tracks for a seed song based on acoustic features and genre
  • Powering playlist continuation or music discovery features in streaming services
  • Building artist similarity and same-artist exploration tools
  • Evaluating recommendation quality using LLM-as-a-Judge methodology

Strengths

  • Five parallel recall channels (acoustic, genre-popular, same-artist, similar-artist, playlist CF) produce diverse and relevant results
  • Millisecond-level inference (30–100ms across 45M tracks via Qdrant) and real-time CPU-only inference for the model
  • Genre-awareness from 6,000+ micro-genre tags prevents acoustically similar but stylistically mismatched recommendations
  • Blind evaluation against Netease Cloud Music shows Embeat winning 23 out of 30 comparisons across three LLM judges

Considerations

  • Relies on Spotify’s acoustic feature schema and data; not directly applicable to other music sources without re-training or adaptation
  • The open dataset and database are licensed under CC-BY-NC 4.0, restricting commercial use
  • Requires self-hosting Qdrant and downloading a large database (~45M tracks), increasing initial setup complexity

README quick start

Installation

Description

Content-based music recommendation system, training on Spotify 45M tracks & 1.8M playlists.

Related repositories

Similar projects matched by category, topics, and programming language.

lopopolo
Featured
lopopolo GitHub avatar

harness-engineering

Harness Engineering is a methodology for improving coding agent outputs by carefully crafting the environment around them—providing curated context, tools, and executable constraints that encode an organization’s nonfunctional requirements and cumulative lessons.

AI & Machine LearningAI Agents
2,390
slvDev
Featured
slvDev GitHub avatar

esp32-ai

A 28.9 million parameter language model runs on an $8 ESP32-S3 microcontroller entirely on-device, generating simple stories at about 9.5 tokens per second.

AI & Machine LearningLarge Language Models
1,960
littledivy
Featured
littledivy GitHub avatar

mimic

mimic captures traffic from any iOS or web app and automatically generates a Python client library that lets you call the app's API like a regular library.

AI & Machine Learning
1,482