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:
-
Check Firewall/Antivirus
- Ensure HuggingFace.co isn’t blocked
- Temporarily disable firewall to test
- Add exception for Python/StreamDiffusion
-
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
-
Try Different Model Format
- Use local
.safetensorsfile instead of HuggingFace ID - Download model completely outside the operator
- Point to full file path
- Use local
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._errorsissue - 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.