Align HF with Gradio 4 stack

AGENTS.md

@@ -65,7 +65,7 @@ python -c "import torch; print(torch.cuda.is_available())"
 - Display name assembly: `_get_display_name()` appends `(500 epochs·40k)` style training info
 
 **UI** (`ui/app.py`):
-- Gradio 3.50.2, single-file ~2000 lines
+- Gradio 4.44.1, single-file ~2000 lines
 - i18n via `i18n/zh_CN.json`, accessed through `t(key, section)` helper
 - Three main tabs: song cover (full pipeline), model management, settings
 - Cover tab features:
@@ -116,7 +116,7 @@ python -c "import torch; print(torch.cuda.is_available())"
 - `fairseq` is pinned to `0.12.2` — HuBERT loading breaks on other versions
 - `audio-separator` must be installed with `[gpu]` extra for CUDA support
 - Roformer model auto-downloads on first use to `assets/separator_models/`
-- Gradio is pinned to `3.50.2`; the UI code uses v3 API patterns (not v4)
+- Gradio is pinned to `4.44.1`; `huggingface_hub` is kept below 1.0 because this Gradio release still imports `HfFolder`
 - Model weights (.pt, .pth) and audio files are gitignored — never commit them
 - Path handling uses `pathlib.Path` for cross-platform compatibility (Windows/Linux)
 - Virtual environment activation differs by platform: `Scripts/Activate.ps1` (Windows) vs `bin/activate` (Linux)

CLAUDE.md

@@ -65,7 +65,7 @@ python -c "import torch; print(torch.cuda.is_available())"
 - Display name assembly: `_get_display_name()` appends `(500 epochs·40k)` style training info
 
 **UI** (`ui/app.py`):
-- Gradio 3.50.2, single-file ~2000 lines
+- Gradio 4.44.1, single-file ~2000 lines
 - i18n via `i18n/zh_CN.json`, accessed through `t(key, section)` helper
 - Three main tabs: song cover (full pipeline), model management, settings
 - Cover tab features:
@@ -116,7 +116,7 @@ python -c "import torch; print(torch.cuda.is_available())"
 - `fairseq` is pinned to `0.12.2` — HuBERT loading breaks on other versions
 - `audio-separator` must be installed with `[gpu]` extra for CUDA support
 - Roformer model auto-downloads on first use to `assets/separator_models/`
-- Gradio is pinned to `3.50.2`; the UI code uses v3 API patterns (not v4)
+- Gradio is pinned to `4.44.1`; `huggingface_hub` is kept below 1.0 because this Gradio release still imports `HfFolder`
 - Model weights (.pt, .pth) and audio files are gitignored — never commit them
 - Path handling uses `pathlib.Path` for cross-platform compatibility (Windows/Linux)
 - Virtual environment activation differs by platform: `Scripts/Activate.ps1` (Windows) vs `bin/activate` (Linux)

README.md

@@ -4,7 +4,7 @@ emoji: 🎤
 colorFrom: blue
 colorTo: purple
 sdk: gradio
-sdk_version: 3.50.2
+sdk_version: 4.44.1
 python_version: "3.10"
 app_file: app.py
 pinned: false
@@ -20,7 +20,7 @@ AI-RVC 是一个基于 **RVC v2** 的一键 AI 翻唱与声音转换 WebUI。上
 ## 功能特点
 
 - **AI 歌曲翻唱**：上传 MP3/WAV/FLAC，自动分离人声、转换音色、混合伴奏，一键生成 AI cover。
-- **人声分离**：默认 `audio-separator` 0.44.1 ensemble 预设（`ensemble:vocal_rvc`），可处理常见歌曲里的主唱与伴奏分离。
+- **人声分离**：默认 `audio-separator` 0.44.1 ensemble 预设（`ensemble:vocal_rvc`），配合 Gradio 4 / NumPy 2 运行，可处理常见歌曲里的主唱与伴奏分离。
 - **音色转换**：RVC v2 架构 + FAISS 检索增强流程，搭配角色模型完成声线转换。
 - **RMVPE 音高提取**：用于提取 F0 基频曲线，让旋律和音高更稳。
 - **角色模型**：内置 117 个可下载角色模型，支持系列筛选和关键词搜索。

README_HF.md

@@ -4,7 +4,7 @@ emoji: 🎤
 colorFrom: blue
 colorTo: purple
 sdk: gradio
-sdk_version: 3.50.2
+sdk_version: 4.44.1
 python_version: "3.10"
 app_file: app.py
 pinned: false
@@ -20,7 +20,7 @@ AI-RVC 是一个基于 **RVC v2** 的一键 AI 翻唱与声音转换 WebUI。上
 ## 功能特点
 
 - **AI 歌曲翻唱**：上传 MP3/WAV/FLAC，自动分离人声、转换音色、混合伴奏，一键生成 AI cover。
-- **人声分离**：默认 `audio-separator` 0.44.1 ensemble 预设（`ensemble:vocal_rvc`），可处理常见歌曲里的主唱与伴奏分离。
+- **人声分离**：默认 `audio-separator` 0.44.1 ensemble 预设（`ensemble:vocal_rvc`），配合 Gradio 4 / NumPy 2 运行，可处理常见歌曲里的主唱与伴奏分离。
 - **音色转换**：RVC v2 架构 + FAISS 检索增强流程，搭配角色模型完成声线转换。
 - **RMVPE 音高提取**：用于提取 F0 基频曲线，让旋律和音高更稳。
 - **角色模型**：内置 117 个可下载角色模型，支持系列筛选和关键词搜索。

i18n/en_US.json

@@ -131,7 +131,7 @@
     "language": "Interface Language",
     "save_language": "Save Language",
     "language_saved_restart": "✅ Interface language saved: {language}. Please restart the app for it to take effect.",
-    "language_restart_info": "The language choice is saved to the config file. Because Gradio 3 builds UI labels at startup, restart the app to apply it.",
+    "language_restart_info": "The language choice is saved to the config file. Because Gradio builds UI labels at startup, restart the app to apply it.",
     "runtime_settings": "Runtime Settings",
     "compute_device": "Compute Device",
     "save_settings": "Save Settings",

i18n/zh_CN.json

@@ -131,7 +131,7 @@
     "language": "界面语言",
     "save_language": "保存语言",
     "language_saved_restart": "✅ 已保存界面语言：{language}。请重启应用后生效。",
-    "language_restart_info": "切换语言会保存到配置文件；由于 Gradio 3 的界面文案在启动时生成，重启后生效。",
+    "language_restart_info": "切换语言会保存到配置文件；由于 Gradio 界面文案在启动时生成，重启后生效。",
     "runtime_settings": "运行设置",
     "compute_device": "计算设备",
     "save_settings": "保存设置",

install.py

@@ -27,7 +27,7 @@ PYTHON310_CANDIDATES = [
 PACKAGES = {
     "torch": {"import": "torch", "name": "PyTorch", "pip": "torch"},
     "torchaudio": {"import": "torchaudio", "name": "torchaudio", "pip": "torchaudio"},
-    "gradio": {"import": "gradio", "name": "Gradio", "pip": "gradio==3.50.2"},
+    "gradio": {"import": "gradio", "name": "Gradio", "pip": "gradio==4.44.1"},
     "librosa": {"import": "librosa", "name": "librosa", "pip": "librosa"},
     "soundfile": {"import": "soundfile", "name": "soundfile", "pip": "soundfile"},
     "av": {"import": "av", "name": "PyAV", "pip": "av"},
@@ -35,10 +35,10 @@ PACKAGES = {
     "numpy": {
         "import": "numpy",
         "name": "numpy",
-        "pip": "numpy<2,>=1.23.0",
+        "pip": "numpy>=2,<3",
         "dist": "numpy",
-        "min_version": "1.23.0",
-        "max_exclusive_version": "2.0.0",
+        "min_version": "2.0.0",
+        "max_exclusive_version": "3.0.0",
     },
     "parselmouth": {"import": "parselmouth", "name": "praat-parselmouth", "pip": "praat-parselmouth"},
     "pyworld": {"import": "pyworld", "name": "pyworld", "pip": "pyworld"},
@@ -321,12 +321,6 @@ def install_all(venv_py, gpu=True):
                 extra="gpu" if gpu else "cpu",
                 version_spec=version_spec,
             )
-            if ok:
-                # audio-separator 0.31+ declares numpy>=2, while the current
-                # Gradio 3.x UI stack is pinned to numpy 1.x. The separator
-                # model table and runtime imports work with numpy 1.26, so
-                # restore the app-compatible numpy line after separator install.
-                ok = pip_install(venv_py, "numpy<2,>=1.23.0")
         else:
             ok = pip_install(venv_py, pip_name)
         if not ok:

requirements.txt

@@ -7,19 +7,18 @@ torch>=2.0.0
 torchaudio>=2.0.0
 
 # Gradio 界面
-gradio==3.50.2
-fastapi==0.104.1
-starlette==0.27.0
-anyio<4
-pydantic<2
-jinja2<3.1
-pandas<2
+gradio==4.44.1
+fastapi>=0.115,<1
+anyio>=3,<5
+pydantic>=2,<3
+jinja2>=3.1,<4
+pandas>=2,<3
 
 # 音频处理
 librosa>=0.9.0
 soundfile>=0.12.0
 scipy>=1.10.0
-numpy<2,>=1.23.0
+numpy>=2,<3
 praat-parselmouth>=0.4.3
 torchcrepe>=0.0.20
 
@@ -34,7 +33,7 @@ colorama>=0.4.6
 
 # AI 翻唱功能（核心）
 audio-separator==0.44.1
-huggingface_hub>=0.19.0
+huggingface_hub>=0.19.0,<1.0
 pedalboard>=0.7.0
 ffmpeg-python>=0.2.0
 

requirements_hf.txt

@@ -7,19 +7,18 @@ torch>=2.0.0
 torchaudio>=2.0.0
 
 # Gradio 界面
-gradio==3.50.2
-fastapi==0.104.1
-starlette==0.27.0
-anyio<4
-pydantic<2
-jinja2<3.1
-pandas<2
+gradio==4.44.1
+fastapi>=0.115,<1
+anyio>=3,<5
+pydantic>=2,<3
+jinja2>=3.1,<4
+pandas>=2,<3
 
 # 音频处理
 librosa>=0.9.0
 soundfile>=0.12.0
 scipy>=1.10.0
-numpy<2,>=1.23.0
+numpy>=2,<3
 praat-parselmouth>=0.4.3
 torchcrepe>=0.0.20
 
@@ -34,7 +33,7 @@ colorama>=0.4.6
 
 # AI 翻唱功能（核心）
 audio-separator==0.44.1
-huggingface_hub>=0.19.0
+huggingface_hub>=0.19.0,<1.0
 pedalboard>=0.7.0
 ffmpeg-python>=0.2.0
 

tests/test_hf_entrypoint.py

@@ -28,20 +28,19 @@ class HuggingFaceEntrypointTests(unittest.TestCase):
 
         self.assertIn('python_version: "3.10"', readme)
 
-    def test_space_requirements_keep_gradio_3_compatibility_pins(self):
+    def test_space_requirements_keep_gradio_4_audio_separator_pins(self):
         requirements = (REPO_ROOT / "requirements_hf.txt").read_text(
             encoding="utf-8"
         )
 
-        self.assertIn("gradio==3.50.2", requirements)
-        self.assertIn("fastapi==0.104.1", requirements)
-        self.assertIn("starlette==0.27.0", requirements)
-        self.assertIn("anyio<4", requirements)
-        self.assertIn("pydantic<2", requirements)
-        self.assertIn("jinja2<3.1", requirements)
-        self.assertIn("pandas<2", requirements)
-        self.assertIn("numpy<2,>=1.23.0", requirements)
+        self.assertIn("gradio==4.44.1", requirements)
+        self.assertIn("fastapi>=0.115,<1", requirements)
+        self.assertIn("pydantic>=2,<3", requirements)
+        self.assertIn("jinja2>=3.1,<4", requirements)
+        self.assertIn("pandas>=2,<3", requirements)
+        self.assertIn("numpy>=2,<3", requirements)
         self.assertIn("audio-separator==0.44.1", requirements)
+        self.assertIn("huggingface_hub>=0.19.0,<1.0", requirements)
 
 
 if __name__ == "__main__":

tests/test_install_requirements.py

@@ -33,10 +33,10 @@ class InstallRequirementTests(unittest.TestCase):
             {info["pip"] for info in missing},
         )
 
-    def test_numpy_2_is_marked_for_downgrade(self):
+    def test_numpy_1_is_marked_for_upgrade(self):
         def version_for_package(_venv_py, distribution_name):
             if distribution_name == "numpy":
-                return "2.2.6"
+                return "1.26.4"
             if distribution_name == "audio-separator":
                 return "0.44.1"
             return None
@@ -48,9 +48,9 @@ class InstallRequirementTests(unittest.TestCase):
         ), contextlib.redirect_stdout(io.StringIO()):
             missing = install.check_all("python")
 
-        self.assertIn("numpy<2,>=1.23.0", {info["pip"] for info in missing})
+        self.assertIn("numpy>=2,<3", {info["pip"] for info in missing})
 
-    def test_audio_separator_install_restores_numpy_1_x(self):
+    def test_audio_separator_install_keeps_declared_numpy_2_stack(self):
         audio_separator_info = install.PACKAGES["audio_separator"]
         calls = []
 
@@ -67,9 +67,15 @@ class InstallRequirementTests(unittest.TestCase):
             ok = install.install_all("python", gpu=False)
 
         self.assertTrue(ok)
-        self.assertEqual(calls[0][0], "audio-separator")
-        self.assertEqual(calls[0][1]["version_spec"], ">=0.44.1")
-        self.assertIn(("numpy<2,>=1.23.0", {}), calls)
+        self.assertEqual(
+            calls,
+            [
+                (
+                    "audio-separator",
+                    {"extra": "cpu", "version_spec": ">=0.44.1"},
+                )
+            ],
+        )
 
     def test_cuda_13_uses_latest_supported_pytorch_wheel(self):
         def fake_run(cmd, **_kwargs):

ui/app.py

@@ -1221,7 +1221,7 @@ div[data-testid="dropdown"] svg,
     color: #9e9e9e !important;
 }
 
-/* Gradio 3.x 特定选择器样式 */
+/* Gradio 3/4 selector compatibility */
 .wrap.svelte-1m1zvyj,
 .wrap-inner.svelte-1m1zvyj,
 .secondary-wrap.svelte-1m1zvyj {