Amuse AI: download gated Hugging Face models
Learn to configure a Hugging Face token in Amuse AI, accept model agreements, and troubleshoot downloads that report "Query file headers returned 0 bytes."
Player not loading? Watch on YouTube
This tutorial explains how to download gated Hugging Face models through Amuse AI for image, video and audio generation on your computer. The speaker identifies the yellow lock icon as a sign of restricted access and describes "Query file headers returned 0 bytes" as one indication that Amuse cannot access the model.
The setup starts in Hugging Face's access-token settings. The speaker creates a token with read access to the contents of public gated repositories the account can access, then copies it into Amuse AI under Settings > General > Access tokens and saves the changes. After selecting a model and clicking Load, download progress appears under Settings > Downloads. The speaker also warns against sharing the token publicly.
A token alone may not resolve the download. The tutorial shows how to open the model's Hugging Face link through Amuse's diffusion settings and accept its license and access conditions. The speaker recommends restarting Amuse and trying Load again afterward.
If the download still fails, the speaker suggests checking the repository for the exact quantized version Amuse uses. A smaller variant may require its own agreement, even when the account has accepted the original model's conditions. The walkthrough focuses on access permissions needed to run models locally; it does not establish that these steps resolve every download error.