Skip to content

awmie/SongRec

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

4 Commits
 
 
 
 
 
 
 
 
 
 

Repository files navigation

🎶 Song-Based Recommendation App

A web application that provides song recommendations based on user input, using the Groq API for mood and genre analysis. Enter a song name, and the app will suggest similar songs, detailing each song's mood and genre.

🚀 Features

  • Enter a song name to get recommendations.
  • Shows mood and genre analysis of the input song.
  • Provides a list of similar songs with detailed descriptions.
  • Built using Streamlit for an interactive UI.

🛠 Future Enhancements

  • Integrate Chain of Thought (CoT) prompting for better recommendation accuracy.

🧠 Model

  • Works on the Llama 3.2-90b text preview model for generating recommendations.

💻 Installation

  1. Clone the repository:
    git clone https://github.com/your-username/song-rec-app.git
  2. Install required packages:
    pip install -r requirements.txt
  3. Set up your Groq API key in the environment variables.

🧩 Usage

  1. Run the app:
    streamlit run app.py
  2. Open the app in your browser and enter a song name to get recommendations.

📚 How It Works

  • The app takes a song name as input and uses Groq’s API to analyze the song.
  • It identifies mood and genre and fetches 10 similar song recommendations based on these attributes.

🛠️ Tech Stack

  • Python
  • Streamlit - For the user interface
  • Groq API - For song analysis and recommendation generation

🤝 Contributing

Contributions are welcome! Feel free to submit issues or pull requests.

About

song recommendations using ai agents

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors

Languages