---

# AI-Powered Pronunciation Assessment System (Frontend)

This is the frontend of the **AI-Powered Pronunciation Assessment System**, designed to help users—especially students—enhance their English pronunciation through real-time and asynchronous phoneme-level analysis using advanced cloud-based speech recognition technologies.

## 🌐 Live Project Overview

The system integrates with cloud services like **Azure AI Speech SDK** and **AWS** to deliver accurate and personalized feedback on English pronunciation. The frontend is built with modern web technologies for responsiveness and ease of use.

## 🚀 Features

- 🎤 Real-time speech recording and playback
- 🔤 Phoneme-level pronunciation feedback
- 👨‍🏫 Interactive and user-friendly interface
- 🔒 Secure authentication (via AWS Cognito)
- 📈 Performance tracking and feedback history
- 🌐 Hosted as a static web app (e.g., on Azure or AWS Amplify)

## 🛠️ Tech Stack

- **Framework**: [Vite](https://vitejs.dev/)
- **UI**: [Tailwind CSS](https://tailwindcss.com/)
- **Language**: JavaScript / HTML / CSS
- **Auth**: AWS Cognito (via backend)
- **Speech Analysis**: Azure Speech SDK (via backend integration)
- **Deployment**: Static Web App / GitHub Pages / AWS Amplify

## 📁 Project Structure

```bash
├── public/                   # Static assets
├── src/                      # Source files (frontend components)
├── index.html                # Entry HTML
├── tailwind.config.js        # Tailwind CSS configuration
├── postcss.config.js         # PostCSS configuration
├── vite.config.js            # Vite configuration
├── staticwebapp.config.json  # Azure Static Web App routing config
├── package.json              # Project metadata and scripts

🐳 Docker Support

A basic Dockerfile is included for containerization and deployment.

# Build the Docker image
docker build -t pronunciation-frontend .

# Run the container
docker run -p 3000:3000 pronunciation-frontend

📦 Installation & Setup

1. Clone the repo:

git clone https://github.com/VishnuByrraju/cscproject.git
cd cscproject

2. Install dependencies:

npm install

3. Run the app locally:

npm run dev

📌 Requirements

• Node.js 16+
• npm or yarn
• Backend APIs (provided separately)
• Azure Speech API Key & Endpoint (via backend)

👥 Contributing

Feel free to fork the repo, raise issues, or submit pull requests. Contributions are welcome!

📄 License

This project is licensed under the MIT License.

---

Developed by Vishnu Byrraju
For academic and educational purposes.

Let me know if you want to include screenshots, deployment instructions, or a "How it works" section with visuals!