Questions

Docs · Questions

StreamDiffusionTDError

Why can't I connect to HuggingFace or get "safety checker" errors when loading models?

HuggingFace Connection & Safety Checker Errors

Common Error Messages

OSError: We couldn't connect to 'https://huggingface.co' to load this file, 
couldn't find it in the cached files and it looks like CompVis/stable-diffusion-safety-checker 
is not the path to a directory containing a file named config.json.

OR

module 'huggingface_hub.utils' has no attribute '_errors'

Historical Context

v0.2.0 Era (Aug-Sep 2024) - Common Issue

This was a widespread problem in v0.2.0-v0.2.2 caused by HuggingFace library version mismatches.

Fixed in v0.2.3 (Oct 8, 2024): Updated HuggingFace library handling to resolve the issue.

v0.3.0 (Nov 2025) - Issue Returned

The problem has resurfaced in v0.3.0 experimental local installation.

Status: Developer (dotsimulate) is aware and working on a fix for v0.3.0.

Solutions (Depends on Version)

For v0.2.0-v0.2.2 (Legacy)

Update to v0.2.3 or later - the issue is fixed in newer versions.

For v0.3.0 Current Users

Wait for upcoming patch. In the meantime:

  1. Check Firewall/Antivirus

    • Ensure HuggingFace.co isn’t blocked
    • Temporarily disable firewall to test
    • Add exception for Python/StreamDiffusion
  2. Ensure Internet Connection on First Load

    • Models need to download config files on first use
    • After first successful load, they work offline
    • Error occurs when trying to run offline before caching configs
  3. Try Different Model Format

    • Use local .safetensors file instead of HuggingFace ID
    • Download model completely outside the operator
    • Point to full file path

General Troubleshooting

If you haven’t run the model successfully before:

  • You MUST have internet access for first-time model initialization
  • Config files (~1-5KB) need to download even for local models
  • After first successful run, the model works offline

If it worked before and stopped:

  • Check if HuggingFace changed authentication requirements
  • Clear HuggingFace cache: C:\Users\<username>\.cache\huggingface\
  • Try re-downloading model to fresh location

When to Wait vs. When to Act

v0.2.0-v0.2.2: Action required - update your TOX v0.3.0: Wait for patch OR use workarounds above


Version History:

  • v0.2.0 (Aug 2024): Issue widespread
  • v0.2.3 (Oct 2024): Fixed huggingface_hub.utils._errors issue
  • v0.3.0 (Nov 2025): Issue returned in experimental local installation (fix coming)

Note: This is primarily an installation/first-run issue. Once models load successfully once, they work reliably offline.