pyVideoTrans

Appearance

Explanation and Solutions for the Cannot find an appropriate cached snapshot folder for the specified revision... Error ​

When running pyVideoTrans software in faster-whisper mode, you may frequently encounter the following complex-looking error. Please don't worry.

This is usually not a software bug, but a common network issue.

Traceback (most recent call last):
  File "videotrans\task\_only_one.py", line 43, in run
  File "videotrans\task\trans_create.py", line 371, in recogn
  File "videotrans\recognition\__init__.py", line 236, in run
  File "videotrans\recognition\_base.py", line 75, in run
  File "videotrans\recognition\_overall.py", line 155, in _exec
RuntimeError: err[msg]=Cannot find an appropriate cached snapshot folder for the specified revision on the local disk and outgoing traffic has been disabled. To enable repo look-ups and downloads online, pass 'local_files_only=False' as input.

1. What does this error actually mean? ​

Simply put, this error is like a two-step chain reaction:

  1. Step 1: Model download failed. The program needs to download the "faster-whisper" model from the internet to work. However, because your network cannot connect smoothly to the model server (Hugging Face), or the download was interrupted midway, the model failed to download successfully.

  2. Step 2: Model not found after switching to offline mode. When the faster-whisper library detects a network download failure, it tries to find the model from your computer's local folder (this is called "offline mode"). But since the download failed in Step 1, your computer naturally has nothing, so it reports "Cannot find the model locally," ultimately causing the error you see.

In a nutshell: Poor network causes model download failure, and download failure means no model is available locally.

2. How to solve this problem? ​

The core idea is: Ensure the model can be downloaded completely to your computer. Here are two simple and effective solutions for you.

The program has built-in channels to download from domestic mirror sites, which is usually the fastest and most stable way.

  1. Disconnect proxy/VPN: If you are using any form of system proxy or VPN, please turn it off first. Because VPNs can be unstable and may disconnect during the long download of large models, causing failure.

  2. Delete failed cache files:

    • Find the program's main folder (the folder where sp.exe is located).
    • Go into the models folder inside it.
    • Find and delete the folders related to the model you tried to download (e.g., folders like models--Systran--faster-whisper-largexxx). This step is to clear incomplete or corrupted download files.

  1. Rerun the program: After closing the proxy and clearing the cache, restart the main program. It should now be able to smoothly download the model from the domestic mirror server.

Solution 2: Use a dedicated download tool to manually download the model ​

If Solution 1 doesn't work, or if your network environment is special, we have prepared a dedicated model download tool for you. You can download all models at once (8 models for faster-whisper) like downloading regular software, and then run the main program.

  1. Download the tool:

    • For users in Mainland China (Recommended):

    • For overseas users or users with a stable proxy:

      • Click to download down_huggingface.exe
      • (Note: This version downloads from the Hugging Face official website. It requires stable access to the international internet or a configured system proxy.)

  2. How to use:

    • Place the downloaded .exe file in the main program's folder (together with sp.exe).
    • Double-click to run the .exe file you downloaded. It will open a command-line window and automatically start downloading all required models.
    • The download process may take some time, especially for the large series models which are very large files. Please wait patiently until the window indicates completion.

Important Notes:

  • Models like large-v1, large-v2, large-v3 are very large (several GB). If your network is unstable, the download may fail midway.
  • If the download fails, don't worry, simply double-click and run the same .exe file again. It supports resumable downloads and will continue from where it left off.

Once all models are successfully downloaded to the models folder via either method above, run the main program again, and the problem should be solved!