Version 4.25.10

Improve RVC training Linux FAISS dependency recovery

Technical details:
- Validate faiss imports after Linux CUDA GPU package installation
- Fall back to faiss-cpu when faiss-gpu installs but cannot import
- Log broken faiss import errors more clearly during installation

Author: diodiogod

CHANGELOG.md

@@ -5,6 +5,20 @@ 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.25.10] - 2026-04-12
+
+### Added
+
+- Show clearer install warnings when faiss is present but unusable
+
+### Changed
+
+- Improve RVC training FAISS setup on Linux
+- Improve RVC training setup when Linux CUDA faiss packages install incorrectly
+
+### Fixed
+
+- Fall back to faiss-cpu automatically if the GPU faiss package is broken
 ## [4.25.9] - 2026-04-11
 
 ### Changed

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.25.9
+# TTS Audio Suite v4.25.10
 
 [![ko-fi](https://ko-fi.com/img/githubbutton_sm.svg)](https://ko-fi.com/diogogo)
 

install.py

@@ -448,6 +448,24 @@ def install_pytorch_with_cuda(self):
 
             self.run_pip_command(pytorch_cmd_25, f"Installing PyTorch 2.5+ ({cuda_version} support)")
 
+    def verify_python_import(self, module_name: str) -> bool:
+        """Verify a module imports in the target Python environment."""
+        try:
+            result = subprocess.run(
+                [sys.executable, "-c", f"import {module_name}"],
+                capture_output=True,
+                text=True,
+                timeout=30,
+            )
+            if result.returncode == 0:
+                return True
+            error_text = (result.stderr or result.stdout or "unknown import failure").strip()
+            self.log(f"Python import check failed for {module_name}: {error_text}", "WARNING")
+            return False
+        except Exception as e:
+            self.log(f"Python import check failed for {module_name}: {e}", "WARNING")
+            return False
+
     def check_package_installed(self, package_spec):
         """Check if a package meets the version requirement"""
         try:
@@ -721,12 +739,22 @@ def install_rvc_dependencies(self):
 
                 # Try GPU installation first with --no-deps to prevent numpy downgrade
                 self.run_pip_command(["install", "--no-deps", faiss_gpu_package], f"Installing {faiss_gpu_package} for GPU acceleration (--no-deps)")
-                self.log("faiss-gpu installed with --no-deps - RVC will use GPU acceleration without downgrading numpy", "SUCCESS")
+                if self.verify_python_import("faiss"):
+                    self.log("faiss-gpu import test passed", "SUCCESS")
+                else:
+                    self.log("faiss-gpu package installed but import failed - falling back to CPU version", "WARNING")
+                    faiss_gpu_name = faiss_gpu_package.split(">=")[0]
+                    self.run_pip_command(["uninstall", "-y", faiss_gpu_name], f"Removing broken {faiss_gpu_name}", ignore_errors=True)
+                    self.run_pip_command(["install", "--no-deps", "faiss-cpu>=1.7.4"], "Installing faiss-cpu (fallback, --no-deps)")
+                    if not self.verify_python_import("faiss"):
+                        self.log("faiss-cpu installed but faiss import still failed", "WARNING")
 
             except subprocess.CalledProcessError:
                 # GPU installation failed - fallback to CPU
                 self.log("faiss-gpu installation failed - falling back to CPU version", "WARNING")
                 self.run_pip_command(["install", "--no-deps", "faiss-cpu>=1.7.4"], "Installing faiss-cpu (fallback, --no-deps)")
+                if not self.verify_python_import("faiss"):
+                    self.log("faiss-cpu installed but faiss import still failed", "WARNING")
         else:
             # Windows or no CUDA - use reliable CPU version
             if self.is_windows and cuda_version != "cpu":
@@ -739,6 +767,9 @@ def install_rvc_dependencies(self):
             else:
                 self.run_pip_command(["install", "--no-deps", "faiss-cpu>=1.7.4"], "Installing faiss-cpu for RVC voice matching (--no-deps)")
 
+            if not self.verify_python_import("faiss"):
+                self.log("faiss-cpu is installed but faiss import still failed", "WARNING")
+
     def install_numpy_with_constraints(self):
         """Install numpy with version constraints for compatibility"""
         self.log("Checking numpy compatibility", "INFO")

nodes.py

@@ -11,7 +11,7 @@
     pass
 
 # Version and constants
-VERSION = "4.25.9"
+VERSION = "4.25.10"
 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.25.9"
+version = "4.25.10"
 license = {file = "LICENSE"}
 
 [project.urls]