Перейти к основному содержимому

Huggingface Hub

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

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

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

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

к сведению

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

Справочное руководство по 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: Синхронизация файлов между локальной директорией и bucket.
  • 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-файлов без полных перезапусков.

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

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

Расширенное использование и советы​

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

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

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

  • Расширения: Расширение функциональности CLI через репозитории GitHub с помощью hf extensions install REPO_ID.
  • Навыки: Управление навыками AI-ассистента с помощью hf skills add.