FunClip

环境要求

• Python 3.12（README 示例使用 python3.12）
• 与平台匹配的 PyTorch / torchaudio 组合（需在装其余依赖前先装好）
• git（用于克隆仓库）
• funasr>=1.4.9（FunClip 当前模型与字幕兼容路径要求）
• ImageMagick 仅可选，标准字幕剪辑已不再需要

安装与启动步骤

1. 1克隆仓库

   把 FunClip 源码拉到本地，随后所有命令都在该目录内执行。

   git clone https://github.com/modelscope/FunClip.git
   cd FunClip

   复制

2. 2创建虚拟环境

   为 FunClip 单独建一个 Python 3.12 虚拟环境，避免污染系统环境；Windows 激活方式见官方安装文档。

   python3.12 -m venv .venv

   复制

3. 3激活虚拟环境

   Linux/macOS 下激活刚建好的环境，之后所有 pip 与启动命令都在此环境内执行。

   . .venv/bin/activate

   复制

4. 4安装依赖

   安装 requirements.txt 中的全部依赖。注意本环境保持 Transformers 4.x，不要换成 Nano 的 Transformers 5.x。

   python -m pip install -r requirements.txt

   复制

5. 5检查依赖完整性

   用 pip check 确认依赖之间存在版本冲突，有报错先解决再启动。

   python -m pip check

   复制

6. 6确认启动脚本可用

   查看启动脚本帮助信息，能正常打印说明即表示 Python 环境已就绪。

   python funclip/launch.py --help

   复制

7. 7启动 Gradio 服务

   默认使用 Paraformer 处理中文视频；首次启动会自动下载模型权重，等待下载完成后再访问网页界面。

   python funclip/launch.py

   复制

关键配置

如何确认成功

执行 python funclip/launch.py --help 能正常打印帮助信息即环境就绪；启动服务后浏览器打开终端输出的本地地址即可看到 Gradio 界面。

常见问题

注意事项

• 务必为 FunClip 使用独立的 Python 环境，不要装进系统全局环境。
• 要提前安装与自身平台匹配的 PyTorch / torchaudio，再安装 requirements.txt 中的其余依赖。
• 首次启动会下载模型权重，耗时较长，请保持网络通畅。
• 若需要版本化快照，可下载 FunClip-2.2.1.tar.gz 或 zip，并用官方 SHA256SUMS 校验。