https://github.com/pinsaraperera/songlistingbaseonemotion_langchain-framework
Application powered by GPT-model to list out songs base on their emotions considering lyrical analysis. Created using Lang chain framework for scalable agentic workflow.
https://github.com/pinsaraperera/songlistingbaseonemotion_langchain-framework
ai-powered langchain music openai-api sentiment-analysis streamlit
Last synced: 2 months ago
JSON representation
Application powered by GPT-model to list out songs base on their emotions considering lyrical analysis. Created using Lang chain framework for scalable agentic workflow.
- Host: GitHub
- URL: https://github.com/pinsaraperera/songlistingbaseonemotion_langchain-framework
- Owner: PinsaraPerera
- License: mit
- Created: 2023-09-23T19:08:27.000Z (about 2 years ago)
- Default Branch: main
- Last Pushed: 2023-09-24T12:13:58.000Z (about 2 years ago)
- Last Synced: 2025-04-16T04:09:05.322Z (6 months ago)
- Topics: ai-powered, langchain, music, openai-api, sentiment-analysis, streamlit
- Language: Python
- Homepage:
- Size: 7.09 MB
- Stars: 1
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# Song Listing Application based on Emotion
## Introduction
This is a Song Listing Application that uses the LangChain OpenAI API and Streamlit to curate a list of songs based on user-specified emotions. It provides an easy way to discover and listen to songs that match different emotional states.
## Prerequisites
Before you can run this application, make sure you have the following prerequisites installed on your system:
- Python (version 3.7 or higher)
- pip (Python package manager)
- Git (optional, for cloning the repository)
## Installation
1. Clone the GitHub repository:
```bash
git clone https://github.com/PinsaraPerera/SongListingBaseOnEmotion_LangChain-Framework.git
```
2. Install the required Python packages using pip:
```bash
pip install -r requirements.txt
```
## Configuration
You need to obtain an API key for the LangChain OpenAI API :
```
OPENAI_API_KEY=your_api_key_here
```
Replace `your_api_key_here` with your actual API key.
## Running the Application
To run the application, use the following command:
```bash
streamlit run app.py
```
This will start the application locally. Open a web browser and navigate to the URL provided by Streamlit (usually http://localhost:8501) to access the application.
## Usage
1. Launch the application as described in the previous section.
2. Select an emotion from the dropdown menu.
3. Click on any listed emotion to generate a list of songs that match the selected emotion.
4. Enjoy listening to the recommended songs!
## Contributing
If you'd like to contribute to this project, please fork the repository and create a pull request with your changes. We welcome improvements and bug fixes.
## License
This project is licensed under the [MIT License](LICENSE).
## Contact
If you have any questions or need further assistance, feel free to contact the project maintainer:
- Pawan Perera
- Email: 1pawanpinsara@gmail.com
## Acknowledgments
- This application uses the LangChain OpenAI API to analyze emotions in song lyrics.
- Streamlit was used to create the user interface for this application.