#5249 为什么下载解压了文档提供的f5-tts后，双击“启动webui.bat"就只有这些。

13.229* Posted at: 15 hours ago

Active code page: 65001

开始启动,用时可能较久，请耐心等待...

检测模型是否下载,若未下载，将从 hf-mirror.com 下载...
Failed to canonicalize script path
Press any key to continue . . .
另一个.bat文件
使用的win10 ltsc，本地的qwen moss和整合包的omnivoice都可以使用，科学上网已挂。

3 Replies

Floor #1 DeepSeek reply at 15 hours ago

Failed to canonicalize script path 通常是因为 f5-tts 的启动脚本所在路径包含中文、空格、特殊符号（例如“下载”“新建文件夹”等），或者路径过长、权限不足，导致脚本无法正确解析自身位置。

解决办法（按顺序尝试）：

检查并修改路径：将 f5-tts 文件夹移动到纯英文且无空格的目录下，例如 D:\f5-tts。不要放在桌面、下载文件夹或带有空格的路径中。
以管理员身份运行：右键点击“启动webui.bat”，选择“以管理员身份运行”。
手动切换至正确目录后再启动：打开命令提示符（CMD），执行：
```
cd /d D:\f5-tts
启动webui.bat
```
替换为你的实际路径。
检查 Python 环境：f5-tts 依赖 Python 和特定虚拟环境。如果之前解压到其他目录又移动过，可能导致路径硬编码失效。建议彻底删除解压后的文件夹，重新解压到纯英文路径，再双击启动。
改用启动api.bat（如果存在）：f5-tts 通常提供两个启动脚本，webui 和 api。api 模式更适合与 pyVideoTrans 集成。启动 api.bat 后，将 API 地址填入软件菜单 → TTS设置 → F5TTS 配置中。

若以上步骤仍无效，请提供 logs/ 目录下或 CMD 窗口中的完整报错信息（约底部30行），以便进一步分析。

Floor #2 13.229* reply at 14 hours ago

折腾好了，好像是：正确的启动命令
经过验证，这个整合包的正确启动方式是：

batch
uv run python -m f5_tts.infer.infer_gradio
你可以把这个命令记下来，以后直接使用。也可以修改启动webui.bat 文件，把最后一行：

batch
call uv run f5-tts_infer-gradio
改成：

batch
call uv run python -m f5_tts.infer.infer_gradio
这样以后双击启动webui.bat 就能直接启动了。

Floor #3 DeepSeek reply at 14 hours ago

好的，问题已解决。
关键点总结：f5-tts 整合包的正确启动命令是 uv run python -m f5_tts.infer.infer_gradio。修改 启动webui.bat 中最后一行即可。

建议启动后，在 pyVideoTrans 的 菜单 → TTS设置 → F5TTS 中填写正确的 API 地址（默认 http://127.0.0.1:7860），并将参考音频放入软件目录下的 f5-tts/ 文件夹内。

若后续出现端口占用或模型加载失败，请检查控制台输出具体错误。