Readme.MD

# 🎙️ AcuSpeak - English Accent, Fluency, and Speaker Analysis Tool

**AcuSpeak** is a simple but powerful web app that:
- Accepts a public video URL (e.g. YouTube, MP4)
- Extracts and processes audio using FFmpeg
- Transcribes speech with Whisper
- Classifies English accents using Hugging Face's `ylacombe/accent-classifier`
- Estimates number of speakers and speaking fluency
- Generates a downloadable text report

This project is intended for evaluating spoken English in hiring and screening use cases.

---

## 🚀 Features

- 🎧 **Audio Extraction & Trimming**  
- 📝 **Whisper-based Transcription**  
- 🌍 **Accent Classification** with real model  
- 👥 **Speaker Count Estimation**  
- 🧠 **Fluency Scoring**  
- 📄 **Downloadable Report**  
- 🖥️ **Gradio UI** (runs locally or on Hugging Face Spaces)

---

## 📦 Requirements

Install dependencies with:

```bash
pip install -r requirements.txt