Hummer

1. Clone the repository
2. Change directory (cd) into the cloned repository flask backend cd h2s/flask-api

Setting up the api

# Navigate to our backend
cd ./flask-api

# Create a virtual environment
python3.10 -m venv venv
source venv/bin/activate

# Install dependencies
pip install -r requirements.txt

Start up the App

1. cd ./flask-api type flask run in the command line. This will start our server locally.
2. Open up a new command line and in /h2s and run npm install.
3. Open .env(frontend) and add the backend URL of the flask application.
4. Type npm start to start up the local development server.

From here, you'll be able to run the project locally, so feel free to contribute or use it as a foundation for various projects.

Resources

Here was the material that aided in building this app.

Query by Humming and Audio Embeddings

• MeloDetective with Vector Search and DTW
• Audio Embeddings: Understanding the basics
• Patel, Parth, "Music Retrieval System Using Query-by-Humming" (2019). Master's Projects. 895.
• Name That Tune: A Pilot Study in Finding a Melody From a Sung Query
• What is an Audio Embedding Model?
• Kaggle top 10000 spotify songs dataset

In-app recording

• Record Your MIC with JavaScript
• An introduction to the MediaRecorder API

Contributions

We accept pull requests and issues on this project. If you've got ideas, please open an issue first and discuss it with us and ideally it becomes a pull request that we open together. All contributions are welcome!