Version 3.2.2: Add detailed F5-TTS diagnostic messages to help users troubleshoot installation issues. F5-TTS import errors are now always shown during initialization, making it easier to identify missing dependencies without requiring development mode.

Author: diodiogod

CHANGELOG.md

@@ -5,6 +5,11 @@ All notable changes to this project will be documented in this file.
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
+## [3.2.2] - 2025-07-21
+
+### Added
+
+- Add detailed F5-TTS diagnostic messages to help users troubleshoot installation issues. F5-TTS import errors are now always shown during initialization, making it easier to identify missing dependencies without requiring development mode.
 ## [3.2.1] - 2025-07-19
 
 ### Changed

README.md

@@ -6,7 +6,7 @@
 [![Forks][forks-shield]][forks-url]
 [![Dynamic TOML Badge][version-shield]][version-url]
 
-# ComfyUI ChatterBox SRT Voice (diogod) v3.2.1
+# ComfyUI ChatterBox SRT Voice (diogod) v3.2.2
 
 *This is a refactored node, originally created by [ShmuelRonen](https://github.com/ShmuelRonen/ComfyUI_ChatterBox_Voice).*
 

__init__.py

@@ -163,4 +163,20 @@
 print(f"🚀 ChatterBox Voice Extension {VERSION_DISPLAY} loaded with {len(NODE_DISPLAY_NAME_MAPPINGS)} nodes:")
 for node in sorted(NODE_DISPLAY_NAME_MAPPINGS.values()):
     print(f"   • {node}")
+
+# Report missing optional features
+missing_features = []
+if not F5TTS_SUPPORT_AVAILABLE:
+    missing_features.append("F5-TTS nodes")
+if not SRT_SUPPORT_AVAILABLE:
+    missing_features.append("SRT nodes") 
+if not AUDIO_ANALYZER_SUPPORT_AVAILABLE:
+    missing_features.append("Audio Analyzer")
+if not AUDIO_RECORDER_AVAILABLE:
+    missing_features.append("Voice Recorder")
+
+if missing_features:
+    print(f"⚠️  Missing optional features: {', '.join(missing_features)}")
+    print("   Install missing dependencies to enable all features")
+
 print(SEPARATOR)

chatterbox/f5tts/__init__.py

@@ -11,20 +11,22 @@
 warnings.filterwarnings("ignore", message=".*deprecated.*")
 
 # Import F5-TTS modules with error handling
+F5TTS_IMPORT_ERROR = None
 try:
     with warnings.catch_warnings():
         warnings.simplefilter("ignore")
         from .f5tts import ChatterBoxF5TTS
     F5TTS_AVAILABLE = True
-except ImportError:
+except ImportError as e:
     F5TTS_AVAILABLE = False
+    F5TTS_IMPORT_ERROR = str(e)
     # Create dummy class for compatibility
     class ChatterBoxF5TTS:
         @classmethod
         def from_pretrained(cls, device):
-            raise ImportError("F5-TTS not available - missing dependencies")
+            raise ImportError(f"F5-TTS not available: {F5TTS_IMPORT_ERROR}")
         @classmethod
         def from_local(cls, path, device, model_name):
-            raise ImportError("F5-TTS not available - missing dependencies")
+            raise ImportError(f"F5-TTS not available: {F5TTS_IMPORT_ERROR}")
 
-__all__ = ['ChatterBoxF5TTS', 'F5TTS_AVAILABLE']
+__all__ = ['ChatterBoxF5TTS', 'F5TTS_AVAILABLE', 'F5TTS_IMPORT_ERROR']

chatterbox_srt/__init__.py

@@ -4,7 +4,7 @@
 """
 
 # Version info
-__version__ = "3.2.1"
+__version__ = "3.2.2"
 __author__ = "Diogod"
 
 # Import the new SRT modules

core/__init__.py

@@ -4,7 +4,7 @@
 """
 
 # Version info
-__version__ = "3.2.1"
+__version__ = "3.2.2"
 __author__ = "Diogod"
 
 # Make imports available at package level

nodes.py

@@ -1,5 +1,5 @@
 # Version and constants
-VERSION = "3.2.1"
+VERSION = "3.2.2"
 IS_DEV = False  # Set to False for release builds
 VERSION_DISPLAY = f"v{VERSION}" + (" (dev)" if IS_DEV else "")
 SEPARATOR = "=" * 70
@@ -267,6 +267,38 @@ def error(self, error):
     if IS_DEV:
         print("❌ SRT support initialization failed")
 
+# Update F5-TTS node availability with detailed diagnostics
+try:
+    success, f5tts_class, source = import_manager.import_f5tts()
+    if success:
+        # F5-TTS is available - update global flag if needed
+        if not F5TTS_SUPPORT_AVAILABLE:
+            # This means the node loading failed earlier, but core F5-TTS is available
+            if IS_DEV:
+                print(f"⚠️ F5-TTS core available ({source}) but node loading failed - check node dependencies")
+        else:
+            if IS_DEV:
+                print(f"✅ F5-TTS available! (source: {source})")
+    else:
+        # F5-TTS not available - get detailed error info
+        from chatterbox.f5tts import F5TTS_IMPORT_ERROR
+        F5TTS_SUPPORT_AVAILABLE = False
+        F5TTS_SRT_SUPPORT_AVAILABLE = False  
+        F5TTS_EDIT_SUPPORT_AVAILABLE = False
+        F5TTS_EDIT_OPTIONS_SUPPORT_AVAILABLE = False
+        # Always show F5-TTS errors to help with troubleshooting
+        if F5TTS_IMPORT_ERROR:
+            print(f"❌ F5-TTS not available: {F5TTS_IMPORT_ERROR}")
+        else:
+            print("❌ F5-TTS support not available")
+except Exception as e:
+    F5TTS_SUPPORT_AVAILABLE = False
+    F5TTS_SRT_SUPPORT_AVAILABLE = False
+    F5TTS_EDIT_SUPPORT_AVAILABLE = False
+    F5TTS_EDIT_OPTIONS_SUPPORT_AVAILABLE = False
+    # Always show critical F5-TTS errors
+    print(f"❌ F5-TTS initialization failed: {str(e)}")
+
 # Legacy compatibility: Remove old large SRT implementation - it's now in the new node
 
 # Register nodes

pyproject.toml

@@ -1,7 +1,7 @@
 [project]
 name = "chatterbox_srt_voice"
 description = "ChatterBox SRT Voice TTS Node is a fork of 'ChatteBox Voice' with additional devolpments and full F5-TTS implementation as well. I introduced a SRT node designed to help you synchronize your generated TTS audio with `.srt` subtitle files. Audio wave analyzer will help you find speech segments for f5 speech edit and much more!"
-version = "3.2.1"
+version = "3.2.2"
 license = {file = "LICENSE"}
 dependencies = ["s3tokenizer>=0.1.7", "resemble-perth", "librosa", "scipy", "omegaconf", "accelerate", "transformers==4.46.3", "# Additional dependencies for SRT support and audio processing", "conformer>=0.3.2", "torch", "torchaudio", "numpy", "einops", "phonemizer", "g2p-en", "unidecode", "# Audio processing and timing dependencies", "soundfile", "resampy", "webrtcvad", "# Optional but recommended for better performance", "numba"]