Перейти к содержанию

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

Метаданные навыка​
Источник Встроенный (устанавливается по умолчанию)
Путь skills/mlops/huggingface-hub
Версия 1.0.0
Автор Hugging Face
Лицензия MIT

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

info Ниже приведено полное определение навыка, которое загружает Hermes при активации этого навыка. Это те инструкции, которые видит агент, когда навык активен.

Справочное руководство по 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 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 (список parquet-URL).
  • SQL-запросы: hf datasets sql SQL — Выполнение сырых SQL-запросов через DuckDB к parquet-URL наборов данных.
  • Модели: hf models list и info.
  • Статьи: hf papers list — Просмотр ежедневных статей.

Обсуждения и 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-файлов без полных перезапусков.

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

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

Продвинутое использование и советы​

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

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

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