README_HF.md

# AI Interview Coach - Hugging Face Spaces Deployment

This is an AI-powered interview coaching application that helps users practice for Product Manager interviews.

## Features
- Interactive voice-based interview simulation
- Document upload for personalized questions
- Real-time feedback and evaluation
- PDF report generation

## Setup for Hugging Face Spaces

### Required Environment Variables
Add these secrets in your Hugging Face Space settings:

```
GROQ_API_KEY=your_groq_api_key_here
```

### Known Limitations in HF Spaces
- TTS (Text-to-Speech) audio generation may be disabled due to system dependencies
- Some audio features might not work in the containerized environment

## Local Development
To run locally, ensure you have:
1. A valid GROQ API key set as environment variable
2. All required system dependencies installed
3. The voice model files in the `voice_model/` directory