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:

   app_file: simple_casl_app.py
   

3. Deploy with requirements.txt

Local Testing:

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