Huggingface Hub

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

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

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

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

инфо

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

Обсуждения и пул-реквесты (hf discussions)

  • Полный цикл работы с Hub-контрибуциями: list, create, info, comment, close, reopen, rename.
  • diff: просмотр изменений в PR.
  • merge: слияние пул-реквестов.

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

  • 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: управление навыками AI-ассистента через hf skills add.
ESC