pyVideoTrans

English

简体中文

English

简体中文

Appearance

Explanation and Solution 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. 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.

What Does This Error 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, due to your network being unable to connect smoothly to the model server (Hugging Face), or the download was interrupted midway, the model failed to download successfully.

  2. Step 2: No model found when switching to offline mode. When the faster-whisper library detects a network download failure, it automatically tries to find the model in 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 short: Poor network causes model download failure, and the failure means no model is available locally.

How to Solve This Problem? ​

The core idea is: Ensure the model can be completely downloaded 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 method.

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

  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 clears incomplete or corrupted download files.

  1. Rerun the Program: After disabling 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 Specialized Download Tool to Manually Download Models ​

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

  1. Download the Tool:

    • For Users in Mainland China (Recommended):

    • For Overseas Users or Those with a Stable Proxy:

      • Click to download down_huggingface.exe
      • (Note: This version downloads from the Hugging Face official website and 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 (in the same location as sp.exe).
    • Double-click 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 in size. 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, just double-click the same .exe file again. It supports resuming interrupted downloads and will continue from where it left off.

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