README_APPS.md

# 🗣️ CASL Analysis Tool - App Options

## 📂 Main Applications (Choose One for Deployment)

### 1. **`simple_casl_app.py`** ⭐ RECOMMENDED
- **Lines**: 186
- **Features**: File upload → LLM analysis → Results display
- **Best for**: Quick deployment, reliable functionality
- **Dependencies**: Minimal (gradio, boto3)
- **Complexity**: ⭐ Simple

### 2. **`moderate_casl_app.py`** 
- **Lines**: 760
- **Features**: Analysis + Audio transcription + PDF export
- **Best for**: Balanced features without complexity
- **Dependencies**: Moderate (+ speech_recognition, reportlab)
- **Complexity**: ⭐⭐ Moderate

### 3. **`full_casl_app.py`**
- **Lines**: 683
- **Features**: Complete interface + visualizations + records
- **Best for**: Full-featured deployment
- **Dependencies**: Full set (+ matplotlib, numpy, pandas)
- **Complexity**: ⭐⭐⭐ Advanced

### 4. **`experimental_casl_app.py`**
- **Lines**: 1443
- **Features**: Enhanced analytics + patient database + advanced visualizations
- **Best for**: Research/experimental features
- **Dependencies**: Extended (+ seaborn, typing)
- **Complexity**: ⭐⭐⭐⭐ Experimental

## 📚 Reference Files

### **`aphasia_analysis_app_code.py`**
- **Purpose**: Reference implementation with working Bedrock API calls
- **Contains**: Correct model format, API structure
- **Use**: Copy Bedrock call patterns from this file

## 🗂️ Reference Files (Archived)
Located in `/reference_files/` folder:
- Original implementations and variations
- Legacy code for reference
- Alternative approaches

## 🚀 Quick Start

### For HuggingFace Spaces:

1. **Choose your app** (recommend `simple_casl_app.py`)
2. **Update README.md**:
   ```yaml
   app_file: simple_casl_app.py
   ```
3. **Deploy** with `requirements.txt`

### Local Testing:
```bash
python simple_casl_app.py      # Simplest
python moderate_casl_app.py    # Balanced  
python full_casl_app.py        # Complete
python experimental_casl_app.py # Advanced
```

## 🎯 Deployment Recommendations

| Use Case | Recommended App | Why |
|----------|----------------|-----|
| **Quick Demo** | `simple_casl_app.py` | Fast, reliable, minimal dependencies |
| **Production** | `moderate_casl_app.py` | Good features, stable |
| **Research** | `full_casl_app.py` | Complete functionality |
| **Development** | `experimental_casl_app.py` | Latest features |

## 📋 Current README.md Configuration
- Currently points to: `app.py` (needs update)
- Should point to your chosen app file