HF Loader

Русский

HF Loader - это настольное Windows-приложение для скачивания моделей и датасетов с Hugging Face без git lfs и консольных команд.

Возможности

• Скачивание публичных, приватных и gated-репозиториев Hugging Face.
• Поддержка моделей и датасетов.
• Ввод репозитория в формате owner/name или полной ссылки Hugging Face.
• Автоопределение dataset для ссылок вида https://huggingface.co/datasets/....
• Выбор папки загрузки.
• Поддержка Hugging Face token для закрытых репозиториев.
• Фильтры разрешённых и исключённых файлов.
• Интерфейс на русском и английском языках.
• Загрузка в фоне без зависания окна.
• Прогресс по количеству скачанных файлов.

Установка для разработки

Рекомендуется Python 3.14. Минимальная версия в проекте оставлена >=3.11, потому что GUI- и packaging-библиотеки могут обновляться с задержкой.

py -3.14 -m venv .venv
.\.venv\Scripts\Activate.ps1
python -m pip install --upgrade pip
python -m pip install -e .[build]
python -m hf_loader

Если зависимости для Python 3.14 недоступны, можно использовать Python 3.11:

py -3.11 -m venv .venv

Сборка EXE для Windows

.\scripts\build_windows.ps1

Готовое приложение появится в папке dist\HF Loader.

Сборочные папки build*, dist*, локальные загрузки и архивы релизов не нужно коммитить в Git. Для GitHub Release лучше прикладывать zip-архив собранного приложения как asset.

English

HF Loader is a Windows desktop app for downloading Hugging Face models and datasets without using git lfs or terminal commands.

Features

• Download public, private, and gated Hugging Face repositories.
• Support model and dataset repositories.
• Enter repositories as owner/name or as full Hugging Face URLs.
• Automatically detect dataset for https://huggingface.co/datasets/... URLs.
• Choose a local download folder.
• Use a Hugging Face token for private or gated repositories.
• Filter files with allow and ignore patterns.
• Switch the UI between Russian and English.
• Keep downloads running in the background without freezing the window.
• Show progress by downloaded file count.

Development Setup

Python 3.14 is recommended. The project keeps >=3.11 as the minimum because GUI and packaging libraries may lag behind the newest Python release.

py -3.14 -m venv .venv
.\.venv\Scripts\Activate.ps1
python -m pip install --upgrade pip
python -m pip install -e .[build]
python -m hf_loader

If Python 3.14 dependencies are not available, use Python 3.11:

py -3.11 -m venv .venv

Build Windows EXE

.\scripts\build_windows.ps1

The built app will be placed under dist\HF Loader.

Do not commit build*, dist*, local downloads, or release archives to Git. For GitHub Releases, attach a zip archive of the built app as a release asset.