Version 4.21.18

Fix: Restore Numba/librosa JIT compatibility test at startup for NumPy 2.x

- Restore full librosa JIT test at startup for NumPy 2.x environments
- PR 262 lazy-import optimization had deferred this test too late, after numba
  was already loaded, making NUMBA_DISABLE_JIT ineffective
- NumPy 1.x users still skip the test entirely (zero cost)
- Python 3.13+ still handled by preemptive env var (zero cost)
- Addresses get_call_template AttributeError crash in librosa on affected hardware

Author: diodiogod

CHANGELOG.md

@@ -5,6 +5,22 @@ 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).
 
+## [4.21.18] - 2026-02-28
+
+### Added
+
+- Engines like IndexTTS-2, Qwen3-TTS, RVC and others failed with AttributeError
+
+### Changed
+
+- No performance impact for users on NumPy 1.x
+
+### Fixed
+
+- Fix all engines crashing with Numba/librosa JIT error on NumPy 2.x
+- Fix crash affecting all TTS engines on NumPy 2.x with certain hardware
+- in librosa audio processing (get_call_template error)
+- Numba JIT compatibility is now correctly detected and disabled at startup
 ## [4.21.17] - 2026-02-22
 
 ### Added

README.md

@@ -7,7 +7,7 @@
 [![Dynamic TOML Badge][version-shield]][version-url]
 [![Ko-Fi](https://img.shields.io/badge/Ko--fi-F16061?style=for-the-badge&logo=ko-fi&logoColor=white)](https://ko-fi.com/diogogo)
 
-# TTS Audio Suite v4.21.17
+# TTS Audio Suite v4.21.18
 
 [![ko-fi](https://ko-fi.com/img/githubbutton_sm.svg)](https://ko-fi.com/diogogo)
 

__init__.py

@@ -69,13 +69,25 @@ def _apply_transformers_patches_once():
     except Exception as e:
         print(f"⚠️ Warning: Could not apply Transformers patches: {e}")
 
-# Numba/Librosa compatibility check DEFERRED to first engine use.
-# The numba_compat module imports librosa (~0.7s) to test JIT compilation,
-# which is too expensive for startup. Instead, we defer the test until
-# an engine actually needs librosa. On Python 3.13+ we preemptively set
-# the safe env var since numba JIT is known to be problematic there.
+# Numba/Librosa compatibility check at startup.
+# On Python 3.13+ we preemptively disable JIT (known incompatible).
+# On NumPy 2.x we run the full librosa JIT test (~0.7s) because numba's
+# @guvectorize crashes on some hardware with NumPy 2.x — this must happen
+# before any engine lazy-loads librosa/numba, or the env var is too late.
+# On NumPy 1.x we skip the test entirely (not affected).
 if sys.version_info >= (3, 13):
     os.environ.setdefault('NUMBA_DISABLE_JIT', '1')
+else:
+    try:
+        import numpy as _np
+        if int(_np.__version__.split('.')[0]) >= 2:
+            numba_compat_path = os.path.join(os.path.dirname(__file__), "utils", "compatibility", "numba_compat.py")
+            _spec = importlib.util.spec_from_file_location("numba_compat_module", numba_compat_path)
+            _numba_compat = importlib.util.module_from_spec(_spec)
+            _spec.loader.exec_module(_numba_compat)
+            _numba_compat.setup_numba_compatibility(quick_startup=False, verbose=False)
+    except Exception:
+        pass
 
 # TorchCodec note: Removed torchcodec dependency to eliminate FFmpeg system requirement
 # torchaudio.load() works fine with fallback backends (soundfile, scipy)
@@ -345,10 +357,10 @@ async def get_available_languages_endpoint(request):
                 # Fallback list
                 return web.json_response({"languages": ["en", "de", "fr", "ja", "es", "it", "pt", "th", "no"], "error": str(e)})
 
-        @PromptServer.instance.routes.post("/api/tts-audio-suite/settings")
-        async def set_inline_tag_settings_endpoint(request):
-            """API endpoint to receive settings from frontend for inline edit tags and restore VC"""
-            print("🔧 Settings endpoint called")  # Immediate print to verify endpoint is reached
+        @PromptServer.instance.routes.post("/api/tts-audio-suite/settings")
+        async def set_inline_tag_settings_endpoint(request):
+            """API endpoint to receive settings from frontend for inline edit tags and restore VC"""
+            print("🔧 Settings endpoint called")  # Immediate print to verify endpoint is reached
             try:
                 data = await request.json()
                 precision = data.get("precision", "auto")
@@ -375,45 +387,45 @@ async def set_inline_tag_settings_endpoint(request):
                 edit_post_processor_module.set_inline_tag_settings(precision=precision, device=device, vc_engine=vc_engine, cosyvoice_variant=cosyvoice_variant)
 
                 return web.json_response({"status": "success", "precision": precision, "device": device, "vc_engine": vc_engine, "cosyvoice_variant": cosyvoice_variant})
-            except Exception as e:
-                print(f"⚠️ Error setting inline tag settings: {e}")
-                return web.json_response({"status": "error", "error": str(e)})
-
-        @PromptServer.instance.routes.get("/api/tts-audio-suite/voice-preview")
-        async def get_voice_preview_endpoint(request):
-            """
-            Stream selected Character Voices dropdown audio for browser preview playback.
-
-            Query params:
-            - voice_name: exact dropdown key from get_available_voices()
-            """
-            try:
-                voice_name = request.query.get("voice_name", "").strip()
-                if not voice_name or voice_name == "none":
-                    return web.json_response({"error": "voice_name is required and cannot be 'none'"}, status=400)
-
-                # Load voice discovery directly by file path to avoid package import issues
-                voice_discovery_path = os.path.join(os.path.dirname(__file__), "utils", "voice", "discovery.py")
-                spec = importlib.util.spec_from_file_location("voice_discovery_module", voice_discovery_path)
-                voice_discovery_module = importlib.util.module_from_spec(spec)
-                spec.loader.exec_module(voice_discovery_module)
-
-                # Use cached discovery for fast preview playback.
-                voice_discovery_module.get_available_voices(force_refresh=False)
-                audio_path, _ = voice_discovery_module.load_voice_reference(voice_name)
-
-                if not audio_path or not os.path.exists(audio_path):
-                    return web.json_response({"error": f"Voice file not found: {voice_name}"}, status=404)
-
-                # Direct stream of resolved local audio file.
-                response = web.FileResponse(path=audio_path)
-                response.headers["Cache-Control"] = "no-store, no-cache, must-revalidate"
-                return response
-            except Exception as e:
-                print(f"⚠️ Error serving voice preview audio: {e}")
-                return web.json_response({"error": str(e)}, status=500)
-    except Exception as e:
-        print(f"⚠️ Could not setup API routes: {e}")
+            except Exception as e:
+                print(f"⚠️ Error setting inline tag settings: {e}")
+                return web.json_response({"status": "error", "error": str(e)})
+
+        @PromptServer.instance.routes.get("/api/tts-audio-suite/voice-preview")
+        async def get_voice_preview_endpoint(request):
+            """
+            Stream selected Character Voices dropdown audio for browser preview playback.
+
+            Query params:
+            - voice_name: exact dropdown key from get_available_voices()
+            """
+            try:
+                voice_name = request.query.get("voice_name", "").strip()
+                if not voice_name or voice_name == "none":
+                    return web.json_response({"error": "voice_name is required and cannot be 'none'"}, status=400)
+
+                # Load voice discovery directly by file path to avoid package import issues
+                voice_discovery_path = os.path.join(os.path.dirname(__file__), "utils", "voice", "discovery.py")
+                spec = importlib.util.spec_from_file_location("voice_discovery_module", voice_discovery_path)
+                voice_discovery_module = importlib.util.module_from_spec(spec)
+                spec.loader.exec_module(voice_discovery_module)
+
+                # Use cached discovery for fast preview playback.
+                voice_discovery_module.get_available_voices(force_refresh=False)
+                audio_path, _ = voice_discovery_module.load_voice_reference(voice_name)
+
+                if not audio_path or not os.path.exists(audio_path):
+                    return web.json_response({"error": f"Voice file not found: {voice_name}"}, status=404)
+
+                # Direct stream of resolved local audio file.
+                response = web.FileResponse(path=audio_path)
+                response.headers["Cache-Control"] = "no-store, no-cache, must-revalidate"
+                return response
+            except Exception as e:
+                print(f"⚠️ Error serving voice preview audio: {e}")
+                return web.json_response({"error": str(e)}, status=500)
+    except Exception as e:
+        print(f"⚠️ Could not setup API routes: {e}")
 
 # Setup API routes when extension loads
 setup_api_routes()

nodes.py

@@ -11,7 +11,7 @@
     pass
 
 # Version and constants
-VERSION = "4.21.17"
+VERSION = "4.21.18"
 IS_DEV = False  # Set to False for release builds
 VERSION_DISPLAY = f"v{VERSION}" + (" (dev)" if IS_DEV else "")
 SEPARATOR = "=" * 70

pyproject.toml

@@ -1,7 +1,7 @@
 [project]
 name = "tts_audio_suite"
 description = "TTS Audio Suite - Universal multi-engine TTS extension for ComfyUI with unified architecture supporting IndexTTS-2, ChatterBox, Chatterbox Multilingual TTS (Official 23-Lang), F5-TTS, Higgs Audio 2, VibeVoice, and RVC engines. It has character voice management, SRT subtitle TTS support, and audio processing capabilities."
-version = "4.21.17"
+version = "4.21.18"
 license = {file = "LICENSE"}
 
 [project.urls]

utils/compatibility/numba_compat.py

@@ -50,7 +50,7 @@ def test_numba_compatibility(self, quick_test: bool = True) -> Dict[str, Any]:
             if sys.version_info >= (3, 13):
                 results['jit_compatible'] = False
                 results['errors'].append("Python 3.13+ detected - numba JIT known incompatible (skipped librosa test)")
-            
+
             results['test_duration'] = time.time() - start_time
             self._test_results = results
             return results
@@ -111,7 +111,7 @@ def apply_jit_workaround(self) -> None:
             numba.config.ENABLE_CUDASIM = True
         except ImportError:
             pass  # numba not imported yet, environment variable will handle it
-        
+
         self._jit_disabled = True
         print("🔧 Applied numba JIT workaround for Python 3.12+/Numpy 2.x compatibility")