# Project export: Facial Expressions Song Recommender

This document was generated by HackStack to give an AI agent context about a hackathon project. Sections are labeled with their provenance; content marked as truncated was cut to keep this document small.

## Project metadata

- Hackathon: Cal Hacks 11.0
- Tagline: Do you ever struggle finding a song that perfectly fits the vibe? This application uses facial data to determine a users mood and then recommends songs based on that mood.
- Devpost: https://devpost.com/software/facial-expressions-song-recommender
- GitHub: not linked
- Team: contributor stats unavailable

## Devpost submission (written by the team)

### What it does

Our application provides users a curated list of songs based on how they seem to be feeling from facial data. It hopes to give the user the best songs to fit the perfect vibe.

### How we built it

We used Hume's API to decipher mood based on facial data. From there we fed that mood into Chroma's API which would then find the top 10 songs with the highest similarity score to that mood. The songs were generated from Spotify's API. From there, we would display the songs as well as their embedded youtube videos using Flask.

### Accomplishments we're proud of

I'm proud that we were able to create a baseline proof of concept. The application currently can take a sequence of static face images, determine the primary emotion in them, and generate a list of songs based on that emotion. Future Plans As of right now, the application can't take a user's livestream facial data. This is the number one goal to figure out for future endeavors. Additionally, I would like to have the song recommender take in a bunch of mood inputs from the facial data and formulate a song rec based on a weighted combination of said moods.

## README (from the GitHub repository)

No README available.

## Detected evidence (automated analysis)

No repository was indexed for this project. Claimed technologies below could not be checked against code.
- Python (language) — claimed on Devpost, not found in the code

## Codebase structure

No repository index available.

## Key source files

No repository index available; no source files included.