Skip to content

codewithkash33/CrescendoAI

Β 
Β 

Folders and files

NameName
Last commit message
Last commit date

Latest commit

Β 

History

65 Commits
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 

Repository files navigation

🎡 Crescendo AI β€” AI-Powered Music Performance Analyzer

Built at the UC Berkeley AI Hackathon 2025 | June 21–22, 2025

πŸ”— Live App: crescendoai.vercel.app
πŸ“„ Devpost: devpost.com/software/crescendo-yt3wc1
πŸ“‚ Original Repo: github.com/Victoria-DR/uc-berkeley-ai-hackathon-2025


🎯 What is Crescendo AI?

Crescendo AI is an intelligent music performance analysis tool that helps musicians improve by providing real-time, AI-driven feedback on their playing. Whether you're practicing piano, guitar, or any other instrument β€” Crescendo AI listens, analyzes, and tells you exactly where you went right and where you can improve.

How It Works

  1. 🎀 Live Listening β€” Play your instrument live and Crescendo AI captures your performance in real-time
  2. πŸ“ Upload a Recording β€” Already have a recording? Upload it directly for analysis
  3. πŸ€– AI Analysis β€” Google Gemini processes your performance and evaluates technique, timing, note accuracy, and more
  4. πŸ“Š Detailed Feedback β€” Get a breakdown of what you played well and specific areas where mistakes were made, with suggestions for improvement

πŸ› οΈ Tech Stack

Layer Technology
Frontend Next.js, React, JavaScript, CSS
AI/ML Google Gemini API
Audio Processing Web Audio API
Deployment Vercel

πŸ‘₯ Team

Built in 24 hours by a team of 4 at UC Berkeley:

Name Role
Aakash AI/ML Integration & Full-Stack Development
Victoria Frontend Development
Janet Meng Development
Sujal Development

πŸ’‘ My Contributions

As the AI/ML integration lead and a full-stack contributor, I was responsible for:

  • Gemini API Integration β€” Architected and implemented the connection between the audio input pipeline and Google Gemini for intelligent music analysis
  • Audio Processing Pipeline β€” Worked on capturing and processing live audio and uploaded recordings for AI consumption
  • Performance Feedback Engine β€” Developed the logic that translates Gemini's analysis into actionable, musician-friendly feedback
  • Full-Stack Development β€” Contributed across the entire stack, from UI components to backend API routes

πŸš€ Getting Started

Prerequisites

  • Node.js 18+
  • A Google Gemini API key

Installation

# Clone this repository
git clone https://github.com/YOUR_USERNAME/crescendo-ai.git
cd crescendo-ai

# Install dependencies
npm install

# Set up environment variables
cp .env.example .env.local
# Add your GEMINI_API_KEY in .env.local

# Run the development server
npm run dev

Open http://localhost:3000 to see the app.


πŸ† Hackathon Context

  • Event: UC Berkeley AI Hackathon 2025 (3rd Edition)
  • Organized by: Cal Hacks
  • Sponsors: Anthropic, Google, Fetch AI, and more
  • Duration: 24 hours (June 21–22, 2025)
  • Location: Martin Luther King Jr. Building, UC Berkeley

πŸ“„ License

This project was built during a hackathon and is open for educational and portfolio purposes.


Made with β˜• and 🎡 at UC Berkeley AI Hackathon 2025

About

🎡 AI-powered music performance analyzer β€” get real-time feedback on your playing | Built at UC Berkeley AI Hackathon 2025

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors

Languages

  • JavaScript 97.9%
  • CSS 2.1%