HeartJam is an interactive web app that turns your heart rate and hand gestures into a live music performance as form of self-expression.

• Your Fitbit (or heart-rate source) controls the tempo (BPM).
• Your hand gestures in front of the webcam:
  • Cue / mute instruments (keyboard, guitar, bass, percussion)
  • Control global volume with a single-finger “pointer” gesture
  • Shuffle music themes with the 🤟 sign (jazz, chill, house, rock)

• Node.js (LTS) + npm or yarn
• Python 3.9+
• A webcam
• A heart-rate source that works with FitbitConnector (or a mock)

1. Clone the repository

git clone [your-repo-url]
cd codejam25

2. Create + activate virtual environment

python -m venv .venv
source .venv/bin/activate # Windows: .venv/Scripts/activate

3. Install dependencies

python -m pip install -r requirements.txt

1. Backend setup

python app.py

2. Frontend setup

npm install
npm start