Song Lyrics Analysis

Description

This application allows you to classify the theme of a song lyrics into: sad, good-vibes, or aggressive.

Dataset

2514 tracks

three different themes:

• Sad = heartbreak, loss, grief
• Good Vibes = positive love, empowerment, feeling good
• Aggressive = drugs, alcohol, struggle, sex, explicit language

Manually created

80:20 Split between test and train data

Local Dev Poetry

To prepare the environment using poetry and python3.10

make env

To run it

streamlit run app.py 

Development

Pushing your changes

You developed an amazing feature or fixed a bug, and you need to push you changes to git. To make sure we have a consistent way of writing the code, scripts for formatting are ready to be used.

Before pushing you changes, we need to have your code formatted, and checked by mypy. That's exactly what this command does:

make prepare

Adding new Dependencies

To avoid running around requirements.txt files and adding dependencies manually, we use Poetry to manage the dependencies.

To add a new library to poetry:

poetry add <name_of_library>

To specify a constraint when adding a package:

# Specific library version
poetry add pendulum@^2.0.5
# Minimum library version
poetry add "pendulum>=2.0.5"
# Always use the latest version (not recommended)
poetry add pendulum@latest 

In order to get the latest versions of the dependencies and to update the poetry.lock file

poetry update

If you just want to update a few packages and not all, you can list them as such:

poetry update requests toml

Cleanup

To keep the virtualenv and clean everything else

make clean

For a deep cleaning

make clean-all