How jaredfigdor/music-analyzer works
Project Type and Purpose
• From the file tree and README, this is a full-stack web application called “Music Analyzer.”
• Purpose: Users upload audio files via a React/Next.js frontend; a Python/FastAPI backend performs audio analysis (BPM, key, energy, danceability, happiness, genre) and returns results to the UI.
File Structure
• Top-Level Directories:
• app/ – Next.js 13+ “app” router with pages, layout, global CSS
• backend/ – Python FastAPI server containing main.py (API routes) and music_analyzer.py (analysis logic)
• components/ and hooks/ – React UI elements (shadcn/ui) and custom hooks
• lib/ – shared utilities for the frontend
• public/, styles/ – static assets and Tailwind CSS config
• Configuration files: next.config.mjs, tailwind.config.ts, tsconfig.json, Python requirements.txt, uvicorn commands in README.
README for Additional Insights
• Confirms tech stack: Next.js/TypeScript/Tailwind/shadcn/ui on the frontend; FastAPI/Python + librosa + Hugging Face Transformers on the backend.
• Describes the flow: frontend POSTs file → backend processes locally (librosa) and via external API + Hugging Face → JSON response → UI display.