#3001 ModuleNotFoundError: No module named 'tools'

5.151* Posted at: 17 days ago 👁63

Traceback (most recent call last):
File "videotrans\component\realtime_stt.py", line 397, in toggle_transcription
File "videotrans\component\realtime_stt.py", line 364, in check_model_exist
ModuleNotFoundError: No module named 'tools'


=
system:Windows-10-10.0.19045-SP0
version:v3.96
frozen:True
language:zh
root_dir:D:/chrome下载/win-pyvideotrans-v3.96

7 Replies

这是由于预打包版软件在解压或运行时,部分依赖模块未能正确加载或路径异常导致的。

解决方案:

  1. 完全关闭 pyVideoTrans 软件。
  2. 检查软件根目录 D:/chrome下载/win-pyvideotrans-v3.96 下是否存在 tools 文件夹。如果不存在,说明软件包可能不完整或解压有误。
  3. 重新下载完整的 .7z 压缩包(非补丁包),并使用 7-ZipBandizip 等工具,将其完整解压到一个全新的、路径中不含中文和空格的目录,例如 D:\pyVideoTrans
  4. 解压后,不要在压缩软件中直接双击运行,也不要从旧目录启动。直接进入新的解压目录(如 D:\pyVideoTrans),双击 sp.exe 启动。

关键注意事项:

  • 路径规范:确保软件运行路径(如 D:\pyVideoTrans绝对不包含中文、空格或特殊字符。你当前的路径 D:/chrome下载/ 包含中文“下载”,这可能导致模块加载失败。
  • 权限:不要将软件解压到 C:\Program Files 等需要管理员权限的系统目录。

请查阅相关文档:

win-pyvideotrans-v3.96压缩包内并不包含tools文件夹

这是由于预打包版软件包结构不完整或版本打包问题导致的。tools 模块是软件运行的必要组件,其缺失会导致实时语音转录等功能无法使用。

解决方案:

  1. 重新下载完整包:前往官方下载页面,确认下载的是 完整版 压缩包(通常文件名会标注“完整版”或文件较大),而非“补丁包”。
  2. 彻底清理并重新安装

    • 关闭所有 pyVideoTrans 相关进程。
    • 将当前有问题的整个文件夹 D:/chrome下载/win-pyvideotrans-v3.96 完全删除。
    • 将新下载的完整版 .7z 压缩包,使用 7-Zip 或 Bandizip 等工具,解压到一个全新的、路径中不含中文和空格的目录,例如 D:\pyVideoTrans
    • 绝对不要在压缩软件内直接运行,也不要从包含中文的路径(如“下载”)启动。
  3. 验证安装:解压后,检查新目录(如 D:\pyVideoTrans)下是否包含 sp.exemodelsffmpegvideotrans 以及 tools 等文件夹。确认无误后,双击 sp.exe 启动。

如果重新下载完整版并规范安装后问题依旧,可能是该版本打包存在已知缺陷,请关注官方更新或论坛公告。

请查阅相关文档:

tools文件夹应包含哪些文件

根据现有文档无法确定具体原因。请提供软件安装目录下的 logs/ 文件夹中最新的日志文件(复制底部约30行报错信息)以便分析。


Application started at 2026-01-31 02:44:54

[DEBUG] 平台: Windows。正在按优先级检测最佳的 'h264' 编码器: ['nvenc', 'qsv', 'amf']
First searching GPU...
Found 0 GPUs, cost=5s
start workers...
NVIDIA_GPU_NUMS=0
[DEBUG] CUDA 不可用,跳过 nvenc 测试。
Concurrent task_nums=1
process_max=0
��试编码器是否可用: h264_qsv...
start 8 jobs
ended workers
!!! UNHANDLED EXCEPTION !!!
Traceback (most recent call last):
File "videotrans\component\realtime_stt.py", line 397, in toggle_transcription
File "videotrans\component\realtime_stt.py", line 364, in check_model_exist
ModuleNotFoundError: No module named 'tools'

[DEBUG] 硬件编码器 'h264_qsv' 不可用
[DEBUG] 正在测试编码器是否可用: h264_amf...
[DEBUG] 硬件编码器 'h264_amf' 可用。
[DEBUG] 已选择硬件编码器: h264_amf
[DEBUG] 最终确定使用的编码器: h264_amf
[DEBUG] 平台: Windows。正在按优先级检测最佳的 'hevc' 编码器: ['nvenc', 'qsv', 'amf']
[DEBUG] CUDA 不可用,跳过 nvenc 测试。
[DEBUG] 正在测试编码器是否可用: hevc_qsv...
[DEBUG] 硬件编码器 'hevc_qsv' 不可用
[DEBUG] 正在测试编码器是否可用: hevc_amf...
[DEBUG] 硬件编码器 'hevc_amf' 可用。
[DEBUG] 已选择硬件编码器: hevc_amf
[DEBUG] 最终确定使用的编码器: hevc_amf

这是由于软件在启动时加载实时语音转录(Realtime STT)功能所依赖的 tools 模块缺失导致的。该模块是软件源码的一部分,但在您使用的预打包版(.exe)中可能因打包问题被遗漏。

解决方案:

  1. 临时禁用实时转录功能:启动软件后,在主界面不要点击“实时语音转文字”按钮。该功能非视频翻译核心流程所必需,禁用后可正常使用其他所有功能。
  2. 等待官方修复或更新:此问题可能源于 v3.96 版本打包时的疏漏。请关注官方发布渠道(如GitHub releases或官网),等待后续版本更新。
  3. 作为备选方案,使用源码部署:如果您急需使用实时转录功能,可考虑按照官方指南进行源码部署,这能确保获得完整的文件结构。

关键分析:
从日志看,软件主体(编码器检测等)已正常启动。报错仅发生在尝试使用“实时语音转文字”功能时。因此,只要不触发该功能,软件的视频翻译、语音识别、配音等核心功能应可正常使用。

请查阅相关文档:

Post Your Reply
Open source and free maintenance is not easy. If this project is helpful to you, please consider making a small donation to help the project continue to maintain and update.

Related resource