---
title: Audio Emotion Detection API
emoji: 🎵
colorFrom: blue
colorTo: purple
sdk: docker
sdk_version: "latest"
app_file: app.py
pinned: false
---

# Audio Emotion Detection API

This application provides an API for detecting emotions in audio files using the wav2vec2 model fine-tuned for emotion recognition.

## Features

- Upload audio files for emotion analysis
- List all uploaded recordings
- Download previously uploaded recordings
- Analyze existing recordings
- Delete recordings

## API Endpoints

- `GET /health` - Health check endpoint
- `POST /upload` - Upload and analyze an audio file
- `GET /recordings` - List all uploaded recordings
- `GET /recordings/{filename}` - Download a specific recording
- `GET /analyze/{filename}` - Analyze an existing recording
- `DELETE /recordings/{filename}` - Delete a recording

## Supported Audio Formats

- WAV
- MP3
- OGG
- FLAC

## File Size Limits

Maximum file size: 10MB

## Usage Example

```python
import requests

# Upload and analyze an audio file
with open('your_audio.wav', 'rb') as f:
    files = {'file': f}
    response = requests.post('https://your-space-url.hf.space/upload', files=files)
    print(response.json())
```

## Technical Details

- Based on FastAPI
- Uses Hugging Face's wav2vec2-base-superb-er model for emotion recognition
- Optimized for Hugging Face Spaces deployment
- Automatic file cleanup to manage storage limits

## Storage Management

Files are automatically cleaned up after 24 hours to manage storage limits on Hugging Face Spaces.

## Development

To run this API locally:

1. Install dependencies: `pip install -r requirements.txt`
2. Run the server: `python app.py`
3. Access the Swagger documentation at `http://localhost:7860/docs`