A robust Bash utility designed to fetch GGUF models from Hugging Face with surgical precision. It automatically handles sharded collections, vision projectors (mmproj), and authentication for gated models.
- Recursive Search: Finds GGUF files even if they are buried in subdirectories.
- Shard Detection: Select one part of a multi-part model (e.g.,
00001-of-00007), and the script automatically grabs the entire set. - Vision Support: Automatically detects and downloads associated
.mmprojfiles if a GGUF is successfully acquired. - Smart Skip: Compares remote and local file sizes to skip already-downloaded files, saving time and bandwidth.
- Authentication: Supports
.envfile integration for Hugging Face tokens to access gated/private repositories. - Organized Storage: Automatically creates a clean directory structure:
./Owner/ModelName/.
Ensure you have the following installed:
- curl: For handling downloads.
- jq: For parsing Hugging Face API responses.
# Ubuntu/Debian
sudo apt install curl jq
# MacOS
brew install curl jq