Download Model

Цель: загрузить модель из Hugging Face в локальное хранилище, не помещая веса модели в git.

Install Dependencies

pip install -r requirements.txt

Dry Run

python scripts/download_hf_model.py qwen3-4b-instruct-2507 --dry-run

Download

На хосте, где доступен путь /models:

python scripts/download_hf_model.py qwen3-4b-instruct-2507

Если команда запускается на Windows, а в model card указан Linux-путь /models/..., реальная загрузка без --local-dir будет остановлена. Это защита от случайной загрузки в неправильный локальный каталог.

Для закрытой модели токен передается через окружение:

$env:HF_TOKEN="..."
python scripts/download_hf_model.py qwen3-4b-instruct-2507

Не сохраняйте токен в репозитории, .env или model card.

Resume Large Files

Если сеть рвет большие файлы, используйте range-загрузчик. Он докачивает файл с текущего размера и проверяет итоговый размер по Hugging Face metadata.

python scripts/download_hf_range.py qwen3-4b-instruct-2507 `
  --local-dir models/base/qwen3-4b-instruct-2507 `
  --allow-file model-00001-of-00003.safetensors `
  --allow-file model-00002-of-00003.safetensors `
  --chunk-size 16mb `
  --retries 20

Эту команду можно запускать повторно до полного завершения.

Override Path

Если нужно скачать в другой каталог:

python scripts/download_hf_model.py qwen3-4b-instruct-2507 --local-dir D:\models\base\qwen3-4b-instruct-2507

Registry Index

После добавления или изменения карточек моделей:

python scripts/build_model_index.py

Check Local Storage

Проверить, какие модели полностью скачаны, частично скачаны или отсутствуют:

python scripts/check_model_storage.py --print

В обычном check_all эта проверка работает как warning, потому что часть моделей и адаптеров может быть запланирована, но еще не загружена.

Для текущего состояния всей платформы:

python scripts/collect_platform_status.py --print

2.7 KiB Raw Blame History Unescape Escape