this is new update

HF_DEPLOYMENT_CHECKLIST.md

@@ -0,0 +1,65 @@
+# 🚀 Hugging Face Deployment Checklist
+
+## ✅ Issues Fixed:
+
+1. **Added missing dependencies:**
+   - `python-dotenv` for environment variable loading
+   - Linux TTS support with `espeak`
+
+2. **Fixed import issues:**
+   - Changed `import regex as re` to `import re` (using standard library)
+   - Ensured all modules properly handle missing dependencies
+
+3. **Enhanced TTS support:**
+   - Added Linux `espeak` fallback for TTS
+   - Updated `packages.txt` with required system packages
+
+4. **Fixed directory creation:**
+   - Ensured upload and reports directories are created automatically
+
+## 🔐 Required Setup on Hugging Face:
+
+1. **Add Secret Variable:**
+   - Go to Space Settings → Variables and secrets
+   - Add: `GROQ_API_KEY` = your_groq_api_key
+   - Get key from: https://console.groq.com/keys
+
+## 📦 Files Ready for Deployment:
+
+- ✅ `app.py` - Main application
+- ✅ `requirements.txt` - Python dependencies (fixed)
+- ✅ `packages.txt` - System packages (enhanced)
+- ✅ `README.md` - With proper HF header
+- ✅ `config.py` - Configuration (improved)
+- ✅ `modules/` - All module files
+- ✅ `voice_model/` - TTS model files
+
+## 🚨 Common Runtime Errors & Solutions:
+
+### 1. "No module named 'dotenv'"
+- **Fixed**: Added `python-dotenv` to requirements.txt
+
+### 2. "No module named 'regex'"
+- **Fixed**: Changed to use standard `re` module
+
+### 3. TTS not working on Linux
+- **Fixed**: Added espeak support and system packages
+
+### 4. "GROQ_API_KEY not found"
+- **Solution**: Add as secret in HF Space settings
+
+### 5. Permission denied on file creation
+- **Fixed**: Ensured directories are created in config.py
+
+## 🚀 Deployment Steps:
+
+1. **Upload all files** to your Hugging Face Space
+2. **Add GROQ_API_KEY secret** in Space settings
+3. **Wait for build** to complete (5-10 minutes)
+4. **Test the app** - it should launch without errors
+
+## ⚠️ Known Limitations on HF:
+
+- TTS quality may be lower on Linux (espeak vs macOS say)
+- Large file uploads may be slower
+- Some advanced audio features might have reduced performance

SECRETS_SETUP.md

@@ -0,0 +1,32 @@
+# 🔐 Hugging Face Secrets Configuration
+
+To deploy this app successfully on Hugging Face Spaces, you need to configure the following secret:
+
+## Required Secret:
+
+1. **GROQ_API_KEY**
+   - Go to your Hugging Face Space settings
+   - Navigate to "Variables and secrets" section
+   - Add a new secret:
+     - Name: `GROQ_API_KEY`
+     - Value: Your Groq API key from https://console.groq.com/keys
+
+## How to Set Secrets in Hugging Face Spaces:
+
+1. Go to your Space page on Hugging Face
+2. Click "Settings" tab
+3. Scroll down to "Variables and secrets"
+4. Click "New secret"
+5. Enter the secret name and value
+6. Click "Save"
+7. Your app will automatically restart with the new secret
+
+## Getting a Groq API Key:
+
+1. Visit https://console.groq.com/keys
+2. Create a free account
+3. Generate a new API key
+4. Copy the key and add it to your Hugging Face Space secrets
+
+## Note:
+Without the GROQ_API_KEY, the app will show warnings but should still launch. However, the AI coaching functionality will not work.

config.py

@@ -51,4 +51,9 @@ PIPER_VOICE_MODEL = './voice_model/en_US-lessac-medium.onnx'
 
 # -- Directories --
 UPLOAD_FOLDER = 'uploads'
-REPORT_FOLDER = 'reports'
+REPORT_FOLDER = 'reports'
+
+# Ensure directories exist
+import os
+os.makedirs(UPLOAD_FOLDER, exist_ok=True)
+os.makedirs(REPORT_FOLDER, exist_ok=True)

modules/llm_handler.py

@@ -1,7 +1,7 @@
 # modules/llm_handler.py
 import os
 import config
-import regex as re
+import re
 from groq import Groq
 from modules.web_search import search_for_example_answers
 from modules.pm_frameworks import get_framework_suggestion, get_relevant_metrics

modules/tts_handler.py

@@ -28,6 +28,26 @@ def text_to_speech_file(text_to_speak):
             else:
                 print("❌ macOS 'say' command failed, falling back to silent audio")
                 return create_silent_audio()
+        
+        # Try Linux TTS options
+        elif platform.system() == "Linux":
+            # Check if espeak is available (common on Linux systems)
+            if subprocess.run(['which', 'espeak'], capture_output=True).returncode == 0:
+                with tempfile.NamedTemporaryFile(delete=False, suffix=".wav") as wav_file:
+                    wav_filename = wav_file.name
+                
+                command = ['espeak', '-w', wav_filename, text_to_speak]
+                process = subprocess.run(command, capture_output=True, text=True, timeout=30)
+                
+                if process.returncode == 0 and os.path.exists(wav_filename):
+                    print("✅ TTS generated successfully with espeak")
+                    return wav_filename
+                else:
+                    print("❌ espeak command failed, falling back to silent audio")
+                    return create_silent_audio()
+            else:
+                print("❌ No TTS engine available on Linux, using silent audio")
+                return create_silent_audio()
         else:
             print("❌ TTS not available on this system, using silent audio")
             return create_silent_audio()

packages.txt

@@ -1,2 +1,6 @@
 ffmpeg
-portaudio19-dev
+portaudio19-dev
+espeak
+espeak-data
+libespeak1
+alsa-utils