Skip to content

FunASR-powered video transcription, subtitle generation, and LLM-assisted clipping tool with a local Gradio UI.

docs: require current FunASR for model modes

zhifu gao39afd187a639
diff --git a/README.md b/README.md
index 86bd1c7..bc9a02f 100644
--- a/README.md
+++ b/README.md
@@ -74,6 +74,8 @@ cd FunClip
pip install -r ./requirements.txt
```
+FunClip's Fun-ASR-Nano, SenseVoice, and subtitle compatibility paths require `funasr>=1.3.19`. If you installed FunClip before this requirement was updated, run `pip install -U "funasr>=1.3.19"` before starting the Gradio service.
+
### imagemagick install (Optional)
If you want to clip video file with embedded subtitles
diff --git a/README_zh.md b/README_zh.md
index f93d7dc..4e15571 100644
--- a/README_zh.md
+++ b/README_zh.md
@@ -75,6 +75,8 @@ cd FunClip
pip install -r ./requirements.txt
```
+FunClip 的 Fun-ASR-Nano、SenseVoice 与字幕兼容路径需要 `funasr>=1.3.19`。如果你之前已经安装过 FunClip,请先执行 `pip install -U "funasr>=1.3.19"`,再启动 Gradio 服务。
+
### 安装imagemagick(可选)
1. 如果你希望使用自动生成字幕的视频裁剪功能,需要安装imagemagick
diff --git a/requirements.txt b/requirements.txt
index 8fc2625..c1c751e 100644
--- a/requirements.txt
+++ b/requirements.txt
@@ -1,7 +1,7 @@
librosa
soundfile
scikit-learn>=1.3.2
-funasr>=1.1.2
+funasr>=1.3.19
transformers>=4.32.0,<5.0
huggingface_hub>=0.19.3,<1.0
moviepy==1.0.3
diff --git a/tests/test_funasr_requirement.py b/tests/test_funasr_requirement.py
new file mode 100644
index 0000000..237f03c
--- /dev/null
+++ b/tests/test_funasr_requirement.py
@@ -0,0 +1,16 @@
+from pathlib import Path
+
+
+ROOT = Path(__file__).resolve().parents[1]
+
+
+def test_funasr_minimum_version_matches_current_model_paths():
+ requirements = (ROOT / "requirements.txt").read_text()
+ assert "funasr>=1.3.19" in requirements
+ assert "funasr>=1.1.2" not in requirements
+
+
+def test_readmes_explain_upgrade_for_existing_installs():
+ for readme in ["README.md", "README_zh.md"]:
+ text = (ROOT / readme).read_text()
+ assert 'pip install -U "funasr>=1.3.19"' in text