Skip to content

Latest commit

ย 

History

4 Commits

Folders and files

NameName
Last commit message
Last commit date
ย 
ย 
ย 
ย 
ย 
ย 

Repository files navigation

๐ŸŽง BeatBuddy - AI-Powered Music Recommendation System

BeatBuddy is a content-based song recommendation system that suggests similar tracks based on both genre and numerical audio features. Whether you're vibing to a mellow tune or a high-energy banger, BeatBuddy finds you the next perfect track โ€” intelligently.


๐Ÿš€ Features

  • ๐ŸŽถ Smart Song Matching: Enter a song name to receive intelligent music recommendations.
  • ๐Ÿ“Š Text + Numeric Similarity: Combines genre (text) and audio features (numbers) using cosine similarity.
  • โ“ Graceful Handling of Unknown Songs: If a song isnโ€™t found, the app suggests random tracks to keep the music flowing.
  • ๐Ÿ”— Spotify API Integration: Get direct Spotify links for recommended tracks.

๐Ÿง  How It Works

  1. Vectorization: The genre of each song is transformed using TfidfVectorizer.
  2. Feature Extraction: Numeric features such as tempo, danceability, and energy are extracted using pandas.
  3. Similarity Calculation: Cosine similarity is applied to both text and numerical vectors.
  4. Recommendation Output: The top matches are returned with song titles and Spotify track URLs.

๐Ÿ› ๏ธ Tech Stack

  • Python 3
  • NumPy
  • Pandas
  • Scikit-learn
  • Spotify API (for metadata and track hrefs)

๐Ÿ“ธ Screenshots

Input Song Output Recommendation
"Me Love" 5 song recommendations with Spotify links
"Shape of You" Song not found fallback with 5 random suggestions

About

BeatBuddy is a content-based music recommendation system that suggests similar tracks based on genre and numerical audio features. Powered by cosine similarity and vectorization, it helps users discover new songs that match their current favorite tracks.

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages