CatchMeow

README excerpt

# Catch Meow Voice Analysis - Quick Start Guide

## 🎯 What This System Does

This system analyzes voice recordings to detect potential bluffs using advanced audio feature extraction and baseline comparison algorithms. It integrates with the Catch Meow game interface to provide real-time voice analysis results.

## 📁 File Overview

### Core Audio Analysis Files
- **`audio_extractor.py`** - Extracts comprehensive speech features from audio files using librosa
- **`bluff_calculator.py`** - Implements advanced baseline comparison algorithm for bluff detection  
- **`audio_pipeline.py`** - Combines extraction and calculation into unified analysis pipeline
- **`web_server.py`** - Flask backend server for file uploads and analysis

### Frontend Integration Files
- **`script.js`** - Enhanced JavaScript with audio analysis integration and file upload UI
- **`styles.css`** - Additional styling for modal dialogs, progress indicators, and upload buttons
- **`index.html`** - Main GUI interface (assumed to exist in your project)

### Utilities
- **`demo_launcher.py`** - Simple launcher to open GUI demo without backend dependencies
- **`README.md`** - This guide

## 🚀 How to Run

### Option 1: Demo Mode (No Dependencies Required)
```bash
python demo_launcher.py
```
- Opens the GUI in your browser
- Uses simulated analysis results
- Perfect for testing the interface

### Option 2: Full Analysis Mode (Requires Dependencies)
1. Install Python dependencies: