Skip to content

KshavCode/tune-critic-ai

Repository files navigation

🎵 TuneCritic AI

Your AI-Powered Mix Engineer. > Instant, professional audio analysis that bridges the gap between demo and commercially ready tracks.

Python FastAPI React

📋 Overview

TuneCritic AI is an intelligent audio analysis platform designed for producers and mixing engineers. Open-source and used along with Gemini API, the application judges your music track. Unlike standard spectrum analyzers, TuneCritic uses Machine Learning to listen to your track, compare it against a dataset of Billboard Top 100 hits, and provide actionable, timestamped feedback.

It answers the ultimate question: "Is this track ready for Spotify, or does it need more work?"

✨ Key Features

1. 🎛 The Commercial Readiness Score

A "Credit Score" for your mix (0-100).

  • 0-40: Demo quality (Needs mixing).
  • 41-70: Good mix (Needs mastering polish).
  • 71-90: Commercial ready.
  • 91-100: Top-tier professional standard.

2. 📍 Timestamped Improvement Tips

We don't just say "Your mix is muddy." We tell you where.

  • 0:42 - Phase Cancellation detected.
  • 1:15 - Muddy frequency buildup (250Hz).
  • 2:30 - Sibilance spike (6kHz-8kHz).
  • 3:10 - Dynamic flatline (Drop lacks impact).

3. 🧬 Sonic DNA & Visuals

  • Spider Chart: Compare your Bass, Treble, Width, and Dynamics against the genre average.
  • MIR Extraction: Auto-detect BPM, Key, Danceability, and Energy.
  • Interactive Waveform: Click specific error flags to loop the problematic audio section.

Prerequisites

  1. Install dependencies: npm install
  2. Set the GEMINI_API_KEY in .env.local to your Gemini API key
  3. Run the app: npm run dev

About

An intelligent audio analysis platform designed for producers and mixing engineers.. Unlike standard spectrum analyzers, TuneCritic uses Machine Learning to listen to your track, compare it against a dataset of Billboard Top 100 hits, and provide actionable, timestamped feedback.

Topics

Resources

Stars

Watchers

Forks

Contributors