Huggingface Hub

HuggingFace hf CLI: поиск, загрузка и выгрузка моделей и датасетов.

Метаданные навыка

Справочник: полный SKILL.md

Справочник по Hugging Face CLI (hf)

Команда hf — современный интерфейс командной строки для работы с Hugging Face Hub: с её помощью управляют репозиториями, моделями, датасетами и Spaces.

ВАЖНО: команда hf заменяет собой устаревшую huggingface-cli.

Быстрый старт

• Установка: curl -LsSf https://hf.co/cli/install.sh | bash -s
• Справка: команда hf --help покажет все доступные функции и примеры их использования.
• Аутентификация: рекомендуется через переменную окружения HF_TOKEN или флаг --token.

---

Основные команды

Общие операции

• hf download REPO_ID: скачивает файлы с Hub.
• hf upload REPO_ID: загружает файлы и папки (рекомендуется для одиночного коммита; также умеет докачивать большие директории при обрыве).
• hf upload-large-folder REPO_ID LOCAL_PATH: [Устарела] — используйте вместо неё hf upload.
• hf sync: синхронизирует файлы между локальной директорией и бакетом.
• hf env / hf version: показывают сведения об окружении и версии.

Аутентификация (hf auth)

• login / logout: управление сессиями с помощью токенов с huggingface.co/settings/tokens.
• list / switch: управление несколькими сохранёнными токенами доступа и переключение между ними.
• whoami: показывает, под каким аккаунтом выполнен вход.

Управление репозиториями (hf repos)

• create / delete: создание или безвозвратное удаление репозиториев.
• duplicate: клонирует модель, датасет или Space под новым ID.
• move: переносит репозиторий между пространствами имён.
• branch / tag: управление git-подобными ссылками.
• delete-files: удаляет файлы по шаблону.

---

Специализированные операции с Hub

Датасеты и модели

• Датасеты: hf datasets list, info и parquet (список URL parquet-файлов).
• SQL-запросы: hf datasets sql SQL — выполняет произвольный SQL через DuckDB по URL parquet-файлов датасета.
• Модели: hf models list и info.
• Статьи: hf papers ls — показывает статьи дня.

Обсуждения и pull request’ы (hf discussions)

• Управление жизненным циклом вкладов в Hub: list, create, info, comment, close, reopen и rename.
• diff: показывает изменения в PR.
• merge: завершает pull request.

Инфраструктура и вычисления

• Endpoints: развёртывание и управление Inference Endpoints (deploy, pause, resume, scale-to-zero, catalog).
• Jobs: запуск вычислительных задач на инфраструктуре HF. Сюда входит hf jobs uv для запуска Python-скриптов с инлайн-зависимостями и stats для мониторинга ресурсов.
• Spaces: управление интерактивными приложениями. Включает dev-mode и hot-reload для Python-файлов без полного перезапуска.

Хранение и автоматизация

• Buckets: полноценное управление S3-подобными бакетами (create, cp, mv, rm, sync).
• Cache: управление локальным хранилищем: list, prune (удаление отсоединённых ревизий) и verify (проверка контрольных сумм).
• Webhooks: автоматизация процессов через управление вебхуками Hub (create, watch, enable/disable).
• Collections: организация объектов Hub в коллекции (add-item, update, list).

---

Дополнительные возможности и советы

Глобальные флаги

• --format json: выводит результат в машиночитаемом виде для автоматизации.
• -q / --quiet: ограничивает вывод только идентификаторами.

Расширения и навыки

• Extensions: расширяет возможности CLI через GitHub-репозитории командой hf extensions install REPO_ID.
• Skills: управление навыками ИИ-ассистента через hf skills add.