Hugging Face CLI

Hugging Face CLI — официальный командный интерфейс к Hugging Face Hub. Навык нужен, когда требуется работать с моделями, датасетами, Spaces, репозиториями, Buckets, коллекциями, обсуждениями, papers, Jobs, Sandboxes или Inference Endpoints из терминала. Команда hf заменила устаревшую huggingface-cli; после установки состояние окружения и версию можно проверить через hf env и hf version, а полный список возможностей — через hf --help. Источник также описывает установку официальным скриптом Hugging Face и рекомендует использовать HF_TOKEN или штатную группу hf auth для доступа. В базовом сценарии hf download получает файлы из репозитория модели, датасета или Space. Для него можно выбрать тип репозитория, ревизию, include/exclude-фильтры, локальный кэш или каталог назначения, dry-run, принудительную загрузку, число рабочих потоков и машиночитаемый формат вывода. Обратная операция hf upload отправляет файл или каталог в Hub, поддерживает тип репозитория, ревизию, приватность, фильтры, удаление путей, сообщение и описание коммита, pull request и периодическую отправку. В документации отдельно отмечено, что upload-large-folder устарел и для больших загрузок следует ориентироваться на обычный hf upload. Команда hf cp переносит файлы между локальным окружением, репозиториями и Buckets, а hf sync синхронизирует локальный каталог с Bucket с планом, dry-run и фильтрами. Доступом управляет группа hf auth: можно войти, узнать текущую учётную запись, перечислить сохранённые токены, выбрать другой токен или выйти из конкретного токена. Локальный кэш имеет отдельные команды list, prune, rm и verify: они помогают увидеть ревизии, удалить отсоединённые или неполные данные, очистить выбранные записи и проверить контрольные суммы конкретного репозитория. Для интеграций предусмотрены форматы auto, human, agent, json и quiet, поэтому результат можно читать человеку или передавать следующему шагу скрипта. Навык охватывает управление репозиториями: создание, информацию, ветки, теги, файлы, перемещение, дублирование и pull request. Группа hf discussions позволяет просматривать обсуждения, читать diff, создавать, комментировать, закрывать, переоткрывать и сливать pull request. Для моделей, датасетов и Spaces есть команды списка, карточки, информации и дерева файлов; у датасетов добавлены parquet-ссылки, SQL через DuckDB и просмотр leaderboard, у Spaces — профиль, hardware, dev mode, hot reload, secrets, переменные окружения и логи. Через hf papers можно искать, просматривать и читать академические материалы, а hf collections — создавать коллекции и управлять их элементами. Отдельный блок предназначен для вычислений и публикации: hf jobs запускает, инспектирует, отменяет, ожидает и показывает логи задач, поддерживает labels, hardware, detach и расписания; hf Sandboxes даёт изолированное окружение для команд, фоновых процессов и файлов. Группа hf endpoints управляет Inference Endpoints: каталогом моделей, развёртыванием, описанием, списком, паузой, возобновлением, масштабированием до нуля и конфигурацией. Эти действия зависят от прав, namespace, ревизии, типа репозитория, hardware и параметров конкретного ресурса. Удаление Buckets, файлов, репозиториев, webhook и endpoint — не безобидная операция: источник предусматривает подтверждение или специальные флаги. Навык предоставляет единый интерфейс Hub, но не заменяет авторизацию, проверку цели и справку установленной версии CLI.