Upload folder using huggingface_hub

app.py

@@ -206,6 +206,19 @@ if uploaded_file is not None:
                 hide_index=True
             )
             
+            # --- Qualitative Feedback Section ---
+            failed_rows = df_results[df_results['Result'] == 'FAIL']
+            if not failed_rows.empty:
+                st.divider()
+                st.subheader("🛠️ Recommendations for Improvement")
+                for index, row in failed_rows.iterrows():
+                    metric = row['Metric']
+                    feedback = config.METRIC_FEEDBACK.get(metric, "Check your setup.")
+                    
+                    with st.expander(f"Fix for {metric} (Score: {row['Score']})", expanded=True):
+                        st.markdown(feedback)
+            # ------------------------------------
+            
             # Download Button
             csv = df_results.to_csv(index=False).encode('utf-8')
             st.download_button(

config.py

@@ -22,3 +22,14 @@ METRIC_DESCRIPTIONS = {
     'Recording SR': 'Digital Sampling Rate of the file (should be >= 44.1kHz)',
     'Mic SR': 'Estimated effective bandwidth of the microphone (should conform to > 16kHz capture)'
 }
+
+METRIC_FEEDBACK = {
+    'SRMR': "The audio has high reverberation or room echo. \n**Fix:** Record in a smaller room, use sound-absorbing materials (curtains, foam), or get closer to the mic.",
+    'SIGMOS_DISC': "The audio sounds choppy or has interruptions. \n**Fix:** Check your internet connection (if VoIP), reduce CPU load, or check for faulty cables.",
+    'VQScore': "The voice quality is degraded (robotic, fuzzy). \n**Fix:** Use a higher quality microphone, check for codec compression issues, or increase bitrate.",
+    'WVMOS': "The overall subjective quality is low. \n**Fix:** This is a comprehensive score. Check for background noise, bad mic, or aggressive compression. Try recording a cleaner sample.",
+    'SIGMOS_OVRL': "The overall signal quality is poor. \n**Fix:** Ensure a quiet environment and a decent microphone. Avoid post-processing that introduces artifacts.",
+    'SIGMOS_REVERB': "Too much echo detected. \n**Fix:** Treat your room acoustics or move the microphone away from reflective surfaces (walls, windows).",
+    'Recording SR': "The file quality is low (Sample Rate < 44.1kHz). \n**Fix:** Check your recording software settings and ensure it's set to 44.1kHz or 48kHz.",
+    'Mic SR': "The microphone is not capturing the full frequency range (Low Bandwidth). \n**Fix:** You might be using a low-quality mic (e.g., Bluetooth headset) or a high-cut filter is active. Use a better mic or check filters."
+}