Skip to content

README.md

Latest commit

 

History

History
25 lines (18 loc) · 1.13 KB

README.md

File metadata and controls

25 lines (18 loc) · 1.13 KB

GGUF Model Downloader

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.

🚀 Features

  • 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 .mmproj files 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 .env file integration for Hugging Face tokens to access gated/private repositories.
  • Organized Storage: Automatically creates a clean directory structure: ./Owner/ModelName/.

🛠 Prerequisites

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