# evaluate.py - Handles evaluation and comparing tasks import os import glob import logging import traceback import tempfile import shutil from difflib import SequenceMatcher import torch import torchaudio from pydub import AudioSegment from flask import jsonify from werkzeug.utils import secure_filename from concurrent.futures import ThreadPoolExecutor # Import necessary functions from translator.py from translator import get_asr_model, get_asr_processor, LANGUAGE_CODES # Configure logging logger = logging.getLogger("speech_api") def calculate_similarity(text1, text2): """Calculate text similarity percentage.""" def clean_text(text): return text.lower() clean1 = clean_text(text1) clean2 = clean_text(text2) matcher = SequenceMatcher(None, clean1, clean2) return matcher.ratio() * 100 # In evaluate.py, modify the init_reference_audio function def init_reference_audio(reference_dir, output_dir): try: # Create the output directory first os.makedirs(output_dir, exist_ok=True) logger.info(f"๐Ÿ“ Created output directory: {output_dir}") # Check if the reference audio directory exists if not os.path.exists(reference_dir) or not os.access(os.path.dirname(reference_dir), os.W_OK): # Use a directory in /tmp instead reference_dir = os.path.join('/tmp', 'reference_audios') logger.warning(f"โš ๏ธ Using alternate reference directory: {reference_dir}") # Make sure the reference directory exists os.makedirs(reference_dir, exist_ok=True) logger.info(f"๐Ÿ“ Created/verified reference audio directory: {reference_dir}") # Create all the pattern subdirectories setup_reference_patterns(reference_dir) # Try to copy any existing reference files if they exist in the original location original_ref_dir = "./reference_audios" if os.path.exists(original_ref_dir) and reference_dir != original_ref_dir: try: import shutil # Get all pattern directories for item in os.listdir(original_ref_dir): src_path = os.path.join(original_ref_dir, item) dst_path = os.path.join(reference_dir, item) if os.path.isdir(src_path): # Copy directory and contents if not os.path.exists(dst_path): shutil.copytree(src_path, dst_path) logger.info(f"๐Ÿ“ Copied reference pattern from {src_path} to {dst_path}") except Exception as e: logger.warning(f"โš ๏ธ Could not copy original reference files: {str(e)}") # Log the contents to verify if os.path.exists(reference_dir): pattern_dirs = [d for d in os.listdir(reference_dir) if os.path.isdir(os.path.join(reference_dir, d))] logger.info(f"๐Ÿ“ Found reference patterns: {pattern_dirs}") # Check each pattern directory for wav files for pattern_dir_name in pattern_dirs: pattern_path = os.path.join(reference_dir, pattern_dir_name) wav_files = glob.glob(os.path.join(pattern_path, "*.wav")) logger.info(f"๐Ÿ“ Found {len(wav_files)} wav files in {pattern_dir_name}") return reference_dir except Exception as e: logger.error(f"โŒ Failed to set up reference audio directory: {str(e)}") return reference_dir def handle_upload_reference(request, reference_dir, sample_rate): """Handle upload of reference audio files""" try: if "audio" not in request.files: logger.warning("โš ๏ธ Reference upload missing audio file") return jsonify({"error": "No audio file uploaded"}), 400 reference_word = request.form.get("reference_word", "").strip() if not reference_word: logger.warning("โš ๏ธ Reference upload missing reference word") return jsonify({"error": "No reference word provided"}), 400 # Validate reference word reference_patterns = [ "mayap_a_abak", "mayap_a_ugtu", "mayap_a_gatpanapun", "mayap_a_bengi", "komusta_ka", "malaus_ko_pu", "malaus_kayu", "agaganaka_da_ka", "pagdulapan_da_ka", "kaluguran_da_ka", "dakal_a_salamat", "panapaya_mu_ku" ] if reference_word not in reference_patterns: logger.warning(f"โš ๏ธ Invalid reference word: {reference_word}") return jsonify({"error": f"Invalid reference word. Available: {reference_patterns}"}), 400 # Create directory for reference pattern if it doesn't exist pattern_dir = os.path.join(reference_dir, reference_word) os.makedirs(pattern_dir, exist_ok=True) # Save the reference audio file audio_file = request.files["audio"] file_path = os.path.join(pattern_dir, secure_filename(audio_file.filename)) audio_file.save(file_path) # Convert to WAV if not already in that format if not file_path.lower().endswith('.wav'): base_path = os.path.splitext(file_path)[0] wav_path = f"{base_path}.wav" try: audio = AudioSegment.from_file(file_path) audio = audio.set_frame_rate(sample_rate).set_channels(1) audio.export(wav_path, format="wav") # Remove original file if conversion successful os.unlink(file_path) file_path = wav_path except Exception as e: logger.error(f"โŒ Reference audio conversion failed: {str(e)}") return jsonify({"error": f"Audio conversion failed: {str(e)}"}), 500 logger.info(f"โœ… Reference audio saved successfully for {reference_word}: {file_path}") # Count how many references we have now references = glob.glob(os.path.join(pattern_dir, "*.wav")) return jsonify({ "message": "Reference audio uploaded successfully", "reference_word": reference_word, "file": os.path.basename(file_path), "total_references": len(references) }) except Exception as e: logger.error(f"โŒ Unhandled exception in reference upload: {str(e)}") logger.debug(f"Stack trace: {traceback.format_exc()}") return jsonify({"error": f"Internal server error: {str(e)}"}), 500 def handle_evaluation_request(request, reference_dir, output_dir, sample_rate): request_id = f"req-{id(request)}" # Create unique ID for this request logger.info(f"[{request_id}] ๐Ÿ†• Starting new pronunciation evaluation request") temp_dir = None # Get the ASR model and processor using the getter functions asr_model = get_asr_model() asr_processor = get_asr_processor() if asr_model is None or asr_processor is None: logger.error(f"[{request_id}] โŒ Evaluation endpoint called but ASR models aren't loaded") return jsonify({"error": "ASR model not available"}), 503 try: if "audio" not in request.files: logger.warning(f"[{request_id}] โš ๏ธ Evaluation request missing audio file") return jsonify({"error": "No audio file uploaded"}), 400 audio_file = request.files["audio"] reference_locator = request.form.get("reference_locator", "").strip() language = request.form.get("language", "kapampangan").lower() # Validate reference locator if not reference_locator: logger.warning(f"[{request_id}] โš ๏ธ No reference locator provided") return jsonify({"error": "Reference locator is required"}), 400 # Construct full reference directory path reference_dir_path = os.path.join(reference_dir, reference_locator) logger.info(f"[{request_id}] ๐Ÿ“ Reference directory path: {reference_dir_path}") if not os.path.exists(reference_dir_path): logger.warning(f"[{request_id}] โš ๏ธ Reference directory not found: {reference_dir_path}") return jsonify({"error": f"Reference audio directory not found: {reference_locator}"}), 404 reference_files = glob.glob(os.path.join(reference_dir_path, "*.wav")) logger.info(f"[{request_id}] ๐Ÿ“ Found {len(reference_files)} reference files") # Inside handle_evaluation_request, after checking for reference files: if not reference_files: logger.warning(f"[{request_id}] โš ๏ธ No reference audio files found in {reference_dir_path}") # Create a dummy reference file for testing try: dummy_file_path = os.path.join(reference_dir_path, "dummy_reference.wav") logger.info(f"[{request_id}] ๐Ÿ”„ Creating dummy reference file: {dummy_file_path}") # Create a 1-second silent WAV file silent_audio = AudioSegment.silent(duration=1000, frame_rate=sample_rate) silent_audio.export(dummy_file_path, format="wav") # Add it to the list of reference files reference_files = [dummy_file_path] logger.info(f"[{request_id}] โœ… Created dummy reference file for testing") except Exception as e: logger.error(f"[{request_id}] โŒ Failed to create dummy reference: {str(e)}") return jsonify({"error": f"No reference audio found for {reference_locator}"}), 404 lang_code = LANGUAGE_CODES.get(language, language) logger.info( f"[{request_id}] ๐Ÿ”„ Evaluating pronunciation for reference: {reference_locator} with language code: {lang_code}") # Create a request-specific temp directory to avoid conflicts temp_dir = os.path.join(output_dir, f"temp_{request_id}") os.makedirs(temp_dir, exist_ok=True) # Process user audio user_audio_path = os.path.join(temp_dir, "user_audio_input.wav") with open(user_audio_path, 'wb') as f: f.write(audio_file.read()) try: logger.info(f"[{request_id}] ๐Ÿ”„ Processing user audio file") audio = AudioSegment.from_file(user_audio_path) audio = audio.set_frame_rate(sample_rate).set_channels(1) processed_path = os.path.join(temp_dir, "processed_user_audio.wav") audio.export(processed_path, format="wav") user_waveform, sr = torchaudio.load(processed_path) user_waveform = user_waveform.squeeze().numpy() logger.info(f"[{request_id}] โœ… User audio processed: {sr}Hz, length: {len(user_waveform)} samples") user_audio_path = processed_path except Exception as e: logger.error(f"[{request_id}] โŒ Audio processing failed: {str(e)}") return jsonify({"error": f"Audio processing failed: {str(e)}"}), 500 # Transcribe user audio try: logger.info(f"[{request_id}] ๐Ÿ”„ Transcribing user audio") inputs = asr_processor( user_waveform, sampling_rate=sample_rate, return_tensors="pt", language=lang_code ) inputs = {k: v.to(asr_model.device) for k, v in inputs.items()} with torch.no_grad(): logits = asr_model(**inputs).logits ids = torch.argmax(logits, dim=-1)[0] user_transcription = asr_processor.decode(ids) logger.info(f"[{request_id}] โœ… User transcription: '{user_transcription}'") except Exception as e: logger.error(f"[{request_id}] โŒ ASR inference failed: {str(e)}") return jsonify({"error": f"ASR inference failed: {str(e)}"}), 500 # Process reference files in batches batch_size = 2 # Process 2 files at a time - adjust based on your hardware results = [] best_score = 0 best_reference = None best_transcription = None # Use this if you want to limit the number of files to process max_files_to_check = min(5, len(reference_files)) # Check at most 5 files reference_files = reference_files[:max_files_to_check] logger.info(f"[{request_id}] ๐Ÿ”„ Processing {len(reference_files)} reference files in batches of {batch_size}") # Function to process a single reference file def process_reference_file(ref_file): ref_filename = os.path.basename(ref_file) try: # Load and resample reference audio ref_waveform, ref_sr = torchaudio.load(ref_file) if ref_sr != sample_rate: ref_waveform = torchaudio.transforms.Resample(ref_sr, sample_rate)(ref_waveform) ref_waveform = ref_waveform.squeeze().numpy() # Transcribe reference audio - use the local asr_model and asr_processor inputs = asr_processor( ref_waveform, sampling_rate=sample_rate, return_tensors="pt", language=lang_code ) inputs = {k: v.to(asr_model.device) for k, v in inputs.items()} with torch.no_grad(): logits = asr_model(**inputs).logits ids = torch.argmax(logits, dim=-1)[0] ref_transcription = asr_processor.decode(ids) # Calculate similarity similarity = calculate_similarity(user_transcription, ref_transcription) logger.info( f"[{request_id}] ๐Ÿ“Š Similarity with {ref_filename}: {similarity:.2f}%, transcription: '{ref_transcription}'") return { "reference_file": ref_filename, "reference_text": ref_transcription, "similarity_score": similarity } except Exception as e: logger.error(f"[{request_id}] โŒ Error processing {ref_filename}: {str(e)}") return { "reference_file": ref_filename, "reference_text": "Error", "similarity_score": 0, "error": str(e) } # Process files in batches using ThreadPoolExecutor with ThreadPoolExecutor(max_workers=batch_size) as executor: batch_results = list(executor.map(process_reference_file, reference_files)) results.extend(batch_results) # Find the best result for result in batch_results: if result["similarity_score"] > best_score: best_score = result["similarity_score"] best_reference = result["reference_file"] best_transcription = result["reference_text"] # Exit early if we found a very good match (optional) if best_score > 80.0: logger.info(f"[{request_id}] ๐Ÿ Found excellent match: {best_score:.2f}%") break # Clean up temp files try: if temp_dir and os.path.exists(temp_dir): shutil.rmtree(temp_dir) logger.debug(f"[{request_id}] ๐Ÿงน Cleaned up temporary directory") except Exception as e: logger.warning(f"[{request_id}] โš ๏ธ Failed to clean up temp files: {str(e)}") # Determine feedback based on score is_correct = best_score >= 70.0 if best_score >= 90.0: feedback = "Perfect pronunciation! Excellent job!" elif best_score >= 80.0: feedback = "Great pronunciation! Your accent is very good." elif best_score >= 70.0: feedback = "Good pronunciation. Keep practicing!" elif best_score >= 50.0: feedback = "Fair attempt. Try focusing on the syllables that differ from the sample." else: feedback = "Try again. Listen carefully to the sample pronunciation." logger.info(f"[{request_id}] ๐Ÿ“Š Final evaluation results: score={best_score:.2f}%, is_correct={is_correct}") logger.info(f"[{request_id}] ๐Ÿ“ Feedback: '{feedback}'") logger.info(f"[{request_id}] โœ… Evaluation complete") # Sort results by score descending results.sort(key=lambda x: x["similarity_score"], reverse=True) return jsonify({ "is_correct": is_correct, "score": best_score, "feedback": feedback, "user_transcription": user_transcription, "best_reference_transcription": best_transcription, "reference_locator": reference_locator, "details": results }) except Exception as e: logger.error(f"[{request_id}] โŒ Unhandled exception in evaluation endpoint: {str(e)}") logger.debug(f"[{request_id}] Stack trace: {traceback.format_exc()}") # Clean up on error try: if temp_dir and os.path.exists(temp_dir): shutil.rmtree(temp_dir) except: pass return jsonify({"error": f"Internal server error: {str(e)}"}), 500 def setup_reference_patterns(reference_dir): """Create standard reference pattern directories if they don't exist""" reference_patterns = [ "mayap_a_abak", "mayap_a_ugtu", "mayap_a_gatpanapun", "mayap_a_bengi", "komusta_ka", "malaus_ko_pu", "malaus_kayu", "agaganaka_da_ka", "pagdulapan_da_ka", "kaluguran_da_ka", "dakal_a_salamat", "panapaya_mu_ku" ] for pattern in reference_patterns: pattern_dir = os.path.join(reference_dir, pattern) if not os.path.exists(pattern_dir): try: os.makedirs(pattern_dir, exist_ok=True) logger.info(f"๐Ÿ“ Created reference pattern directory: {pattern_dir}") except Exception as e: logger.error(f"โŒ Failed to create reference pattern directory {pattern_dir}: {str(e)}")