Hub Python Library documentation

Hub Python Library

You are viewing main version, which requires installation from source. If you'd like regular pip install, checkout the latest stable version (v2.4.0).

Join the Hugging Face community

and get access to the augmented documentation experience

Collaborate on models, datasets and Spaces

Faster examples with accelerated inference

Switch between documentation themes

to get started

hf

CLI Hugging Face Hub

Использование:

$ hf [OPTIONS] [COMMAND] [ARGS]...

Параметры:

--skills: Выводит hf-cli SKILL.md в стандартный поток вывода (псевдоним для hf skills preview).
--install-completion: Установить автодополнение для текущей оболочки.
--show-completion: Показывает автодополнение для текущей оболочки, чтобы скопировать его или настроить установку.
--help: Показать это сообщение и выйти.

Команды:

auth: управление аутентификацией (вход, выход и т. д.).
buckets: команды для работы с бакетами.
cache: управление локальным каталогом кэша.
collections: взаимодействие с коллекциями на Hub.
cp: Копирование файлов между локальными путями, репозиториями и хранилищами.
datasets: работа с наборами данных на Hub.
discussions: управление обсуждениями и pull request на Hub.
download: Загрузка файлов с Hub.
endpoints: управление Hugging Face Inference Endpoints.
env: Выводит информацию об окружении.
extensions: управление расширениями hf CLI. [alias: ext]
jobs: запуск и управление Jobs на Hub.
lfs-enable-largefiles: Настройте репозиторий для загрузки файлов размером более 5 ГБ.
lfs-multipart-upload: Внутренний собственный агент передачи git-lfs для многочастных загрузок.
models: взаимодействие с моделями на Hub.
papers: взаимодействие со статьями на Hub.
repos: управление репозиториями на Hub.
sandbox: Запуск и управление экспериментальными песочницами в Hugging Face Jobs.
skills: Управление навыками ИИ-ассистентов.
spaces: взаимодействие с пространствами на Hub.
sync: Синхронизация файлов между локальным каталогом и хранилищем.
update: обновите CLI hf до последней версии.
upload: Загрузить файл или папку в Hub.
version: выводит информацию о версии hf.
webhooks: Управление вебхуками на Hub.

hf auth

Управление аутентификацией (вход, выход и т. д.).

Использование:

$ hf auth [OPTIONS] COMMAND [ARGS]...

Параметры:

--help: Показать это сообщение и выйти.

Команды:

list: Список всех сохраненных токенов доступа. [alias: ls]
login: Войдите через браузер или с помощью токена из huggingface.co/settings/tokens.
logout: Выход с конкретного токена.
switch: Переключение между токенами доступа.
token: Вывести текущий токен доступа в стандартный поток вывода.
whoami: показывает, под какой учётной записью huggingface.co вы вошли.

hf auth list

Список всех сохраненных токенов доступа. [alias: ls]

Использование:

$ hf auth list [OPTIONS]

Параметры:

--help: Показать это сообщение и выйти.

Примеры $ hf auth list

Подробнее Для получения дополнительной информации о команде используйте hf <command> --help. Документация доступна по адресу https://huggingface.co/docs/huggingface_hub/en/guides/cli

hf auth login

Войдите через браузер или с помощью токена из huggingface.co/settings/tokens.

Использование:

$ hf auth login [OPTIONS]

Параметры:

--token TEXT: токен доступа пользователя, созданный на странице https://huggingface.co/settings/tokens.
--add-to-git-credential / --no-add-to-git-credential: Сохранить в git credential helper. Полезно только в том случае, если вы планируете выполнять команды git напрямую. [по умолчанию: no-add-to-git-credential]
--force / --no-force: Принудительный повторный вход, даже если пользователь уже вошёл в систему. [по умолчанию: no-force]
--help: Показать это сообщение и выйти.

Примеры $ hf auth login $ hf auth login —token $HF_TOKEN $ hf auth login —token $HF_TOKEN —add-to-git-credential $ hf auth login —force

hf auth logout

Выход с конкретного токена.

Использование:

$ hf auth logout [OPTIONS]

Параметры:

--token-name TEXT: Имя токена для выхода
--help: Показать это сообщение и выйти.

Примеры $ hf auth logout $ hf auth logout —token-name my-token

hf auth switch

Переключение между токенами доступа.

Использование:

$ hf auth switch [OPTIONS]

Параметры:

--token-name TEXT: Имя токена, на который нужно переключиться
--add-to-git-credential / --no-add-to-git-credential: Сохранить в git credential helper. Полезно только в том случае, если вы планируете выполнять команды git напрямую. [по умолчанию: no-add-to-git-credential]
--help: Показать это сообщение и выйти.

Примеры $ hf auth switch $ hf auth switch —token-name my-token

hf auth token

Вывести текущий токен доступа в стандартный поток вывода.

Использование:

$ hf auth token [OPTIONS]

Параметры:

--help: Показать это сообщение и выйти.

Примеры $ hf auth token $ hf auth token | xargs curl -H ‘Authorization: Bearer {}’

hf auth whoami

Узнайте, под какой учётной записью huggingface.co вы вошли.

Использование:

$ hf auth whoami [OPTIONS]

Параметры:

--help: Показать это сообщение и выйти.

Примеры $ hf auth whoami $ hf auth whoami —format json

hf buckets

Команды для взаимодействия с бакетами.

Использование:

$ hf buckets [OPTIONS] COMMAND [ARGS]...

Параметры:

--help: Показать это сообщение и выйти.

Команды:

cp: Копирование файлов между локальными путями, репозиториями и хранилищами.
create: Создать новое хранилище.
delete: Удалить бакет.
info: получить информацию о бакете.
list: Список корзин или файлов в корзине. [псевдоним: ls]
move: Переместить (переименовать) бакет в новое имя или пространство имён.
remove: Удаляет файлы из хранилища. [псевдоним: rm]
settings: обновление настроек хранилища (видимость).
sync: Синхронизация файлов между локальным каталогом и хранилищем.

hf buckets cp

Копирование файлов между локальными путями, репозиториями и хранилищами.

Обрабатывает загрузку (локально/stdin -> репозиторий/бакет), скачивание (репозиторий/бакет -> локально/stdout) и копирование между удалёнными хранилищами (репозиторий/бакет -> репозиторий/бакет). Копирование из бакета в репозиторий и локальное копирование не поддерживаются. Для каталогов используйте hf upload/hf download (репозитории) или hf buckets sync (бакеты). Копирование между удалёнными хранилищами работает только в пределах одного региона хранения (https://huggingface.co/docs/hub/storage-regions).

Использование:

$ hf buckets cp [OPTIONS] SRC [DST]

Аргументы:

SRC: Источник: локальный файл, URI hf:// (репозиторий или бакет) или - для стандартного ввода. [обязательный]
[DST]: Назначение: локальный путь, URI hf:// (репозиторий или бакет) или - для stdout.

Параметры:

--token TEXT: токен доступа пользователя, созданный на странице https://huggingface.co/settings/tokens.
--help: Показать это сообщение и выйти.

Примеры $ hf buckets cp hf://buckets/username/my-bucket/config.json config.json $ hf buckets cp hf://buckets/username/my-bucket/data.csv data/ $ hf buckets cp hf://buckets/username/my-bucket/config.json - $ hf buckets cp model.safetensors hf://buckets/username/my-bucket/model.safetensors $ hf buckets cp config.json hf://buckets/username/my-bucket/logs/ $ hf buckets cp - hf://buckets/username/my-bucket/config.json $ hf buckets cp hf://buckets/username/my-bucket/data.csv hf://buckets/username/dest-bucket/ $ hf buckets cp hf://buckets/username/source-bucket/logs/ hf://buckets/username/dest-bucket/logs/

hf buckets create

Создайте новое хранилище.

Использование:

$ hf buckets create [OPTIONS] BUCKET_ID

Аргументы:

BUCKET_ID: ID бакета: bucket_name, namespace/bucket_name или hf://buckets/namespace/bucket_name [обязательный]

Параметры:

--private: Создать приватное хранилище.
--region [us|eu]: Область облака, в которой будет создан бакет. Может принимать значение ‘us’ или ‘eu’. Требуется тарифный план Team или выше.
--exist-ok: Не вызывать ошибку, если бакет уже существует.
--token TEXT: токен доступа пользователя, созданный на странице https://huggingface.co/settings/tokens.
--help: Показать это сообщение и выйти.

Примеры $ hf buckets create my-bucket $ hf buckets create user/my-bucket $ hf buckets create hf://buckets/user/my-bucket $ hf buckets create user/my-bucket —private $ hf buckets create user/my-bucket —exist-ok $ hf buckets create user/my-bucket —region us

hf buckets delete

Удалить бакет.

Эта команда удаляет весь бакет и всё его содержимое. Используйте hf buckets rm для удаления отдельных файлов.

Использование:

$ hf buckets delete [OPTIONS] BUCKET_ID

Аргументы:

BUCKET_ID: Идентификатор хранилища: namespace/bucket_name или hf://buckets/namespace/bucket_name [обязательный]

Параметры:

-y, --yes: Пропустить запрос подтверждения.
--missing-ok: Не вызывать ошибку, если бакет не существует.
--token TEXT: токен доступа пользователя, созданный на странице https://huggingface.co/settings/tokens.
--help: Показать это сообщение и выйти.

Примеры $ hf buckets delete user/my-bucket $ hf buckets delete hf://buckets/user/my-bucket $ hf buckets delete user/my-bucket —yes $ hf buckets delete user/my-bucket —missing-ok

hf buckets info

Получить информацию о бакете.

Использование:

$ hf buckets info [OPTIONS] BUCKET_ID

Аргументы:

BUCKET_ID: Идентификатор хранилища: namespace/bucket_name или hf://buckets/namespace/bucket_name [обязательный]

Параметры:

--token TEXT: токен доступа пользователя, созданный на странице https://huggingface.co/settings/tokens.
--help: Показать это сообщение и выйти.

Примеры $ hf buckets info user/my-bucket $ hf buckets info hf://buckets/user/my-bucket

hf buckets list

Просмотр списка бакетов или файлов в бакете. [alias: ls]

При вызове без аргументов или с указанием пространства имён выводит список бакетов. При вызове с идентификатором бакета (namespace/bucket_name) выводит список файлов в бакете.

Использование:

$ hf buckets list [OPTIONS] [ARGUMENT]

Аргументы:

[ARGUMENT]: пространство имён (пользователь или организация) для получения списка бакетов или идентификатор бакета (namespace/bucket_name(/prefix) или hf://buckets/…) для получения списка файлов.

Параметры:

-h, --human-readable: Отображать размеры в человекочитаемом формате.
--tree: выводит список файлов в формате дерева (только для просмотра списка файлов).
-R, --recursive: Рекурсивно выводить список файлов (только для вывода списка файлов).
--search TEXT: поисковый запрос.
--token TEXT: токен доступа пользователя, созданный на странице https://huggingface.co/settings/tokens.
--help: Показать это сообщение и выйти.

Примеры $ hf buckets list $ hf buckets list huggingface $ hf buckets list —search “my-prefix” $ hf buckets list user/my-bucket $ hf buckets list user/my-bucket -R $ hf buckets list user/my-bucket -h $ hf buckets list user/my-bucket —tree $ hf buckets list user/my-bucket —tree -h $ hf buckets list hf://buckets/user/my-bucket $ hf buckets list user/my-bucket/sub -R

hf buckets move

Переместить (переименовать) бакет в новое имя или пространство имён.

Использование:

$ hf buckets move [OPTIONS] FROM_ID TO_ID

Аргументы:

FROM_ID: ID исходного бакета: namespace/bucket_name или hf://buckets/namespace/bucket_name [обязательный]
TO_ID: ID целевого бакета: namespace/bucket_name или hf://buckets/namespace/bucket_name [обязательный]

Параметры:

--token TEXT: токен доступа пользователя, созданный на странице https://huggingface.co/settings/tokens.
--help: Показать это сообщение и выйти.

Примеры $ hf buckets move user/old-bucket user/new-bucket $ hf buckets move user/my-bucket my-org/my-bucket $ hf buckets move hf://buckets/user/old-bucket hf://buckets/user/new-bucket

hf buckets remove

Удаление файлов из хранилища. [alias: rm]

Чтобы удалить весь бакет, используйте hf buckets delete.

Использование:

$ hf buckets remove [OPTIONS] ARGUMENT

Аргументы:

ARGUMENT: Путь к бакету: namespace/bucket_name/path или hf://buckets/namespace/bucket_name/path. С флагом —recursive также принимается namespace/bucket_name для указания на все файлы. [обязательный]

Параметры:

-R, --recursive: Рекурсивно удаляет файлы под указанным префиксом.
-y, --yes: Пропустить запрос подтверждения.
--dry-run: Предпросмотр того, что будет удалено, без фактического удаления.
--include TEXT: Включать только файлы, соответствующие шаблону (можно указать несколько). Требует —recursive.
--exclude TEXT: Исключить файлы, соответствующие шаблону (можно указать несколько). Требует —recursive.
--token TEXT: токен доступа пользователя, созданный на странице https://huggingface.co/settings/tokens.
--help: Показать это сообщение и выйти.

Примеры $ hf buckets remove user/my-bucket/file.txt $ hf buckets rm hf://buckets/user/my-bucket/file.txt $ hf buckets rm user/my-bucket/logs/ —recursive $ hf buckets rm user/my-bucket —recursive —include “*.tmp” $ hf buckets rm user/my-bucket/data/ —recursive —dry-run

hf buckets settings

Обновление настроек хранилища (видимость).

Использование:

$ hf buckets settings [OPTIONS] BUCKET_ID

Аргументы:

BUCKET_ID: Идентификатор хранилища: namespace/bucket_name или hf://buckets/namespace/bucket_name [обязательный]

Параметры:

--private: Сделать бакет приватным.
--public: Сделать бакет общедоступным.
--token TEXT: токен доступа пользователя, созданный на странице https://huggingface.co/settings/tokens.
--help: Показать это сообщение и выйти.

Примеры $ hf buckets settings user/my-bucket —private $ hf buckets settings user/my-bucket —public $ hf buckets settings hf://buckets/user/my-bucket —private

hf buckets sync

Синхронизация файлов между локальным каталогом и хранилищем.

Использование:

$ hf buckets sync [OPTIONS] [SOURCE] [DEST]

Аргументы:

[SOURCE]: Путь к источнику: локальный каталог или hf://buckets/namespace/bucket_name(/prefix)
[DEST]: Путь назначения: локальный каталог или hf://buckets/namespace/bucket_name(/prefix)

Параметры:

--delete / --no-delete: Удаляет файлы в пункте назначения, отсутствующие в источнике. [по умолчанию: no-delete]
--ignore-times: Пропускать файлы только на основе размера, игнорируя время изменения.
--ignore-sizes: Пропускать файлы только на основе времени изменения, игнорируя размеры.
--plan TEXT: Сохранить план синхронизации в файл JSONL для проверки вместо выполнения.
--apply TEXT: Применить ранее сохранённый файл плана.
--dry-run: Выводит план синхронизации в stdout в формате JSONL без выполнения.
--include TEXT: Включить файлы, соответствующие шаблону (можно указать несколько).
--exclude TEXT: Исключить файлы, соответствующие шаблону (можно указать несколько).
--filter-from TEXT: читать шаблоны включения/исключения из файла.
--existing: не создавать новые файлы на стороне приёмника (обновлять только существующие файлы).
--ignore-existing: Пропускать обновление файлов, которые уже существуют на стороне получателя (создавать только новые файлы).
-v, --verbose: Показывать подробные логи с обоснованием.
--token TEXT: токен доступа пользователя, созданный на странице https://huggingface.co/settings/tokens.
--help: Показать это сообщение и выйти.

Примеры $ hf buckets sync ./data hf://buckets/user/my-bucket $ hf buckets sync hf://buckets/user/my-bucket ./data $ hf buckets sync ./data hf://buckets/user/my-bucket —delete $ hf buckets sync hf://buckets/user/my-bucket ./data —include ”.safetensors” —exclude ”.tmp” $ hf buckets sync ./data hf://buckets/user/my-bucket —plan sync-plan.jsonl $ hf buckets sync —apply sync-plan.jsonl $ hf buckets sync ./data hf://buckets/user/my-bucket —dry-run $ hf buckets sync ./data hf://buckets/user/my-bucket —dry-run | jq .

hf cache

Управление локальным каталогом кэша.

Использование:

$ hf cache [OPTIONS] COMMAND [ARGS]...

Параметры:

--help: Показать это сообщение и выйти.

Команды:

list: Список кэшированных репозиториев или ревизий. [alias: ls]
prune: Удаляет отсоединённые ревизии и незавершённые загрузки из кэша.
rm: Удаляет кэшированные репозитории, ревизии или файлы.
verify: Проверка контрольных сумм для одной ревизии репозитория из кэша или локального каталога.

hf cache list

Список кэшированных репозиториев или ревизий. [alias: ls]

Использование:

$ hf cache list [OPTIONS]

Параметры:

--cache-dir TEXT: Каталог кэша для сканирования (по умолчанию — кэш Hugging Face).
--revisions / --no-revisions: Включать ревизии в вывод вместо агрегированных репозиториев. [по умолчанию: no-revisions]
-f, --filter TEXT: Фильтрация записей (например, ‘size>1GB’, ‘type=model’, ‘accessed>7d’). Можно использовать несколько раз.
--sort [accessed|accessed:asc|accessed:desc|modified|modified:asc|modified:desc|name|name:asc|name:desc|size|size:asc|size:desc]: сортировка записей по ключу. Поддерживаемые ключи: ‘accessed’, ‘modified’, ‘name’, ‘size’. Добавьте ‘:asc’ или ‘:desc’, чтобы явно указать порядок (например, ‘modified:asc’). Значения по умолчанию: для ‘accessed’, ‘modified’ и ‘size’ — ‘desc’ (сначала самые новые/крупные); для ‘name’ — ‘asc’ (алфавитный порядок).
--limit INTEGER: Ограничивает количество возвращаемых результатов. Возвращает только первые N записей после сортировки.
--show-warnings / --no-show-warnings: Показывать предупреждения о несоответствиях в кэше. [по умолчанию: no-show-warnings]
--help: Показать это сообщение и выйти.

Примеры $ hf cache ls $ hf cache ls —revisions $ hf cache ls —filter “size>1GB” —limit 20 $ hf cache ls —format json

hf cache prune

Удалите отсоединённые ревизии и незавершённые загрузки из кэша.

Использование:

$ hf cache prune [OPTIONS]

Параметры:

--cache-dir TEXT: Каталог кэша для сканирования (по умолчанию — кэш Hugging Face).
-y, --yes: Пропустить запрос подтверждения.
--dry-run / --no-dry-run: Предпросмотр удалений без фактического удаления. [по умолчанию: no-dry-run]
--help: Показать это сообщение и выйти.

Примеры $ hf cache prune $ hf cache prune —dry-run

hf cache rm

Удалите кэшированные репозитории, ревизии или файлы.

Использование:

$ hf cache rm [OPTIONS] TARGETS...

Аргументы:

TARGETS...: один или несколько идентификаторов репозиториев (например, model/bert-base-uncased), URI в формате hf:// (репозиторий или файл) или хеши ревизий для удаления. [обязательный параметр]

Параметры:

--cache-dir TEXT: Каталог кэша для сканирования (по умолчанию — кэш Hugging Face).
-y, --yes: Пропустить запрос подтверждения.
--dry-run / --no-dry-run: Предпросмотр удалений без фактического удаления. [по умолчанию: no-dry-run]
--help: Показать это сообщение и выйти.

Примеры $ hf cache rm model/gpt2 $ hf cache rm hf://models/openai-community/gpt2 $ hf cache rm hf://models/openai-community/gpt2/model.safetensors $ hf cache rm <revision_hash> $ hf cache rm model/gpt2 —dry-run $ hf cache rm model/gpt2 —yes

hf cache verify

Проверьте контрольные суммы для одной ревизии репозитория из кэша или локального каталога.

Примеры:

Проверьте основную ревизию в кэше: hf cache verify gpt2
Проверка конкретного ревизии: hf cache verify gpt2 --revision refs/pr/1
Проверка набора данных: hf cache verify karpathy/fineweb-edu-100b-shuffle --repo-type dataset
Проверка локального каталога: hf cache verify deepseek-ai/DeepSeek-OCR --local-dir /path/to/repo

Использование:

$ hf cache verify [OPTIONS] REPO_ID

Аргументы:

REPO_ID: идентификатор репозитория (например, username/repo-name или spaces/username/repo-name). [обязательный]

Параметры:

--type, --repo-type [model|dataset|space|kernel]: тип репозитория (model, dataset, space или kernel). [по умолчанию: model]
--revision TEXT: идентификатор ревизии Git, который может быть именем ветки, тегом или хэшем коммита.
--cache-dir TEXT: Каталог кэша, используемый при проверке файлов из кэша (по умолчанию — кэш Hugging Face).
--local-dir TEXT: если задано, проверяет файлы в этой директории вместо кэша.
--fail-on-missing-files: завершить работу с ошибкой, если некоторые файлы существуют на удалённом хранилище, но отсутствуют локально.
--fail-on-extra-files: завершить работу с ошибкой, если некоторые файлы существуют локально, но отсутствуют в удалённой ревизии.
--token TEXT: токен доступа пользователя, созданный на странице https://huggingface.co/settings/tokens.
--help: Показать это сообщение и выйти.

Примеры $ hf cache verify gpt2 $ hf cache verify gpt2 —revision refs/pr/1 $ hf cache verify my-dataset —repo-type dataset

hf collections

Работайте с коллекциями на Hub.

Использование:

$ hf collections [OPTIONS] COMMAND [ARGS]...

Параметры:

--help: Показать это сообщение и выйти.

Команды:

add-item: добавить элемент в коллекцию.
create: Создать новую коллекцию на Hub.
delete: Удалить коллекцию из Hub.
delete-item: Удалить элемент из коллекции.
info: получить информацию о коллекции на Hub.
list: Список коллекций на Hub. [alias: ls]
update: обновить метаданные коллекции на Hub.
update-item: Обновить элемент в коллекции.

hf collections add-item

Добавить элемент в коллекцию.

Использование:

$ hf collections add-item [OPTIONS] COLLECTION_SLUG ITEM_ID ITEM_TYPE:{model|dataset|space|paper|collection|bucket}

Аргументы:

COLLECTION_SLUG: слаг коллекции (например, ‘username/collection-slug’). [обязательный]
ITEM_ID: идентификатор добавляемого элемента (repo_id для репозиториев, ID статьи для статей). [обязательный]
ITEM_TYPE:{model|dataset|space|paper|collection|bucket}: тип элемента (модель, набор данных, пространство, статья, коллекция или bucket). [обязательный]

Параметры:

--note TEXT: примечание, которое нужно прикрепить к элементу (максимум 500 символов).
--exists-ok / --no-exists-ok: Не вызывать ошибку, если элемент уже присутствует в коллекции. [по умолчанию: no-exists-ok]
--token TEXT: токен доступа пользователя, созданный на странице https://huggingface.co/settings/tokens.
--help: Показать это сообщение и выйти.

Примеры $ hf collections add-item username/my-collection moonshotai/kimi-k2 model $ hf collections add-item username/my-collection Qwen/DeepPlanning dataset —note “Useful dataset” $ hf collections add-item username/my-collection Tongyi-MAI/Z-Image space

hf collections create

Создайте новую коллекцию на Hub.

Использование:

$ hf collections create [OPTIONS] TITLE

Аргументы:

TITLE: Название коллекции. [обязательное поле]

Параметры:

--namespace TEXT: пространство имён (имя пользователя или организации). По умолчанию используется аутентифицированный пользователь.
--description TEXT: Описание коллекции (максимум 150 символов).
--private / --no-private: Создать приватную коллекцию. [по умолчанию: no-private]
--exists-ok / --no-exists-ok: Не вызывать ошибку, если коллекция уже существует. [по умолчанию: no-exists-ok]
--token TEXT: токен доступа пользователя, созданный на странице https://huggingface.co/settings/tokens.
--help: Показать это сообщение и выйти.

Примеры $ hf collections create “My Models” $ hf collections create “My Models” —description “A collection of my favorite models” —private $ hf collections create “Org Collection” —namespace my-org

hf collections delete

Удалить коллекцию из Hub.

Использование:

$ hf collections delete [OPTIONS] COLLECTION_SLUG

Аргументы:

COLLECTION_SLUG: слаг коллекции (например, ‘username/collection-slug’). [обязательный]

Параметры:

--missing-ok / --no-missing-ok: Не вызывать ошибку, если коллекция не существует. [по умолчанию: no-missing-ok]
--token TEXT: токен доступа пользователя, созданный на странице https://huggingface.co/settings/tokens.
--help: Показать это сообщение и выйти.

Примеры $ hf collections delete username/my-collection $ hf collections delete username/my-collection —missing-ok

hf collections delete-item

Удалить элемент из коллекции.

Использование:

$ hf collections delete-item [OPTIONS] COLLECTION_SLUG ITEM_OBJECT_ID

Аргументы:

COLLECTION_SLUG: слаг коллекции (например, ‘username/collection-slug’). [обязательный]
ITEM_OBJECT_ID: идентификатор элемента в коллекции (извлекается из поля item_object_id, возвращаемого командой ‘hf collections info’. [обязательный параметр]

Параметры:

--missing-ok / --no-missing-ok: Не вызывать ошибку, если элемент не существует. [по умолчанию: no-missing-ok]
--token TEXT: токен доступа пользователя, созданный на странице https://huggingface.co/settings/tokens.
--help: Показать это сообщение и выйти.

hf collections info

Получить информацию о коллекции на Hub.

Использование:

$ hf collections info [OPTIONS] COLLECTION_SLUG

Аргументы:

COLLECTION_SLUG: слаг коллекции (например, ‘username/collection-slug’). [обязательный]

Параметры:

--token TEXT: токен доступа пользователя, созданный на странице https://huggingface.co/settings/tokens.
--help: Показать это сообщение и выйти.

Примеры $ hf collections info username/my-collection-slug

hf collections list

Получить список коллекций на Hub. [alias: ls]

Использование:

$ hf collections list [OPTIONS]

Параметры:

--owner TEXT: Фильтр по имени пользователя или организации владельца.
--item TEXT: Фильтрует коллекции, содержащие конкретный элемент (например, “models/gpt2”, “datasets/squad”, “papers/2311.12983”).
--sort [lastModified|trending|upvotes]: сортировка результатов по дате последнего изменения, популярности или числу голосов «за».
--limit INTEGER: Ограничивает количество результатов. [по умолчанию: 10]
--token TEXT: токен доступа пользователя, созданный на странице https://huggingface.co/settings/tokens.
--help: Показать это сообщение и выйти.

Примеры $ hf collections ls $ hf collections ls —owner nvidia $ hf collections ls —item models/teknium/OpenHermes-2.5-Mistral-7B —limit 10

hf collections update

Обновите метаданные коллекции на Hub.

Использование:

$ hf collections update [OPTIONS] COLLECTION_SLUG

Аргументы:

COLLECTION_SLUG: слаг коллекции (например, ‘username/collection-slug’). [обязательный]

Параметры:

--title TEXT: Новый заголовок для коллекции.
--description TEXT: новое описание для коллекции (макс. 150 символов).
--position INTEGER: новое положение коллекции в списке владельца.
--private / --no-private: должен ли сборник быть приватным.
--theme TEXT: цвет темы для коллекции (например, ‘green’, ‘blue’).
--token TEXT: токен доступа пользователя, созданный на странице https://huggingface.co/settings/tokens.
--help: Показать это сообщение и выйти.

Примеры $ hf collections update username/my-collection —title “New Title” $ hf collections update username/my-collection —description “Updated description” $ hf collections update username/my-collection —private —theme green

hf collections update-item

Обновить элемент в коллекции.

Использование:

$ hf collections update-item [OPTIONS] COLLECTION_SLUG ITEM_OBJECT_ID

Аргументы:

COLLECTION_SLUG: слаг коллекции (например, ‘username/collection-slug’). [обязательный]
ITEM_OBJECT_ID: идентификатор элемента в коллекции (из поля ‘item_object_id’, а не repo_id). [обязательное поле]

Параметры:

--note TEXT: новое примечание к элементу (максимум 500 символов).
--position INTEGER: новое положение элемента в коллекции.
--token TEXT: токен доступа пользователя, созданный на странице https://huggingface.co/settings/tokens.
--help: Показать это сообщение и выйти.

Примеры $ hf collections update-item username/my-collection ITEM_OBJECT_ID —note “Updated note” $ hf collections update-item username/my-collection ITEM_OBJECT_ID —position 0

hf cp

Копирование файлов между локальными путями, репозиториями и хранилищами.

Использование:

$ hf cp [OPTIONS] SRC [DST]

Аргументы:

SRC: Источник: локальный файл, URI hf:// (репозиторий или бакет) или - для стандартного ввода. [обязательный]
[DST]: Назначение: локальный путь, URI hf:// (репозиторий или бакет) или - для stdout.

Параметры:

--token TEXT: токен доступа пользователя, созданный на странице https://huggingface.co/settings/tokens.
--help: Показать это сообщение и выйти.

Примеры $ hf cp hf://username/my-model/config.json $ hf cp hf://username/my-model/config.json ./config.json $ hf cp hf://datasets/username/my-dataset/data.csv ./data/ $ hf cp hf://buckets/username/my-bucket/config.json - $ hf cp ./model.safetensors hf://username/my-model/model.safetensors $ hf cp ./config.json hf://buckets/username/my-bucket/logs/ $ hf cp - hf://buckets/username/my-bucket/config.json $ hf cp hf://username/source-model/ hf://username/dest-model/ $ hf cp hf://datasets/username/my-dataset/processed/ hf://buckets/username/my-bucket/processed/ $ hf cp hf://buckets/username/my-bucket/logs/ hf://buckets/username/archive-bucket/ # copies contents only

hf datasets

Работайте с наборами данных на Hub.

Использование:

$ hf datasets [OPTIONS] COMMAND [ARGS]...

Параметры:

--help: Показать это сообщение и выйти.

Команды:

card: получить карточку набора данных (README) для набора данных на Hub.
info: получить информацию о наборе данных на Hub.
leaderboard: список оценок моделей из таблицы лидеров набора данных.
list: Список датасетов на Hub или файлов в репозитории датасета. [alias: ls]
parquet: список URL-адресов файлов parquet, доступных для набора данных.
sql: Выполнить сырой SQL-запрос с помощью DuckDB по URL-адресам parquet-файлов набора данных.

hf datasets card

Получите карточку набора данных (README) для набора данных на Hub.

Использование:

$ hf datasets card [OPTIONS] DATASET_ID

Аргументы:

DATASET_ID: идентификатор набора данных (например, username/repo-name). [обязательный]

Параметры:

--metadata: выводить только метаданные из карточки.
--text: выводить только текстовое содержимое (без метаданных).
--token TEXT: токен доступа пользователя, созданный на странице https://huggingface.co/settings/tokens.
--help: Показать это сообщение и выйти.

Примеры $ hf datasets card HuggingFaceFW/fineweb $ hf datasets card HuggingFaceFW/fineweb —metadata $ hf datasets card HuggingFaceFW/fineweb —metadata —format json $ hf datasets card HuggingFaceFW/fineweb —text

hf datasets info

Получить информацию о наборе данных на Hub.

Использование:

$ hf datasets info [OPTIONS] DATASET_ID

Аргументы:

DATASET_ID: идентификатор набора данных (например, username/repo-name). [обязательный]

Параметры:

--revision TEXT: идентификатор ревизии Git, который может быть именем ветки, тегом или хэшем коммита.
--expand TEXT: свойства, возвращаемые в ответе, разделённые запятыми. При использовании этого параметра возвращаются только перечисленные свойства (а также id). Пример: ‘—expand=downloads,likes,tags’. Допустимые значения: author, cardData, citation, createdAt, description, disabled, downloads, downloadsAllTime, gated, lastModified, likes, mainSize, paperswithcode_id, private, resourceGroup, sha, siblings, tags, trendingScore, usedStorage.
--token TEXT: токен доступа пользователя, созданный на странице https://huggingface.co/settings/tokens.
--help: Показать это сообщение и выйти.

Примеры $ hf datasets info HuggingFaceFW/fineweb $ hf datasets info my-dataset —expand downloads,likes,tags

hf datasets leaderboard

Получить список оценок моделей из таблицы лидеров набора данных. Эта команда помогает найти лучшие модели для задачи или сравнить модели по результатам бенчмарков. Используйте hf datasets ls —filter benchmark:official, чтобы получить список доступных таблиц лидеров.

Использование:

$ hf datasets leaderboard [OPTIONS] DATASET_ID

Аргументы:

DATASET_ID: идентификатор набора данных для бенчмарка (например, SWE-bench/SWE-bench_Verified). [обязательный]

Параметры:

--limit INTEGER: Ограничивает количество результатов. [по умолчанию: 20]
--token TEXT: токен доступа пользователя, созданный на странице https://huggingface.co/settings/tokens.
--help: Показать это сообщение и выйти.

Примеры $ hf datasets leaderboard SWE-bench/SWE-bench_Verified $ hf datasets leaderboard SWE-bench/SWE-bench_Verified —limit 5 —format json $ hf datasets ls —filter benchmark:official # list available leaderboards

hf datasets list

Просмотр списка датасетов на Hub или файлов в репозитории датасета. [alias: ls]

При вызове без аргументов выводит список датасетов на Hub. При вызове с идентификатором датасета выводит список файлов в репозитории этого датасета.

Использование:

$ hf datasets list [OPTIONS] [REPO_ID]

Аргументы:

[REPO_ID]: идентификатор набора данных (например, username/repo-name), для которого нужно получить список файлов. Если не указан, выводится список наборов данных.

Параметры:

--search TEXT: поисковый запрос.
--author TEXT: Фильтр по автору или организации.
--filter TEXT: Фильтрация по тегам (например, ‘text-classification’). Можно использовать несколько раз.
--sort [created_at|downloads|last_modified|likes|trending_score]: сортировка результатов.
--limit INTEGER: Ограничивает количество результатов. [по умолчанию: 30]
--expand TEXT: свойства, возвращаемые в ответе, разделённые запятыми. При использовании этого параметра возвращаются только перечисленные свойства (а также id). Пример: ‘—expand=downloads,likes,tags’. Допустимые значения: author, cardData, citation, createdAt, description, disabled, downloads, downloadsAllTime, gated, lastModified, likes, mainSize, paperswithcode_id, private, resourceGroup, sha, siblings, tags, trendingScore, usedStorage.
-h, --human-readable: отображать размеры в человекочитаемом формате (только для списка файлов).
--tree: выводит список файлов в формате дерева (только для просмотра списка файлов).
-R, --recursive: Рекурсивно выводить список файлов (только для вывода списка файлов).
--revision TEXT: идентификатор ревизии Git, который может быть именем ветки, тегом или хэшем коммита.
--token TEXT: токен доступа пользователя, созданный на странице https://huggingface.co/settings/tokens.
--help: Показать это сообщение и выйти.

Примеры $ hf datasets ls $ hf datasets ls —sort downloads —limit 10 $ hf datasets ls —search “code” $ hf datasets ls —filter benchmark:official $ hf datasets ls HuggingFaceFW/fineweb $ hf datasets ls HuggingFaceFW/fineweb -R $ hf datasets ls HuggingFaceFW/fineweb —tree -h

hf datasets parquet

Список URL-адресов файлов parquet, доступных для набора данных.

Использование:

$ hf datasets parquet [OPTIONS] DATASET_ID

Аргументы:

DATASET_ID: идентификатор набора данных (например, username/repo-name). [обязательный]

Параметры:

--subset TEXT: Фильтрация записей parquet по подмножеству/конфигурации.
--split TEXT: Фильтрация записей parquet по split.
--token TEXT: токен доступа пользователя, созданный на странице https://huggingface.co/settings/tokens.
--help: Показать это сообщение и выйти.

Примеры $ hf datasets parquet cfahlgren1/hub-stats $ hf datasets parquet cfahlgren1/hub-stats —subset models $ hf datasets parquet cfahlgren1/hub-stats —split train $ hf datasets parquet cfahlgren1/hub-stats —format json

hf datasets sql

Выполните сырой SQL-запрос с помощью DuckDB по URL-адресам файлов parquet набора данных.

Использование:

$ hf datasets sql [OPTIONS] SQL

Аргументы:

SQL: исходный SQL-запрос для выполнения. [обязательный]

Параметры:

--token TEXT: токен доступа пользователя, созданный на странице https://huggingface.co/settings/tokens.
--help: Показать это сообщение и выйти.

Примеры $ hf datasets sql “SELECT COUNT() AS rows FROM read_parquet(’https://huggingface.co/api/datasets/cfahlgren1/hub-stats/parquet/models/train/0.parquet’)” $ hf datasets sql “SELECT FROM read_parquet(’https://huggingface.co/api/datasets/cfahlgren1/hub-stats/parquet/models/train/0.parquet’) LIMIT 5” —format json

hf discussions

Управляйте обсуждениями и pull request на Hub.

Использование:

$ hf discussions [OPTIONS] COMMAND [ARGS]...

Параметры:

--help: Показать это сообщение и выйти.

Команды:

close: Закрыть обсуждение или pull request.
comment: Комментарий к обсуждению или pull request.
create: Создать новое обсуждение или pull request в репозитории.
diff: показывает различия в pull request.
edit: редактировать существующий комментарий в обсуждении или pull request.
info: получить информацию о дискуссии или pull request.
list: Список обсуждений и pull request в репозитории. [alias: ls]
merge: объединить pull request.
rename: Переименовать обсуждение или pull request.
reopen: Повторно открыть закрытое обсуждение или pull request.

hf discussions close

Закрыть обсуждение или pull request.

Использование:

$ hf discussions close [OPTIONS] REPO_ID NUM

Аргументы:

REPO_ID: идентификатор репозитория (например, username/repo-name или spaces/username/repo-name). [обязательный]
NUM: номер обсуждения или pull request. [обязательный]

Параметры:

--comment TEXT: Необязательный комментарий для публикации при закрытии.
-y, --yes: Пропустить запрос подтверждения.
--type, --repo-type [model|dataset|space|kernel]: тип репозитория (model, dataset, space или kernel). [по умолчанию: model]
--token TEXT: токен доступа пользователя, созданный на странице https://huggingface.co/settings/tokens.
--help: Показать это сообщение и выйти.

Примеры $ hf discussions close username/my-model 5 $ hf discussions close username/my-model 5 —comment “Закрываю как решённое.”

hf discussions comment

Оставьте комментарий к обсуждению или pull request.

Использование:

$ hf discussions comment [OPTIONS] REPO_ID NUM

Аргументы:

REPO_ID: идентификатор репозитория (например, username/repo-name или spaces/username/repo-name). [обязательный]
NUM: номер обсуждения или pull request. [обязательный]

Параметры:

--body TEXT: текст комментария (поддерживает Markdown).
--body-file PATH: Прочитать комментарий из файла. Используйте ’-’ для стандартного ввода.
--attach TEXT: Прикрепить файл изображения, видео или аудио в формате ‘FILE’ или ‘FILE#alt text’. Ссылка ‘’ в тексте заменяется загруженным файлом, остальные файлы добавляются в конец. Можно использовать несколько раз.
--type, --repo-type [model|dataset|space|kernel]: тип репозитория (model, dataset, space или kernel). [по умолчанию: model]
--token TEXT: токен доступа пользователя, созданный на странице https://huggingface.co/settings/tokens.
--help: Показать это сообщение и выйти.

Примеры $ hf discussions comment username/my-model 5 —body “Thanks for reporting!” $ hf discussions comment username/my-model 5 —body “LGTM!” $ hf discussions comment username/my-model 5 —body “Here is a demo:” —attach demo.mp4

hf discussions create

Создайте новое обсуждение или pull request в репозитории.

Использование:

$ hf discussions create [OPTIONS] REPO_ID

Аргументы:

REPO_ID: идентификатор репозитория (например, username/repo-name или spaces/username/repo-name). [обязательный]

Параметры:

--title TEXT: Заголовок обсуждения или pull request. [обязательный]
--body TEXT: Описание (поддерживает Markdown).
--body-file PATH: читать описание из файла. Используйте ’-’ для стандартного ввода.
--pull-request, --pr: Создать pull request вместо обсуждения.
--attach TEXT: Прикрепить файл изображения, видео или аудио в формате ‘FILE’ или ‘FILE#alt text’. Ссылка ‘’ в тексте заменяется загруженным файлом, остальные файлы добавляются в конец. Можно использовать несколько раз.
--type, --repo-type [model|dataset|space|kernel]: тип репозитория (model, dataset, space или kernel). [по умолчанию: model]
--token TEXT: токен доступа пользователя, созданный на странице https://huggingface.co/settings/tokens.
--help: Показать это сообщение и выйти.

Примеры $ hf discussions create username/my-model —title “Bug report” $ hf discussions create username/my-model —title “Feature request” —body “Please add X” $ hf discussions create username/my-model —title “Fix typo” —pull-request $ hf discussions create username/my-dataset —type dataset —title “Data quality issue” $ hf discussions create username/my-model —title “Fix rendering” —pr —attach “./before.png#Before the fix” —attach ./after.png

hf discussions diff

Показать diff pull request.

Использование:

$ hf discussions diff [OPTIONS] REPO_ID NUM

Аргументы:

REPO_ID: идентификатор репозитория (например, username/repo-name или spaces/username/repo-name). [обязательный]
NUM: номер обсуждения или pull request. [обязательный]

Параметры:

--type, --repo-type [model|dataset|space|kernel]: тип репозитория (model, dataset, space или kernel). [по умолчанию: model]
--token TEXT: токен доступа пользователя, созданный на странице https://huggingface.co/settings/tokens.
--help: Показать это сообщение и выйти.

Примеры $ hf discussions diff username/my-model 5

hf discussions edit

Редактирование существующего комментария в обсуждении или pull request.

Использование:

$ hf discussions edit [OPTIONS] REPO_ID NUM COMMENT_ID

Аргументы:

REPO_ID: идентификатор репозитория (например, username/repo-name или spaces/username/repo-name). [обязательный]
NUM: номер обсуждения или pull request. [обязательный]
COMMENT_ID: идентификатор редактируемого комментария (см. ‘hf discussions info … —format json’). [обязательный]

Параметры:

--body TEXT: текст нового комментария (поддерживает Markdown).
--body-file PATH: читать новый комментарий из файла. Используйте ’-’ для stdin.
--attach TEXT: Прикрепить файл изображения, видео или аудио в формате ‘FILE’ или ‘FILE#alt text’. Ссылка ‘’ в тексте заменяется загруженным файлом, остальные файлы добавляются в конец. Можно использовать несколько раз.
--type, --repo-type [model|dataset|space|kernel]: тип репозитория (model, dataset, space или kernel). [по умолчанию: model]
--token TEXT: токен доступа пользователя, созданный на странице https://huggingface.co/settings/tokens.
--help: Показать это сообщение и выйти.

Примеры $ hf discussions edit username/my-model 5 abc123 —body “Updated comment.” $ hf discussions edit username/my-model 5 abc123 —body-file fixed.md $ hf discussions edit username/my-model 5 abc123 —body “Fixed: result ” —attach ./after.png

hf discussions info

Получить информацию о дискуссии или pull request.

Использование:

$ hf discussions info [OPTIONS] REPO_ID NUM

Аргументы:

REPO_ID: идентификатор репозитория (например, username/repo-name или spaces/username/repo-name). [обязательный]
NUM: номер обсуждения или pull request. [обязательный]

Параметры:

--type, --repo-type [model|dataset|space|kernel]: тип репозитория (model, dataset, space или kernel). [по умолчанию: model]
--token TEXT: токен доступа пользователя, созданный на странице https://huggingface.co/settings/tokens.
--help: Показать это сообщение и выйти.

Примеры $ hf discussions info username/my-model 5 $ hf discussions info username/my-model 5 —format json

hf discussions list

Список обсуждений и pull request'ов в репозитории. [alias: ls]

Использование:

$ hf discussions list [OPTIONS] REPO_ID

Аргументы:

REPO_ID: идентификатор репозитория (например, username/repo-name или spaces/username/repo-name). [обязательный]

Параметры:

-s, --status [open|closed|merged|draft|all]: Фильтрация по статусу (open, closed, merged, draft, all). [по умолчанию: open]
-k, --kind [all|discussion|pull_request]: Фильтрация по типу (discussion, pull_request, all). [по умолчанию: all]
--author TEXT: Фильтр по автору или организации.
--limit INTEGER: Ограничивает количество результатов. [по умолчанию: 30]
--type, --repo-type [model|dataset|space|kernel]: тип репозитория (model, dataset, space или kernel). [по умолчанию: model]
--token TEXT: токен доступа пользователя, созданный на странице https://huggingface.co/settings/tokens.
--help: Показать это сообщение и выйти.

Примеры $ hf discussions list username/my-model $ hf discussions list username/my-model —kind pull_request —status merged $ hf discussions list username/my-dataset —type dataset —status closed $ hf discussions list username/my-model —author alice —format json

hf discussions merge

Слить pull request.

Использование:

$ hf discussions merge [OPTIONS] REPO_ID NUM

Аргументы:

REPO_ID: идентификатор репозитория (например, username/repo-name или spaces/username/repo-name). [обязательный]
NUM: номер обсуждения или pull request. [обязательный]

Параметры:

--comment TEXT: Необязательный комментарий для публикации при слиянии.
-y, --yes: Пропустить запрос подтверждения.
--type, --repo-type [model|dataset|space|kernel]: тип репозитория (model, dataset, space или kernel). [по умолчанию: model]
--token TEXT: токен доступа пользователя, созданный на странице https://huggingface.co/settings/tokens.
--help: Показать это сообщение и выйти.

Примеры $ hf discussions merge username/my-model 5 $ hf discussions merge username/my-model 5 —comment “Merging, thanks!”

hf discussions переименовать

Переименовать обсуждение или pull request.

Использование:

$ hf discussions rename [OPTIONS] REPO_ID NUM NEW_TITLE

Аргументы:

REPO_ID: идентификатор репозитория (например, username/repo-name или spaces/username/repo-name). [обязательный]
NUM: номер обсуждения или pull request. [обязательный]
NEW_TITLE: Новый заголовок. [обязательный]

Параметры:

--type, --repo-type [model|dataset|space|kernel]: тип репозитория (model, dataset, space или kernel). [по умолчанию: model]
--token TEXT: токен доступа пользователя, созданный на странице https://huggingface.co/settings/tokens.
--help: Показать это сообщение и выйти.

Примеры $ hf discussions rename username/my-model 5 “Updated title”

hf discussions reopen

Снова открыть закрытое обсуждение или pull request.

Использование:

$ hf discussions reopen [OPTIONS] REPO_ID NUM

Аргументы:

REPO_ID: идентификатор репозитория (например, username/repo-name или spaces/username/repo-name). [обязательный]
NUM: номер обсуждения или pull request. [обязательный]

Параметры:

--comment TEXT: Необязательный комментарий для публикации при повторном открытии.
-y, --yes: Пропустить запрос подтверждения.
--type, --repo-type [model|dataset|space|kernel]: тип репозитория (model, dataset, space или kernel). [по умолчанию: model]
--token TEXT: токен доступа пользователя, созданный на странице https://huggingface.co/settings/tokens.
--help: Показать это сообщение и выйти.

Примеры $ hf discussions reopen username/my-model 5 $ hf discussions reopen username/my-model 5 —comment “Reopening for further investigation.”

hf download

Загрузка файлов с Hub.

Использование:

$ hf download [OPTIONS] REPO_ID [FILENAMES]...

Аргументы:

REPO_ID: идентификатор репозитория (например, username/repo-name или spaces/username/repo-name). [обязательный]
[FILENAMES]...: файлы для загрузки (например, config.json, data/metadata.jsonl).

Параметры:

--type, --repo-type [model|dataset|space|kernel]: тип репозитория (модель, набор данных, пространство или ядро). [по умолчанию: (model)]
--revision TEXT: идентификатор ревизии Git, который может быть именем ветки, тегом или хэшем коммита.
--include TEXT: Глобальные шаблоны для включения файлов для загрузки. Например: *.json
--exclude TEXT: Глобальные шаблоны для исключения файлов из загрузки.
--cache-dir TEXT: Каталог для сохранения файлов.
--local-dir TEXT: Если задано, загруженный файл будет помещён в этот каталог. Подробности см. в https://huggingface.co/docs/huggingface_hub/guides/download#download-files-to-a-local-folder.
--force-download / --no-force-download: если True, файлы будут загружены, даже если они уже кэшированы. [по умолчанию: no-force-download]
--dry-run / --no-dry-run: Если True, выполняется тестовый прогон без фактической загрузки файла. [по умолчанию: no-dry-run]
--token TEXT: токен доступа пользователя, созданный на странице https://huggingface.co/settings/tokens.
--max-workers INTEGER: Максимальное количество рабочих процессов для загрузки файлов. По умолчанию — 8. [default: 8]
--help: Показать это сообщение и выйти.

Примеры $ hf download meta-llama/Llama-3.2-1B-Instruct $ hf download meta-llama/Llama-3.2-1B-Instruct config.json tokenizer.json $ hf download meta-llama/Llama-3.2-1B-Instruct —include ”.safetensors” —exclude ”.bin” $ hf download meta-llama/Llama-3.2-1B-Instruct —local-dir ./models/llama $ hf download HuggingFaceM4/FineVision art/ —repo-type dataset $ hf download hf://datasets/HuggingFaceH4/ultrachat_200k

hf endpoints

Управление точками входа для вывода Hugging Face.

Использование:

$ hf endpoints [OPTIONS] COMMAND [ARGS]...

Параметры:

--help: Показать это сообщение и выйти.

Команды:

catalog: взаимодействие с каталогом Inference Endpoints.
delete: Безвозвратно удалить Inference Endpoint.
deploy: Развернуть Inference Endpoint из репозитория на Hub.
describe: получить информацию о существующем эндпоинте.
hardware: Список оборудования, доступного для развертывания Inference Endpoint.
list: Выводит список всех Inference Endpoints для указанного пространства имён. [alias: ls]
list-catalog: Список моделей, доступных в Model Catalog.
pause: Приостановить Inference Endpoint.
resume: Возобновить работу Inference Endpoint.
scale-to-zero: масштабирование Inference Endpoint до нуля.
update: обновить существующий конечный пункт.

hf endpoints catalog

Взаимодействуйте с каталогом Inference Endpoints.

Использование:

$ hf endpoints catalog [OPTIONS] COMMAND [ARGS]...

Параметры:

--help: Показать это сообщение и выйти.

Команды:

deploy: Развернуть Inference Endpoint из Model Catalog.
list: Выводит список моделей, доступных в Model Catalog. [alias: ls]

hf endpoints catalog deploy

Разверните Inference Endpoint из Model Catalog.

Модели из каталога разворачиваются через рецепт: комбинацию аппаратного обеспечения и движка, протестированную для них. Передайте —repo, чтобы развернуть рецепт по умолчанию для модели, при необходимости уточнив его с помощью —accelerator и —gguf-file, или передайте —recipe, чтобы развернуть конкретный рецепт из списка, выводимого командой hf endpoints catalog ls.

Использование:

$ hf endpoints catalog deploy [OPTIONS]

Параметры:

--repo TEXT: Имя репозитория модели, связанного с Inference Endpoint (например, ‘openai/gpt-oss-120b’). Разворачивает его рецепт по умолчанию. Взаимоисключающийся с —recipe.
--recipe TEXT: идентификатор рецепта из каталога для развертывания, как он отображается в выводе ‘hf endpoints catalog ls’. Взаимоисключающийся с —repo.
--name TEXT: Имя конечной точки.
--accelerator [cpu|gpu|neuron]: аппаратный ускоритель, используемый для вывода. Только с —repo.
--gguf-file TEXT: GGUF-файл для развёртывания, для моделей, у которых один рецепт на каждый вариант квантования. Только с —repo.
--namespace TEXT: пространство имён, связанное с Inference Endpoint. По умолчанию используется пространство имён текущего пользователя.
--token TEXT: токен доступа пользователя, созданный на странице https://huggingface.co/settings/tokens.
--help: Показать это сообщение и выйти.

Примеры $ hf endpoints catalog deploy —repo meta-llama/Llama-3.2-1B-Instruct $ hf endpoints catalog deploy —recipe sizzling-biryani-g4xsi1ac

hf endpoints catalog list

Получите список моделей, доступных в Model Catalog. [alias: ls]

Одна строка на рецепт, то есть на каждый протестированный способ развёртывания модели. Разверните один из них с помощью hf endpoints catalog deploy --recipe <RECIPE_ID>.

Использование:

$ hf endpoints catalog list [OPTIONS]

Параметры:

--accelerator [cpu|gpu|neuron]: Показывать только рецепты, работающие на этом ускорителе.
--engine [llamacpp|sglang|tei|vllm]: показывать только рецепты, использующие этот движок инференса.
--license TEXT: показывать только модели с этой лицензией (например, ‘Apache 2.0’).
--task TEXT: показывать только модели для этой задачи (например, ‘text-generation’).
--search TEXT: поисковый запрос.
--limit INTEGER: Ограничивает количество возвращаемых моделей.
--token TEXT: токен доступа пользователя, созданный на странице https://huggingface.co/settings/tokens.
--help: Показать это сообщение и выйти.

Примеры $ hf endpoints catalog ls $ hf endpoints catalog ls —engine vllm

hf endpoints delete

Безвозвратно удалить Inference Endpoint.

Использование:

$ hf endpoints delete [OPTIONS] NAME

Аргументы:

NAME: Имя конечной точки. [обязательно]

Параметры:

--namespace TEXT: пространство имён, связанное с Inference Endpoint. По умолчанию используется пространство имён текущего пользователя.
--yes: Пропустить запросы подтверждения.
--token TEXT: токен доступа пользователя, созданный на странице https://huggingface.co/settings/tokens.
--help: Показать это сообщение и выйти.

Примеры $ hf endpoints delete my-endpoint

hf endpoints deploy

Разверните Inference Endpoint из репозитория Hub.

Выполните hf endpoints hardware, чтобы получить список допустимых комбинаций --vendor, --region, --accelerator, --instance-type и --instance-size.

Использование:

$ hf endpoints deploy [OPTIONS] NAME

Аргументы:

NAME: Имя конечной точки. [обязательно]

Параметры:

--repo TEXT: Имя репозитория модели, связанного с Inference Endpoint (например, ‘openai/gpt-oss-120b’). [обязательный параметр]
--framework TEXT: Фреймворк машинного обучения, используемый для модели (например, ‘vllm’). [обязательный параметр]
--accelerator TEXT: аппаратный ускоритель, используемый для вывода (например, ‘cpu’). [обязательный]
--instance-size TEXT: размер или тип экземпляра, который будет использоваться для размещения модели (например, ‘x4’). [обязательный параметр]
--instance-type TEXT: тип облачного инстанса, на котором будет развернут Inference Endpoint (например, ‘intel-icl’). [обязательный параметр]
--region TEXT: Облачная область, в которой будет создан Inference Endpoint (например, ‘us-east-1’). [обязательный параметр]
--vendor TEXT: Облачный провайдер или вендор, на котором будет размещён Inference Endpoint (например, ‘aws’). [обязательный параметр]
--namespace TEXT: пространство имён, связанное с Inference Endpoint. По умолчанию используется пространство имён текущего пользователя.
--task TEXT: задача, для которой разворачивается модель (например, ‘text-classification’).
--token TEXT: токен доступа пользователя, созданный на странице https://huggingface.co/settings/tokens.
--min-replica INTEGER: минимальное количество реплик (экземпляров), которое следует держать запущенным для Inference Endpoint. [по умолчанию: 1]
--max-replica INTEGER: максимальное количество реплик (экземпляров), до которого можно масштабировать Inference Endpoint. [по умолчанию: 1]
--scale-to-zero-timeout INTEGER: Длительность в минутах, по истечении которой неактивный endpoint масштабируется до нуля.
--scaling-metric [pendingRequests|hardwareUsage]: Метрика, используемая в качестве основы для масштабирования.
--scaling-threshold FLOAT: Порог метрики масштабирования, при достижении которого инициируется увеличение масштаба. Игнорируется, если метрика масштабирования не задана.
--revision TEXT: идентификатор ревизии Git, который может быть именем ветки, тегом или хэшем коммита.
--custom-image TEXT: URL образа Docker для контейнера, в котором выполняется запуск (например, ‘nexagi/sglang:v0.5.12’). Требует ‘—framework custom’.
--engine [custom|hf-serve|llamacpp|sglang|tei|tgi|tgi-neuron|vllm|vllm-neuron]: управляемый образ движка для запуска — custom-image с (например, ‘vllm’). По умолчанию используется произвольный контейнер.
--health-route TEXT: маршрут проверки состояния, который предоставляет контейнер (например, ‘/health’). Требуется —custom-image.
--port INTEGER: порт, на котором контейнер принимает соединения (например, 30000). Требует —custom-image.
--container-registry-username TEXT: Имя пользователя, используемое для аутентификации в реестре, где размещён —custom-image.
--container-registry-password TEXT: Необязательный пароль, используемый для аутентификации в реестре, где размещён —custom-image.
--tensor-parallel-size INTEGER: количество ускорителей, на которые распределяется одна копия модели (только для движков vLLM и SGLang).
--data-parallel-size INTEGER: количество копий модели для запуска, по одной на каждый ускоритель (только для движка vLLM).
--container-command TEXT: Переопределяет точку входа контейнера, в виде строки в кавычках, разбиваемой на токены (например, “python -m sglang.launch_server”).
--container-args TEXT: Аргументы, добавляемые к entrypoint контейнера, в виде строки в кавычках, разбиваемой на токены (например, “—tp 8 —reasoning-parser qwen3”).
-e, --env TEXT: Устанавливает переменные окружения. Например, —env ENV=value
--env-file TEXT: Читает файл с переменными окружения. Используйте -, чтобы читать их из stdin.
-s, --secrets TEXT: Задаёт секретные переменные окружения. Рекомендуется использовать --secrets SECRET, чтобы читать значение из вашего окружения (например, --secrets HF_TOKEN для передачи вашего токена Hugging Face); --secrets SECRET=value сохраняет значение в истории командной строки.
--secrets-file TEXT: Читает файл с секретными переменными окружения. Используйте -, чтобы читать их из stdin.
--type [public|authenticated|private]: тип доступа к конечной точке. По умолчанию — ‘authenticated’ (доступ по токену, публично доступная).
--help: Показать это сообщение и выйти.

Примеры $ hf endpoints deploy my-endpoint —repo gpt2 —framework pytorch … $ hf endpoints deploy my-endpoint —repo openai/gpt-oss-120b —framework custom —engine vllm —custom-image vllm/vllm-openai:v0.23.0 —tensor-parallel-size 8 …

hf endpoints describe

Получите информацию о существующем конечном пункте.

Использование:

$ hf endpoints describe [OPTIONS] NAME

Аргументы:

NAME: Имя конечной точки. [обязательно]

Параметры:

--namespace TEXT: пространство имён, связанное с Inference Endpoint. По умолчанию используется пространство имён текущего пользователя.
--token TEXT: токен доступа пользователя, созданный на странице https://huggingface.co/settings/tokens.
--help: Показать это сообщение и выйти.

Примеры $ hf endpoints describe my-endpoint

hf endpoints hardware

Перечислите доступное оборудование для развертывания Inference Endpoint.

В списке отображаются только те аппаратные конфигурации, на которые пространство имён может развернуть приложение прямо сейчас: доступный статус и достаточный остаток квоты на ускорители для одного реплики. Используйте --all, чтобы отобразить все комбинации, возвращаемые API.

Квота рассчитывается на пространство имён, поэтому передавайте тот же параметр --namespace, который вы передадите в hf endpoints deploy. Цены указаны в долларах США за реплику в час.

Использование:

$ hf endpoints hardware [OPTIONS]

Параметры:

--namespace TEXT: пространство имён, связанное с Inference Endpoint. По умолчанию используется пространство имён текущего пользователя.
--vendor TEXT: показывать только оборудование, размещённое этим облачным провайдером (например, ‘aws’).
--region TEXT: показывать только оборудование, доступное в этом облачном регионе (например, ‘us-east-1’).
--accelerator TEXT: Показывать только оборудование с этим ускорителем (например, ‘cpu’, ‘gpu’, ‘neuron’).
--instance-type TEXT: показывать только оборудование данного типа инстанса (например, ‘nvidia-l4’).
-a, --all: также показывать оборудование, которое в данный момент недоступно для развертывания (недоступно, устарело или исчерпан лимит).
--token TEXT: токен доступа пользователя, созданный на странице https://huggingface.co/settings/tokens.
--help: Показать это сообщение и выйти.

Примеры $ hf endpoints hardware $ hf endpoints hardware —vendor aws —accelerator gpu

hf endpoints list

Выводит список всех Inference Endpoints для указанного пространства имён. [alias: ls]

Использование:

$ hf endpoints list [OPTIONS]

Параметры:

--namespace TEXT: пространство имён, связанное с Inference Endpoint. По умолчанию используется пространство имён текущего пользователя.
--token TEXT: токен доступа пользователя, созданный на странице https://huggingface.co/settings/tokens.
--help: Показать это сообщение и выйти.

Примеры $ hf endpoints ls $ hf endpoints ls —namespace my-org

hf endpoints list-catalog

Перечислите модели, доступные в каталоге моделей.

Использование:

$ hf endpoints list-catalog [OPTIONS]

Параметры:

--accelerator [cpu|gpu|neuron]: Показывать только рецепты, работающие на этом ускорителе.
--engine [llamacpp|sglang|tei|vllm]: показывать только рецепты, использующие этот движок инференса.
--license TEXT: показывать только модели с этой лицензией (например, ‘Apache 2.0’).
--task TEXT: показывать только модели для этой задачи (например, ‘text-generation’).
--search TEXT: поисковый запрос.
--limit INTEGER: Ограничивает количество возвращаемых моделей.
--token TEXT: токен доступа пользователя, созданный на странице https://huggingface.co/settings/tokens.
--help: Показать это сообщение и выйти.

hf endpoints pause

Приостановить конечную точку вывода.

Использование:

$ hf endpoints pause [OPTIONS] NAME

Аргументы:

NAME: Имя конечной точки. [обязательно]

Параметры:

--namespace TEXT: пространство имён, связанное с Inference Endpoint. По умолчанию используется пространство имён текущего пользователя.
--token TEXT: токен доступа пользователя, созданный на странице https://huggingface.co/settings/tokens.
--help: Показать это сообщение и выйти.

Примеры $ hf endpoints pause my-endpoint

hf endpoints resume

Возобновление Inference Endpoint.

Использование:

$ hf endpoints resume [OPTIONS] NAME

Аргументы:

NAME: Имя конечной точки. [обязательно]

Параметры:

--namespace TEXT: пространство имён, связанное с Inference Endpoint. По умолчанию используется пространство имён текущего пользователя.
--fail-if-already-running: если True, метод выбросит ошибку, если Inference Endpoint уже запущен.
--token TEXT: токен доступа пользователя, созданный на странице https://huggingface.co/settings/tokens.
--help: Показать это сообщение и выйти.

Примеры $ hf endpoints resume my-endpoint

hf endpoints scale-to-zero

Масштабируйте Inference Endpoint до нуля.

Использование:

$ hf endpoints scale-to-zero [OPTIONS] NAME

Аргументы:

NAME: Имя конечной точки. [обязательно]

Параметры:

--namespace TEXT: пространство имён, связанное с Inference Endpoint. По умолчанию используется пространство имён текущего пользователя.
--token TEXT: токен доступа пользователя, созданный на странице https://huggingface.co/settings/tokens.
--help: Показать это сообщение и выйти.

Примеры $ hf endpoints scale-to-zero my-endpoint

hf endpoints update

Обновление существующего конечного пункта.

Использование:

$ hf endpoints update [OPTIONS] NAME

Аргументы:

NAME: Имя конечной точки. [обязательно]

Параметры:

--namespace TEXT: пространство имён, связанное с Inference Endpoint. По умолчанию используется пространство имён текущего пользователя.
--repo TEXT: Имя репозитория модели, связанного с Inference Endpoint (например, ‘openai/gpt-oss-120b’).
--accelerator TEXT: аппаратный ускоритель, используемый для инференса (например, ‘cpu’).
--instance-size TEXT: размер или тип экземпляра, который будет использоваться для размещения модели (например, ‘x4’).
--instance-type TEXT: тип облачного инстанса, на котором будет развернут Inference Endpoint (например, ‘intel-icl’).
--framework TEXT: Фреймворк машинного обучения, используемый для модели (например, ‘custom’).
--revision TEXT: конкретная ревизия модели для развертывания на Inference Endpoint (например, ‘6c0e6080953db56375760c0471a8c5f2929baf11’).
--task TEXT: задача, для которой разворачивается модель (например, ‘text-classification’).
--custom-image TEXT: URL образа Docker для контейнера, в котором выполняется запуск (например, ‘nexagi/sglang:v0.5.12’). Заменяет образ, в данный момент настроенный на эндпоинте, а не дополняет его, поэтому передавайте вместе с ним настройки движка и контейнера, которые вы хотите сохранить; сначала выполните ‘hf endpoints describe NAME’, чтобы увидеть их.
--engine [custom|hf-serve|llamacpp|sglang|tei|tgi|tgi-neuron|vllm|vllm-neuron]: управляемый образ движка для запуска — custom-image с (например, ‘vllm’). По умолчанию используется произвольный контейнер.
--health-route TEXT: маршрут проверки состояния, который предоставляет контейнер (например, ‘/health’). Требуется —custom-image.
--port INTEGER: порт, на котором контейнер принимает соединения (например, 30000). Требует —custom-image.
--tensor-parallel-size INTEGER: количество ускорителей, на которые распределяется одна копия модели (только для движков vLLM и SGLang).
--data-parallel-size INTEGER: количество копий модели для запуска, по одной на каждый ускоритель (только для движка vLLM).
--container-command TEXT: Переопределяет точку входа контейнера, в виде строки в кавычках, разбиваемой на токены (например, “python -m sglang.launch_server”). Заменяет текущее значение; передайте пустую строку, чтобы очистить его.
--container-args TEXT: Аргументы, добавляемые к entrypoint контейнера, в виде строки в кавычках, разбиваемой на токены (например, “—enable-auto-tool-choice —tool-call-parser lfm2”). Заменяет аргументы, в настоящее время установленные для endpoint, а не добавляется к ним, поэтому включите те, которые хотите сохранить; сначала выполните ‘hf endpoints describe NAME’, чтобы увидеть их. Передайте пустую строку, чтобы очистить их.
--min-replica INTEGER: минимальное количество реплик (инстансов), которое следует держать запущенным для Inference Endpoint.
--max-replica INTEGER: максимальное количество реплик (экземпляров), до которого можно масштабировать Inference Endpoint.
--scale-to-zero-timeout INTEGER: Длительность в минутах, по истечении которой неактивный endpoint масштабируется до нуля.
--scaling-metric [pendingRequests|hardwareUsage]: Метрика, используемая в качестве основы для масштабирования.
--scaling-threshold FLOAT: Порог метрики масштабирования, при достижении которого инициируется увеличение масштаба. Игнорируется, если метрика масштабирования не задана.
--token TEXT: токен доступа пользователя, созданный на странице https://huggingface.co/settings/tokens.
--help: Показать это сообщение и выйти.

Примеры $ hf endpoints update my-endpoint —min-replica 2 $ hf endpoints update my-endpoint —tensor-parallel-size 8 $ hf endpoints update my-endpoint —container-args “—enable-auto-tool-choice —tool-call-parser lfm2”

hf env

Вывод информации об окружении.

Использование:

$ hf env [OPTIONS]

Параметры:

--help: Показать это сообщение и выйти.

hf extensions

Управление расширениями hf CLI. [alias: ext]

Предупреждение о безопасности: расширения — это исполняемые файлы или пакеты Python сторонних разработчиков. Устанавливайте их только из доверенных источников.

Использование:

$ hf extensions [OPTIONS] COMMAND [ARGS]...

Параметры:

--help: Показать это сообщение и выйти.

Команды:

exec: Запуск установленного расширения.
install: установка расширения из публичного репозитория GitHub.
list: Список установленных команд расширений. [alias: ls]
remove: Удалить установленное расширение. [alias: rm]
search: поиск расширений, доступных на GitHub (с тегом ‘hf-extension’).
update: обновляет установленное расширение (расширения) до последней версии.

hf extensions exec

Выполнить установленное расширение.

Использование:

$ hf extensions exec [OPTIONS] NAME

Аргументы:

NAME: Имя расширения (с префиксом hf- или без него). [обязательное поле]

Параметры:

--help: Показать это сообщение и выйти.

Примеры $ hf extensions exec claude — —help $ hf extensions exec claude —model zai-org/GLM-5

hf extensions install

Установите расширение из публичного репозитория GitHub.

Предупреждение о безопасности: это устанавливает исполняемый файл или пакет Python стороннего разработчика. Устанавливайте только из источников, которым вы доверяете.

Использование:

$ hf extensions install [OPTIONS] REPO_ID

Аргументы:

REPO_ID: репозиторий расширения GitHub в формате [OWNER/]hf-<name>. [обязательный]

Параметры:

--force: Перезаписать, если уже установлено.
--help: Показать это сообщение и выйти.

Примеры $ hf extensions install hf-claude $ hf extensions install hanouticelina/hf-claude $ hf extensions install alvarobartt/hf-mem

hf extensions list

Список установленных команд расширений. [alias: ls]

Использование:

$ hf extensions list [OPTIONS]

Параметры:

--help: Показать это сообщение и выйти.

Примеры $ hf extensions list

hf extensions remove

Удалить установленное расширение. [alias: rm]

Использование:

$ hf extensions remove [OPTIONS] NAME

Аргументы:

NAME: Имя расширения для удаления (с префиксом hf- или без него). [обязательный параметр]

Параметры:

--help: Показать это сообщение и выйти.

Примеры $ hf extensions remove claude

hf extensions search

Поиск расширений, доступных на GitHub (с тегом ‘hf-extension’).

Использование:

$ hf extensions search [OPTIONS]

Параметры:

--help: Показать это сообщение и выйти.

Примеры $ hf extensions search

hf extensions update

Обновите установленное расширение до последней версии.

Использование:

$ hf extensions update [OPTIONS] [NAME]

Аргументы:

[NAME]: расширение для обновления (с префиксом hf- или без него, при необходимости в формате OWNER/hf-<name>). Если не указано, проверяются все установленные расширения, а устаревшие обновляются.

Параметры:

--help: Показать это сообщение и выйти.

Примеры $ hf extensions update $ hf extensions update hf-claude $ hf extensions update alvarobartt/hf-mem

hf jobs

Запуск и управление задачами на Hub.

Использование:

$ hf jobs [OPTIONS] COMMAND [ARGS]...

Параметры:

--help: Показать это сообщение и выйти.

Команды:

cancel: отмена задачи
expose: Заменить открытые порты в запущенном Job.
hardware: список доступных вариантов аппаратного обеспечения для Jobs
inspect: отображение подробной информации об одном или нескольких Jobs
labels: Обновить метки для Job.
list: Список задач. [псевдоним: ls, ps]
logs: Получить журналы задания.
rerun: Запустить новую Job со спецификацией существующей Job.
run: Запуск задачи.
scheduled: создание и управление запланированными Jobs на Hub.
ssh: подключение по SSH к работающему Job.
stats: Получает статистику и метрики использования ресурсов Jobs.
uv: Запуск скриптов UV (Python с встроенными зависимостями) на инфраструктуре HF.
wait: Ожидание, пока одна или несколько задач не перейдут в конечное состояние.

hf jobs cancel

Отмена задания

Использование:

$ hf jobs cancel [OPTIONS] JOB_ID

Аргументы:

JOB_ID: идентификатор задания (или ‘namespace/job_id’) [обязательный]

Параметры:

--namespace TEXT: пространство имён, в котором будет выполняться задание. По умолчанию используется пространство имён текущего пользователя.
--token TEXT: токен доступа пользователя, созданный на странице https://huggingface.co/settings/tokens.
--help: Показать это сообщение и выйти.

Примеры $ hf jobs cancel <job_id>

hf jobs expose

Замените открытые порты в запущенном Job.

Использование:

$ hf jobs expose [OPTIONS] JOB_ID [PORTS]...

Аргументы:

JOB_ID: идентификатор задания (или ‘namespace/job_id’) [обязательный]
[PORTS]...: Порты, которые нужно открыть через прокси задач. Для доступа требуется токен HF с правами на чтение в пространстве имён задачи.

Параметры:

--public INTEGER: Открыть порт без аутентификации. Повторите флаг для нескольких портов. Передавать порт как позиционный аргумент не требуется.
--clear: закрывает все открытые порты.
--namespace TEXT: пространство имён, в котором будет выполняться задание. По умолчанию используется пространство имён текущего пользователя.
--token TEXT: токен доступа пользователя, созданный на странице https://huggingface.co/settings/tokens.
--help: Показать это сообщение и выйти.

Примеры $ hf jobs expose <job_id> 8000 $ hf jobs expose <job_id> 8000 —public 9000 $ hf jobs expose <job_id> —clear

hf jobs hardware

Список доступных вариантов аппаратного обеспечения для Jobs

Использование:

$ hf jobs hardware [OPTIONS]

Параметры:

--help: Показать это сообщение и выйти.

Примеры $ hf jobs hardware

hf jobs inspect

Отображение подробной информации об одном или нескольких Jobs

Использование:

$ hf jobs inspect [OPTIONS] JOB_IDS...

Аргументы:

JOB_IDS...: идентификаторы задач для проверки (или ‘namespace/job_id’) [обязательно]

Параметры:

--namespace TEXT: пространство имён, в котором будет выполняться задание. По умолчанию используется пространство имён текущего пользователя.
--token TEXT: токен доступа пользователя, созданный на странице https://huggingface.co/settings/tokens.
--help: Показать это сообщение и выйти.

Примеры $ hf jobs inspect <job_id>

hf jobs labels

Обновление меток для Job. Передача —label заменяет все существующие метки; передача только —name сохраняет их.

Использование:

$ hf jobs labels [OPTIONS] JOB_ID

Аргументы:

JOB_ID: идентификатор задания (или ‘namespace/job_id’) [обязательный]

Параметры:

--name TEXT: Имя задачи. Сохраняется как метка name. Имена не обязаны быть уникальными. По умолчанию используется имя образа или скрипта плюс короткий хеш разрешённой конфигурации запуска.
-l, --label TEXT: Установить метки. Например, —label KEY=VALUE или —label LABEL
--clear: Удалить все метки из задания.
--namespace TEXT: пространство имён, в котором будет выполняться задание. По умолчанию используется пространство имён текущего пользователя.
--token TEXT: токен доступа пользователя, созданный на странице https://huggingface.co/settings/tokens.
--help: Показать это сообщение и выйти.

Примеры $ hf jobs labels <job_id> —name training-v2 $ hf jobs labels <job_id> —label env=prod —label team=ml $ hf jobs labels <job_id> —clear

hf jobs list | ls | ps

Список заданий.

Используйте --status для фильтрации по статусу (см. JobStage для возможных значений) и --label для фильтрации по меткам key=value. Для отображения в списке Job должен соответствовать каждому фильтру.

Использование:

$ hf jobs list | ls | ps [OPTIONS]

Параметры:

-a, --all: показывать все задачи (по умолчанию показываются задачи в состоянии «выполняется» и «в очереди»). Не может использоваться вместе с —status.
--status [COMPLETED|CANCELED|ERROR|DELETED|SCHEDULING|RUNNING]: показывать только Jobs с указанным статусом. Значения разделяются запятыми или указываются повторно, например --status running,scheduling.
-l, --label TEXT: показывать только Jobs с указанной меткой key=value. Повторяйте для нескольких меток, например --label env=prod --label team=ml.
--name TEXT: показывать только Jobs с указанным именем (сокращение для --label name=NAME).
--limit INTEGER: Максимальное количество отображаемых Jobs. Установите 0, чтобы показать все (без ограничения). [по умолчанию: 100]
--namespace TEXT: пространство имён, в котором будет выполняться задание. По умолчанию используется пространство имён текущего пользователя.
--token TEXT: токен доступа пользователя, созданный на странице https://huggingface.co/settings/tokens.
--help: Показать это сообщение и выйти.

Примеры $ hf jobs ls $ hf jobs ls -a $ hf jobs ls —status running,scheduling $ hf jobs ls —name training-v2 $ hf jobs ls —label env=prod —label team=ml $ hf jobs ls —all —label hf-sandbox=1

hf jobs logs

Получить журналы Job.

По умолчанию выводит текущие доступные журналы и завершает работу (не блокируя процесс). Используйте —follow/-f, чтобы получать журналы в реальном времени до завершения работы задания. Используйте —tail/-n, чтобы ограничить количество возвращаемых строк (на стороне сервера, если поддерживается).

Примечание: при завершении потока журнала процесс завершается, независимо от того, успешно ли завершилась задача или завершилась с ошибкой. Выполните hf jobs inspect <job_id>, чтобы проверить итоговый статус.

Использование:

$ hf jobs logs [OPTIONS] JOB_ID

Аргументы:

JOB_ID: идентификатор задания (или ‘namespace/job_id’) [обязательный]

Параметры:

-f, --follow: Следить за выводом журнала (стримить до завершения задания). Без этого флага выводятся только доступные в данный момент записи журнала.
-n, --tail INTEGER: количество строк, отображаемых с конца журнала. В сочетании с —follow начинает передачу потока с последних N строк.
--namespace TEXT: пространство имён, в котором будет выполняться задание. По умолчанию используется пространство имён текущего пользователя.
--token TEXT: токен доступа пользователя, созданный на странице https://huggingface.co/settings/tokens.
--help: Показать это сообщение и выйти.

Примеры $ hf jobs logs <job_id> $ hf jobs logs -f <job_id> $ hf jobs logs —tail 20 <job_id> $ hf jobs logs -f —tail 100 <job_id>

hf jobs rerun

Запустите новую задачу со спецификацией существующей задачи.

Использование:

$ hf jobs rerun [OPTIONS] JOB_ID

Аргументы:

JOB_ID: идентификатор задания (или ‘namespace/job_id’) [обязательный]

Параметры:

-d, --detach: Запустить Job в фоновом режиме и вывести Job ID.
--namespace TEXT: пространство имён, в котором будет выполняться задание. По умолчанию используется пространство имён текущего пользователя.
--token TEXT: токен доступа пользователя, созданный на странице https://huggingface.co/settings/tokens.
--help: Показать это сообщение и выйти.

Примеры $ hf jobs rerun <job_id> $ hf jobs rerun —detach <job_id>

hf jobs run

Запустите Job.

Использование:

$ hf jobs run [OPTIONS] IMAGE COMMAND...

Аргументы:

IMAGE: образ Docker, который будет использоваться. [обязательный параметр]
COMMAND...: команда для запуска. [обязательный параметр]

Параметры:

-e, --env TEXT: Устанавливает переменные окружения. Например, —env ENV=value
-s, --secrets TEXT: Задаёт секретные переменные окружения. Рекомендуется использовать --secrets SECRET, чтобы читать значение из вашего окружения (например, --secrets HF_TOKEN для передачи вашего токена Hugging Face); --secrets SECRET=value сохраняет значение в истории командной строки.
--name TEXT: Имя задачи. Сохраняется как метка name. Имена не обязаны быть уникальными. По умолчанию используется имя образа или скрипта плюс короткий хеш разрешённой конфигурации запуска.
-l, --label TEXT: Установить метки. Например, —label KEY=VALUE или —label LABEL
-v, --volume TEXT: Подключить один или несколько томов. Формат: hf://[TYPE/]SOURCE:/MOUNT_PATH[:ro|:rw] или LOCAL_DIR:/MOUNT_PATH[:ro|:rw]. TYPE — одно из значений: models, datasets, spaces, buckets. Если TYPE не указан, по умолчанию используется models. models, datasets и spaces всегда подключаются только для чтения. buckets по умолчанию подключаются с правами на чтение и запись. Источник в виде локального каталога сначала синхронизируется с bucket, а по умолчанию подключается только для чтения. Например, -v hf://datasets/org/ds:/data или -v hf://buckets/org/b:/mnt:ro или -v ./inputs:/inputs
--env-file TEXT: Читает файл с переменными окружения. Используйте -, чтобы читать их из stdin.
--secrets-file TEXT: Читает файл с секретными переменными окружения. Используйте -, чтобы читать их из stdin.
--flavor [cpu-basic|cpu-upgrade|cpu-performance|cpu-xl|t4-small|t4-medium|l4x1|l4x4|l40sx1|l40sx4|l40sx8|a10g-small|a10g-large|a10g-largex2|a10g-largex4|a100-large|a100x4|a100x8|h200|h200x2|h200x4|h200x8|rtx-pro-6000|rtx-pro-6000x2|rtx-pro-6000x4|rtx-pro-6000x8]: Тип аппаратного обеспечения. Выполните команду ‘hf jobs hardware’, чтобы получить список доступных типов. По умолчанию используется cpu-basic.
--timeout TEXT: Максимальная длительность: целое число с s (секунды, по умолчанию), m (минуты), h (часы) или d (дни).
--attempts INTEGER RANGE: Максимальное количество попыток, включая первый запуск. По умолчанию 1. [x>=1]
-d, --detach: Запустить Job в фоновом режиме и вывести Job ID.
--dry-run: Вывести разрешённую конфигурацию Job без отправки Job.
--expose INTEGER: Открыть порт контейнера через прокси задач. Повторяйте флаг для нескольких портов (например, --expose 8000 --expose 8001). Каждый открытый порт доступен по публичному домену задач; для доступа требуется токен HF с правами на чтение в пространстве имён задачи.
--expose-public INTEGER: Открыть порт контейнера через прокси задач без аутентификации. Повторите флаг для нескольких портов. Передавать порт с --expose дополнительно не нужно.
--ssh: делает контейнер задачи доступным по SSH. Подключитесь с помощью hf jobs ssh <job_id>. Требуется публичный SSH-ключ, зарегистрированный на https://huggingface.co/settings/keys.
--network-group TEXT: Присоединиться к сетевой группе. Задачи в одном и том же namespace и resource group, объединённые в одну группу, размещаются вместе и могут взаимодействовать друг с другом на любом порту. Внутри каждого участника $HF_NETWORK_GROUP_HOSTNAME разрешается в адрес каждого участника. Допускаются строчные буквы, цифры и дефисы, максимум 46 символов.
--network-alias TEXT: Зарезервировать псевдоним в сетевой группе. Участники обращаются к задачам, зарезервировавшим его, по адресу ${HF_NETWORK_GROUP_PREFIX}<alias>. Повторите флаг для нескольких псевдонимов. Допускаются строчные буквы, цифры и дефисы, максимум 34 символа, уникальность в пределах задачи. Требуется --network-group.
--resource-group-id TEXT: идентификатор группы ресурсов, в которой будет создан Job. Используется для управления доступом к ресурсам в рамках организации, а также для функций атрибуции затрат и ограничения расходов.
--namespace TEXT: пространство имён, в котором будет выполняться задание. По умолчанию используется пространство имён текущего пользователя.
--token TEXT: токен доступа пользователя, созданный на странице https://huggingface.co/settings/tokens.
--format [agent|auto|human|json|quiet]: Формат вывода. По умолчанию установлено значение ‘auto’, которое выбирает ‘agent’ или ‘human’ в зависимости от терминала.
--json: вывод в формате JSON. Эквивалентно ‘—format json’.
-q, --quiet: Тихий вывод (один ID на строку). Эквивалентно ‘—format quiet’.
--help: Показать это сообщение и выйти.

Примеры $ hf jobs run —name hello-world python:3.12 python -c ‘print(“Hello!”)’ $ hf jobs run —detach python:3.12 python script.py $ hf jobs run -e FOO=foo python:3.12 python script.py $ hf jobs run —secrets HF_TOKEN python:3.12 python script.py $ hf jobs run -v hf://org/my-model:/data -v hf://buckets/org/b:/mnt python:3.12 python script.py

hf jobs scheduled

Создание и управление запланированными Jobs на Hub.

Использование:

$ hf jobs scheduled [OPTIONS] COMMAND [ARGS]...

Параметры:

--help: Показать это сообщение и выйти.

Команды:

delete: Удалить запланированную Job.
inspect: отображение подробной информации об одном или нескольких запланированных Jobs
labels: Обновить метки в запланированном Job.
list: Список запланированных Jobs. [alias: ls, ps]
reschedule: Изменение времени запуска запланированной задачи Job.
resume: Возобновить (снять с паузы) запланированную Job.
run: запланировать Job.
suspend: приостановить (пауза) запланированную Job.
trigger: Запустить запланированную Job немедленно (не изменяет расписание).
uv: Планирование сценариев UV на инфраструктуре HF.

hf jobs scheduled delete

Удалить запланированную задачу.

Использование:

$ hf jobs scheduled delete [OPTIONS] SCHEDULED_JOB_ID

Аргументы:

SCHEDULED_JOB_ID: Идентификатор запланированной задачи (или ‘namespace/scheduled_job_id’) [обязательный]

Параметры:

--namespace TEXT: пространство имён, в котором будет выполняться задание. По умолчанию используется пространство имён текущего пользователя.
--token TEXT: токен доступа пользователя, созданный на странице https://huggingface.co/settings/tokens.
--help: Показать это сообщение и выйти.

Примеры $ hf jobs scheduled delete <id>

hf jobs scheduled inspect

Отображение подробной информации об одном или нескольких запланированных Jobs

Использование:

$ hf jobs scheduled inspect [OPTIONS] SCHEDULED_JOB_IDS...

Аргументы:

SCHEDULED_JOB_IDS...: Идентификаторы запланированных задач для проверки (или ‘namespace/scheduled_job_id’) [обязательный]

Параметры:

--namespace TEXT: пространство имён, в котором будет выполняться задание. По умолчанию используется пространство имён текущего пользователя.
--token TEXT: токен доступа пользователя, созданный на странице https://huggingface.co/settings/tokens.
--help: Показать это сообщение и выйти.

Примеры $ hf jobs scheduled inspect <id>

hf jobs scheduled labels

Обновление меток для запланированной задачи (Job). Передача —label заменяет все существующие метки; передача только —name сохраняет их.

Использование:

$ hf jobs scheduled labels [OPTIONS] SCHEDULED_JOB_ID

Аргументы:

SCHEDULED_JOB_ID: Идентификатор запланированной задачи (или ‘namespace/scheduled_job_id’) [обязательный]

Параметры:

--name TEXT: Имя задачи. Сохраняется как метка name. Имена не обязаны быть уникальными. По умолчанию используется имя образа или скрипта плюс короткий хеш разрешённой конфигурации запуска.
-l, --label TEXT: Установить метки. Например, —label KEY=VALUE или —label LABEL
--clear: Удалить все метки из запланированной задачи.
--namespace TEXT: пространство имён, в котором будет выполняться задание. По умолчанию используется пространство имён текущего пользователя.
--token TEXT: токен доступа пользователя, созданный на странице https://huggingface.co/settings/tokens.
--help: Показать это сообщение и выйти.

Примеры $ hf jobs scheduled labels <id> —name daily-script $ hf jobs scheduled labels <id> —label env=prod —label team=ml $ hf jobs scheduled labels <id> —clear

hf jobs scheduled list | ls | ps

Список запланированных задач.

Используйте --status для фильтрации по статусу (active или suspended) и --label для фильтрации по меткам key=value. Запланированный Job должен соответствовать каждому фильтру, чтобы быть включённым в список.

Использование:

$ hf jobs scheduled list | ls | ps [OPTIONS]

Параметры:

-a, --all: Показывает все запланированные Jobs (по умолчанию приостановленные скрыты). Нельзя использовать вместе с —status.
--status [active|suspended]: показывать только запланированные Jobs с указанным статусом. Значения разделяются запятой или указываются повторно, например --status suspended.
-l, --label TEXT: показывать только запланированные Jobs с указанной меткой key=value. Повторяйте параметр, чтобы указать несколько меток, например --label env=prod --label team=ml.
--name TEXT: показывать только запланированные Jobs с указанным именем (сокращение для --label name=NAME).
--namespace TEXT: пространство имён, в котором будет выполняться задание. По умолчанию используется пространство имён текущего пользователя.
--token TEXT: токен доступа пользователя, созданный на странице https://huggingface.co/settings/tokens.
--help: Показать это сообщение и выйти.

Примеры $ hf jobs scheduled ls $ hf jobs scheduled ls -a $ hf jobs scheduled ls —status suspended $ hf jobs scheduled ls —name daily-script $ hf jobs scheduled ls —label env=prod —label team=ml

hf jobs scheduled reschedule

Изменение времени запуска запланированной задачи.

Использование:

$ hf jobs scheduled reschedule [OPTIONS] SCHEDULED_JOB_ID SCHEDULE

Аргументы:

SCHEDULED_JOB_ID: Идентификатор запланированной задачи (или ‘namespace/scheduled_job_id’) [обязательный]
SCHEDULE: одно из значений @annually, @yearly, @monthly, @weekly, @daily, @hourly или выражение CRON-расписания. [обязательное поле]

Параметры:

--namespace TEXT: пространство имён, в котором будет выполняться задание. По умолчанию используется пространство имён текущего пользователя.
--token TEXT: токен доступа пользователя, созданный на странице https://huggingface.co/settings/tokens.
--help: Показать это сообщение и выйти.

Примеры $ hf jobs scheduled reschedule <id> “0 9 * * 1”

hf jobs scheduled resume

Возобновить (снять с паузы) запланированную задачу.

Использование:

$ hf jobs scheduled resume [OPTIONS] SCHEDULED_JOB_ID

Аргументы:

SCHEDULED_JOB_ID: Идентификатор запланированной задачи (или ‘namespace/scheduled_job_id’) [обязательный]

Параметры:

--namespace TEXT: пространство имён, в котором будет выполняться задание. По умолчанию используется пространство имён текущего пользователя.
--token TEXT: токен доступа пользователя, созданный на странице https://huggingface.co/settings/tokens.
--help: Показать это сообщение и выйти.

Примеры $ hf jobs scheduled resume <id>

hf jobs scheduled run

Запланируйте задачу.

Использование:

$ hf jobs scheduled run [OPTIONS] SCHEDULE IMAGE COMMAND...

Аргументы:

SCHEDULE: одно из значений @annually, @yearly, @monthly, @weekly, @daily, @hourly или выражение CRON-расписания. [обязательное поле]
IMAGE: образ Docker, который будет использоваться. [обязательный параметр]
COMMAND...: команда для запуска. [обязательный параметр]

Параметры:

--suspend / --no-suspend: приостановить запланированную Job
--concurrency / --no-concurrency: разрешает одновременный запуск нескольких экземпляров этой задачи
-e, --env TEXT: Устанавливает переменные окружения. Например, —env ENV=value
-s, --secrets TEXT: Задаёт секретные переменные окружения. Рекомендуется использовать --secrets SECRET, чтобы читать значение из вашего окружения (например, --secrets HF_TOKEN для передачи вашего токена Hugging Face); --secrets SECRET=value сохраняет значение в истории командной строки.
--name TEXT: Имя задачи. Сохраняется как метка name. Имена не обязаны быть уникальными. По умолчанию используется имя образа или скрипта плюс короткий хеш разрешённой конфигурации запуска.
-l, --label TEXT: Установить метки. Например, —label KEY=VALUE или —label LABEL
-v, --volume TEXT: Подключить один или несколько томов. Формат: hf://[TYPE/]SOURCE:/MOUNT_PATH[:ro|:rw] или LOCAL_DIR:/MOUNT_PATH[:ro|:rw]. TYPE — одно из значений: models, datasets, spaces, buckets. Если TYPE не указан, по умолчанию используется models. models, datasets и spaces всегда подключаются только для чтения. buckets по умолчанию подключаются с правами на чтение и запись. Источник в виде локального каталога сначала синхронизируется с bucket, а по умолчанию подключается только для чтения. Например, -v hf://datasets/org/ds:/data или -v hf://buckets/org/b:/mnt:ro или -v ./inputs:/inputs
--env-file TEXT: Читает файл с переменными окружения. Используйте -, чтобы читать их из stdin.
--secrets-file TEXT: Читает файл с секретными переменными окружения. Используйте -, чтобы читать их из stdin.
--flavor [cpu-basic|cpu-upgrade|cpu-performance|cpu-xl|t4-small|t4-medium|l4x1|l4x4|l40sx1|l40sx4|l40sx8|a10g-small|a10g-large|a10g-largex2|a10g-largex4|a100-large|a100x4|a100x8|h200|h200x2|h200x4|h200x8|rtx-pro-6000|rtx-pro-6000x2|rtx-pro-6000x4|rtx-pro-6000x8]: Тип аппаратного обеспечения. Выполните команду ‘hf jobs hardware’, чтобы получить список доступных типов. По умолчанию используется cpu-basic.
--timeout TEXT: Максимальная длительность: целое число с s (секунды, по умолчанию), m (минуты), h (часы) или d (дни).
--attempts INTEGER RANGE: Максимальное количество попыток, включая первый запуск. По умолчанию 1. [x>=1]
--dry-run: Вывести разрешённую конфигурацию Job без отправки Job.
--expose INTEGER: Открыть порт контейнера через прокси задач. Повторяйте флаг для нескольких портов (например, --expose 8000 --expose 8001). Каждый открытый порт доступен по публичному домену задач; для доступа требуется токен HF с правами на чтение в пространстве имён задачи.
--expose-public INTEGER: Открыть порт контейнера через прокси задач без аутентификации. Повторите флаг для нескольких портов. Передавать порт с --expose дополнительно не нужно.
--resource-group-id TEXT: идентификатор группы ресурсов, в которой будет создан Job. Используется для управления доступом к ресурсам в рамках организации, а также для функций атрибуции затрат и ограничения расходов.
--namespace TEXT: пространство имён, в котором будет выполняться задание. По умолчанию используется пространство имён текущего пользователя.
--token TEXT: токен доступа пользователя, созданный на странице https://huggingface.co/settings/tokens.
--format [agent|auto|human|json|quiet]: Формат вывода. По умолчанию установлено значение ‘auto’, которое выбирает ‘agent’ или ‘human’ в зависимости от терминала.
--json: вывод в формате JSON. Эквивалентно ‘—format json’.
-q, --quiet: Тихий вывод (один ID на строку). Эквивалентно ‘—format quiet’.
--help: Показать это сообщение и выйти.

Примеры $ hf jobs scheduled run “0 0 * * *” —name daily-script python:3.12 python script.py

hf jobs scheduled suspend

Приостановить запланированную задачу.

Использование:

$ hf jobs scheduled suspend [OPTIONS] SCHEDULED_JOB_ID

Аргументы:

SCHEDULED_JOB_ID: Идентификатор запланированной задачи (или ‘namespace/scheduled_job_id’) [обязательный]

Параметры:

--namespace TEXT: пространство имён, в котором будет выполняться задание. По умолчанию используется пространство имён текущего пользователя.
--token TEXT: токен доступа пользователя, созданный на странице https://huggingface.co/settings/tokens.
--help: Показать это сообщение и выйти.

Примеры $ hf jobs scheduled suspend <id>

hf jobs scheduled trigger

Запустить запланированную Job немедленно (не изменяет расписание).

Использование:

$ hf jobs scheduled trigger [OPTIONS] SCHEDULED_JOB_ID

Аргументы:

SCHEDULED_JOB_ID: Идентификатор запланированной задачи (или ‘namespace/scheduled_job_id’) [обязательный]

Параметры:

--namespace TEXT: пространство имён, в котором будет выполняться задание. По умолчанию используется пространство имён текущего пользователя.
--token TEXT: токен доступа пользователя, созданный на странице https://huggingface.co/settings/tokens.
--help: Показать это сообщение и выйти.

Примеры $ hf jobs scheduled trigger <id>

hf jobs scheduled uv

Запланируйте выполнение скриптов UV на инфраструктуре HF.

Использование:

$ hf jobs scheduled uv [OPTIONS] COMMAND [ARGS]...

Параметры:

--help: Показать это сообщение и выйти.

Команды:

run: Запуск UV-скрипта (локального файла или URL) на инфраструктуре HF

hf jobs scheduled uv run

Запуск UV-скрипта (локального файла или URL) на инфраструктуре HF

Использование:

$ hf jobs scheduled uv run [OPTIONS] SCHEDULE SCRIPT [SCRIPT_ARGS]...

Аргументы:

SCHEDULE: одно из значений @annually, @yearly, @monthly, @weekly, @daily, @hourly или выражение CRON-расписания. [обязательное поле]
SCRIPT: UV-скрипт для запуска (локальный файл или URL) [обязательный]
[SCRIPT_ARGS]...: аргументы для скрипта

Параметры:

--suspend / --no-suspend: приостановить запланированную Job
--concurrency / --no-concurrency: разрешает одновременный запуск нескольких экземпляров этой задачи
--image TEXT: Используйте собственный образ Docker с установленным uv.
--flavor [cpu-basic|cpu-upgrade|cpu-performance|cpu-xl|t4-small|t4-medium|l4x1|l4x4|l40sx1|l40sx4|l40sx8|a10g-small|a10g-large|a10g-largex2|a10g-largex4|a100-large|a100x4|a100x8|h200|h200x2|h200x4|h200x8|rtx-pro-6000|rtx-pro-6000x2|rtx-pro-6000x4|rtx-pro-6000x8]: Тип аппаратного обеспечения. Выполните команду ‘hf jobs hardware’, чтобы получить список доступных типов. По умолчанию используется cpu-basic.
-e, --env TEXT: Устанавливает переменные окружения. Например, —env ENV=value
-s, --secrets TEXT: Задаёт секретные переменные окружения. Рекомендуется использовать --secrets SECRET, чтобы читать значение из вашего окружения (например, --secrets HF_TOKEN для передачи вашего токена Hugging Face); --secrets SECRET=value сохраняет значение в истории командной строки.
--name TEXT: Имя задачи. Сохраняется как метка name. Имена не обязаны быть уникальными. По умолчанию используется имя образа или скрипта плюс короткий хеш разрешённой конфигурации запуска.
-l, --label TEXT: Установить метки. Например, —label KEY=VALUE или —label LABEL
-v, --volume TEXT: Подключить один или несколько томов. Формат: hf://[TYPE/]SOURCE:/MOUNT_PATH[:ro|:rw] или LOCAL_DIR:/MOUNT_PATH[:ro|:rw]. TYPE — одно из значений: models, datasets, spaces, buckets. Если TYPE не указан, по умолчанию используется models. models, datasets и spaces всегда подключаются только для чтения. buckets по умолчанию подключаются с правами на чтение и запись. Источник в виде локального каталога сначала синхронизируется с bucket, а по умолчанию подключается только для чтения. Например, -v hf://datasets/org/ds:/data или -v hf://buckets/org/b:/mnt:ro или -v ./inputs:/inputs
--env-file TEXT: Читает файл с переменными окружения. Используйте -, чтобы читать их из stdin.
--secrets-file TEXT: Читает файл с секретными переменными окружения. Используйте -, чтобы читать их из stdin.
--timeout TEXT: Максимальная длительность: целое число с s (секунды, по умолчанию), m (минуты), h (часы) или d (дни).
--attempts INTEGER RANGE: Максимальное количество попыток, включая первый запуск. По умолчанию 1. [x>=1]
--dry-run: Вывести разрешённую конфигурацию Job без отправки Job.
--expose INTEGER: Открыть порт контейнера через прокси задач. Повторяйте флаг для нескольких портов (например, --expose 8000 --expose 8001). Каждый открытый порт доступен по публичному домену задач; для доступа требуется токен HF с правами на чтение в пространстве имён задачи.
--expose-public INTEGER: Открыть порт контейнера через прокси задач без аутентификации. Повторите флаг для нескольких портов. Передавать порт с --expose дополнительно не нужно.
--resource-group-id TEXT: идентификатор группы ресурсов, в которой будет создан Job. Используется для управления доступом к ресурсам в рамках организации, а также для функций атрибуции затрат и ограничения расходов.
--namespace TEXT: пространство имён, в котором будет выполняться задание. По умолчанию используется пространство имён текущего пользователя.
--token TEXT: токен доступа пользователя, созданный на странице https://huggingface.co/settings/tokens.
--with TEXT: Запуск с установленными указанными пакетами
-p, --python TEXT: Интерпретатор Python, используемый для среды выполнения
--format [agent|auto|human|json|quiet]: Формат вывода. По умолчанию установлено значение ‘auto’, которое выбирает ‘agent’ или ‘human’ в зависимости от терминала.
--json: вывод в формате JSON. Эквивалентно ‘—format json’.
-q, --quiet: Тихий вывод (один ID на строку). Эквивалентно ‘—format quiet’.
--help: Показать это сообщение и выйти.

Примеры $ hf jobs scheduled uv run “0 0 * * ” —name daily-script script.py $ hf jobs scheduled uv run “0 0 * *” script.py —with pandas

hf jobs ssh

Подключитесь по SSH к запущенной задаче.

Если Job ещё не запущен, ожидает, пока он перейдёт в состояние RUNNING, перед подключением. Требуется, чтобы Job был запущен с включённым SSH (hf jobs run --ssh ...), а ваш публичный SSH-ключ был зарегистрирован на https://huggingface.co/settings/keys.

Использование:

$ hf jobs ssh [OPTIONS] JOB_ID

Аргументы:

JOB_ID: идентификатор задания (или ‘namespace/job_id’) [обязательный]

Параметры:

-i, --identity-file PATH: Путь к файлу SSH-идентификации (передаётся в ssh -i).
--dry-run: Вывести команду SSH вместо её выполнения.
--namespace TEXT: пространство имён, в котором будет выполняться задание. По умолчанию используется пространство имён текущего пользователя.
--token TEXT: токен доступа пользователя, созданный на странице https://huggingface.co/settings/tokens.
--help: Показать это сообщение и выйти.

Примеры $ hf jobs ssh <job_id> $ hf jobs ssh <job_id> —dry-run $ hf jobs ssh <job_id> -i ~/.ssh/id_ed25519

hf jobs stats

Получите статистику и метрики использования ресурсов для Jobs.

По умолчанию выводит снимок текущей статистики и завершает работу (не блокируя процесс). Используйте —follow/-f, чтобы отображать статистику в реальном времени до завершения Jobs.

Использование:

$ hf jobs stats [OPTIONS] [JOB_IDS]...

Аргументы:

[JOB_IDS]...: идентификаторы задач (или ‘namespace/job_id’)

Параметры:

-f, --follow: Следить за выводом статистики (живой режим до завершения Jobs). Без этого флага выводится один снимок.
--namespace TEXT: пространство имён, в котором будет выполняться задание. По умолчанию используется пространство имён текущего пользователя.
--token TEXT: токен доступа пользователя, созданный на странице https://huggingface.co/settings/tokens.
--help: Показать это сообщение и выйти.

Примеры $ hf jobs stats $ hf jobs stats <job_id> $ hf jobs stats -f <job_id>

hf jobs uv

Запуск скриптов UV (Python с встроенными зависимостями) на инфраструктуре HF.

Использование:

$ hf jobs uv [OPTIONS] COMMAND [ARGS]...

Параметры:

--help: Показать это сообщение и выйти.

Команды:

run: Запуск UV-скрипта (локального файла или URL) на инфраструктуре HF

hf jobs uv run

Запуск UV-скрипта (локального файла или URL) на инфраструктуре HF

Использование:

$ hf jobs uv run [OPTIONS] SCRIPT [SCRIPT_ARGS]...

Аргументы:

SCRIPT: UV-скрипт для запуска (локальный файл или URL) [обязательный]
[SCRIPT_ARGS]...: аргументы для скрипта

Параметры:

--image TEXT: Используйте собственный образ Docker с установленным uv.
--flavor [cpu-basic|cpu-upgrade|cpu-performance|cpu-xl|t4-small|t4-medium|l4x1|l4x4|l40sx1|l40sx4|l40sx8|a10g-small|a10g-large|a10g-largex2|a10g-largex4|a100-large|a100x4|a100x8|h200|h200x2|h200x4|h200x8|rtx-pro-6000|rtx-pro-6000x2|rtx-pro-6000x4|rtx-pro-6000x8]: Тип аппаратного обеспечения. Выполните команду ‘hf jobs hardware’, чтобы получить список доступных типов. По умолчанию используется cpu-basic.
-e, --env TEXT: Устанавливает переменные окружения. Например, —env ENV=value
-s, --secrets TEXT: Задаёт секретные переменные окружения. Рекомендуется использовать --secrets SECRET, чтобы читать значение из вашего окружения (например, --secrets HF_TOKEN для передачи вашего токена Hugging Face); --secrets SECRET=value сохраняет значение в истории командной строки.
--name TEXT: Имя задачи. Сохраняется как метка name. Имена не обязаны быть уникальными. По умолчанию используется имя образа или скрипта плюс короткий хеш разрешённой конфигурации запуска.
-l, --label TEXT: Установить метки. Например, —label KEY=VALUE или —label LABEL
-v, --volume TEXT: Подключить один или несколько томов. Формат: hf://[TYPE/]SOURCE:/MOUNT_PATH[:ro|:rw] или LOCAL_DIR:/MOUNT_PATH[:ro|:rw]. TYPE — одно из значений: models, datasets, spaces, buckets. Если TYPE не указан, по умолчанию используется models. models, datasets и spaces всегда подключаются только для чтения. buckets по умолчанию подключаются с правами на чтение и запись. Источник в виде локального каталога сначала синхронизируется с bucket, а по умолчанию подключается только для чтения. Например, -v hf://datasets/org/ds:/data или -v hf://buckets/org/b:/mnt:ro или -v ./inputs:/inputs
--env-file TEXT: Читает файл с переменными окружения. Используйте -, чтобы читать их из stdin.
--secrets-file TEXT: Читает файл с секретными переменными окружения. Используйте -, чтобы читать их из stdin.
--timeout TEXT: Максимальная длительность: целое число с s (секунды, по умолчанию), m (минуты), h (часы) или d (дни).
--attempts INTEGER RANGE: Максимальное количество попыток, включая первый запуск. По умолчанию 1. [x>=1]
-d, --detach: Запустить Job в фоновом режиме и вывести Job ID.
--dry-run: Вывести разрешённую конфигурацию Job без отправки Job.
--expose INTEGER: Открыть порт контейнера через прокси задач. Повторяйте флаг для нескольких портов (например, --expose 8000 --expose 8001). Каждый открытый порт доступен по публичному домену задач; для доступа требуется токен HF с правами на чтение в пространстве имён задачи.
--expose-public INTEGER: Открыть порт контейнера через прокси задач без аутентификации. Повторите флаг для нескольких портов. Передавать порт с --expose дополнительно не нужно.
--ssh: делает контейнер задачи доступным по SSH. Подключитесь с помощью hf jobs ssh <job_id>. Требуется публичный SSH-ключ, зарегистрированный на https://huggingface.co/settings/keys.
--network-group TEXT: Присоединиться к сетевой группе. Задачи в одном и том же namespace и resource group, объединённые в одну группу, размещаются вместе и могут взаимодействовать друг с другом на любом порту. Внутри каждого участника $HF_NETWORK_GROUP_HOSTNAME разрешается в адрес каждого участника. Допускаются строчные буквы, цифры и дефисы, максимум 46 символов.
--network-alias TEXT: Зарезервировать псевдоним в сетевой группе. Участники обращаются к задачам, зарезервировавшим его, по адресу ${HF_NETWORK_GROUP_PREFIX}<alias>. Повторите флаг для нескольких псевдонимов. Допускаются строчные буквы, цифры и дефисы, максимум 34 символа, уникальность в пределах задачи. Требуется --network-group.
--resource-group-id TEXT: идентификатор группы ресурсов, в которой будет создан Job. Используется для управления доступом к ресурсам в рамках организации, а также для функций атрибуции затрат и ограничения расходов.
--namespace TEXT: пространство имён, в котором будет выполняться задание. По умолчанию используется пространство имён текущего пользователя.
--token TEXT: токен доступа пользователя, созданный на странице https://huggingface.co/settings/tokens.
--with TEXT: Запуск с установленными указанными пакетами
-p, --python TEXT: Интерпретатор Python, используемый для среды выполнения
--format [agent|auto|human|json|quiet]: Формат вывода. По умолчанию установлено значение ‘auto’, которое выбирает ‘agent’ или ‘human’ в зависимости от терминала.
--json: вывод в формате JSON. Эквивалентно ‘—format json’.
-q, --quiet: Тихий вывод (один ID на строку). Эквивалентно ‘—format quiet’.
--help: Показать это сообщение и выйти.

Примеры $ hf jobs uv run —name my-script my_script.py $ hf jobs uv run —detach my_script.py $ hf jobs uv run —flavor a10g-small ml_training.py $ hf jobs uv run —with transformers train.py $ hf jobs uv run -v hf://org/my-model:/data -v hf://buckets/org/b:/mnt script.py $ hf jobs uv run —dry-run script.py

hf jobs wait

Ожидание, пока одна или несколько задач не перейдут в конечное состояние.

Блокирует выполнение до завершения всех Job, после чего завершается с кодом 0, если все Job успешно завершены, или с ненулевым кодом, если какой-либо Job был отменён, завершился с ошибкой или удалён.

Все Jobs должны принадлежать к одному и тому же namespace.

Использование:

$ hf jobs wait [OPTIONS] JOB_IDS...

Аргументы:

JOB_IDS...: идентификаторы задач, на которые нужно ожидать (или ‘namespace/job_id’). [обязательный]

Параметры:

--timeout TEXT: Максимальное время ожидания: целое число с s (секунды, по умолчанию), m (минуты), h (часы) или d (дни).
--namespace TEXT: пространство имён, в котором будет выполняться задание. По умолчанию используется пространство имён текущего пользователя.
--token TEXT: токен доступа пользователя, созданный на странице https://huggingface.co/settings/tokens.
--help: Показать это сообщение и выйти.

Примеры $ hf jobs wait <job_id> $ hf jobs wait <job_id_1> <job_id_2> $ hf jobs ls -q | xargs hf jobs wait

hf lfs-enable-largefiles

Настройте репозиторий, чтобы разрешить загрузку файлов > 5 ГБ.

Эта команда настраивает git-lfs на использование пользовательского агента передачи multipart, что позволяет эффективно загружать большие файлы частями.

Использование:

$ hf lfs-enable-largefiles [OPTIONS] PATH

Аргументы:

PATH: Локальный путь к репозиторию, который вы хотите настроить. [обязательный параметр]

Параметры:

--help: Показать это сообщение и выйти.

hf lfs-multipart-upload

Внутренний пользовательский агент передачи git-lfs для загрузок в несколько частей.

Эта функция реализует собственный протокол передачи для многочастных загрузок git-lfs. Обрабатывает загрузку больших файлов на Hugging Face Hub по частям.

Использование:

$ hf lfs-multipart-upload [OPTIONS]

Параметры:

--help: Показать это сообщение и выйти.

hf models

Взаимодействуйте с моделями на Hub.

Использование:

$ hf models [OPTIONS] COMMAND [ARGS]...

Параметры:

--help: Показать это сообщение и выйти.

Команды:

card: получить карточку модели (README) для модели на Hub.
info: получить информацию о модели на Hub.
list: Список моделей на Hub или файлов в репозитории модели. [alias: ls]

hf models card

Получите карточку модели (README) для модели на Hub.

Использование:

$ hf models card [OPTIONS] MODEL_ID

Аргументы:

MODEL_ID: идентификатор модели (например, username/repo-name). [обязательный]

Параметры:

--metadata: выводить только метаданные из карточки.
--text: выводить только текстовое содержимое (без метаданных).
--token TEXT: токен доступа пользователя, созданный на странице https://huggingface.co/settings/tokens.
--help: Показать это сообщение и выйти.

Примеры $ hf models card google/gemma-4-31B-it $ hf models card google/gemma-4-31B-it —metadata $ hf models card google/gemma-4-31B-it —metadata —format json $ hf models card google/gemma-4-31B-it —text

hf models info

Получите информацию о модели на Hub.

Использование:

$ hf models info [OPTIONS] MODEL_ID

Аргументы:

MODEL_ID: идентификатор модели (например, username/repo-name). [обязательный]

Параметры:

--revision TEXT: идентификатор ревизии Git, который может быть именем ветки, тегом или хэшем коммита.
--expand TEXT: Свойства, возвращаемые в ответе, через запятую. При использовании этого параметра возвращаются только перечисленные свойства (а также id). Пример: ‘—expand=downloads,likes,tags’. Допустимые значения: author, baseModels, cardData, childrenModelCount, config, createdAt, disabled, downloads, downloadsAllTime, evalResults, gated, gguf, inference, inferenceProviderMapping, lastModified, library_name, likes, mask_token, model-index, pipeline_tag, private, resourceGroup, safetensors, sha, siblings, spaces, tags, transformersInfo, trendingScore, usedStorage, widgetData.
--token TEXT: токен доступа пользователя, созданный на странице https://huggingface.co/settings/tokens.
--help: Показать это сообщение и выйти.

Примеры $ hf models info meta-llama/Llama-3.2-1B-Instruct $ hf models info Qwen/Qwen3.5-9B —expand downloads,likes,tags

hf models list

Получить список моделей на Hub или файлов в репозитории модели. [alias: ls]

При вызове без аргументов выводит список моделей на Hub. При вызове с идентификатором модели выводит список файлов в репозитории этой модели.

Использование:

$ hf models list [OPTIONS] [REPO_ID]

Аргументы:

[REPO_ID]: идентификатор модели (например, username/repo-name) для получения списка файлов. Если не указан, выводится список моделей.

Параметры:

--search TEXT: поисковый запрос.
--author TEXT: Фильтр по автору или организации.
--filter TEXT: Фильтрация по тегам (например, ‘text-classification’). Можно использовать несколько раз.
--pipeline-tag TEXT: Фильтрация по тегу пайплайна (каноническая задача), например, ‘summarization’.
--gated / --no-gated: Фильтрация по статусу gated. ‘—gated’ — только gated, ‘—no-gated’ — только non-gated.
--apps TEXT: Фильтр по приложениям, способным запустить модель, например, ‘ollama’ или ‘vllm’.
--num-parameters TEXT: Фильтрация по количеству параметров, например, ‘min:6B,max:128B’.
--inference-provider [baseten|cerebras|cohere|deepinfra|fal-ai|featherless-ai|fireworks-ai|groq|hf-inference|novita|nscale|openai|ovhcloud|publicai|replicate|scaleway|together|wavespeed|zai-org]: Фильтр по провайдерам инференса, обслуживающим модель, например, ‘fireworks-ai’.
--warm: выводить только модели, которые в данный момент обслуживаются хотя бы одним провайдером инференса.
--sort [created_at|downloads|last_modified|likes|trending_score]: сортировка результатов.
--limit INTEGER: Ограничивает количество результатов. [по умолчанию: 30]
--expand TEXT: Свойства, возвращаемые в ответе, через запятую. При использовании этого параметра возвращаются только перечисленные свойства (а также id). Пример: ‘—expand=downloads,likes,tags’. Допустимые значения: author, baseModels, cardData, childrenModelCount, config, createdAt, disabled, downloads, downloadsAllTime, evalResults, gated, gguf, inference, inferenceProviderMapping, lastModified, library_name, likes, mask_token, model-index, pipeline_tag, private, resourceGroup, safetensors, sha, siblings, spaces, tags, transformersInfo, trendingScore, usedStorage, widgetData.
-h, --human-readable: отображать размеры в человекочитаемом формате (только для списка файлов).
--tree: выводит список файлов в формате дерева (только для просмотра списка файлов).
-R, --recursive: Рекурсивно выводить список файлов (только для вывода списка файлов).
--revision TEXT: идентификатор ревизии Git, который может быть именем ветки, тегом или хэшем коммита.
--token TEXT: токен доступа пользователя, созданный на странице https://huggingface.co/settings/tokens.
--help: Показать это сообщение и выйти.

Примеры $ hf models ls —sort downloads —limit 10 $ hf models ls —search “llama” —author meta-llama $ hf models ls —pipeline-tag text-generation —warm $ hf models ls —num-parameters min:6B,max:128B —sort likes $ hf models ls —no-gated —author google $ hf models ls —apps llama.cpp —apps vllm $ hf models ls —inference-provider fireworks-ai —sort downloads $ hf models ls —warm —search llama $ hf models ls meta-llama/Llama-3.2-1B-Instruct $ hf models ls meta-llama/Llama-3.2-1B-Instruct -R $ hf models ls meta-llama/Llama-3.2-1B-Instruct —tree -h

hf papers

Взаимодействуйте со статьями на Hub.

Использование:

$ hf papers [OPTIONS] COMMAND [ARGS]...

Параметры:

--help: Показать это сообщение и выйти.

Команды:

info: получить информацию о статье на Hub.
list: Список ежедневных статей на Hub. [alias: ls]
read: прочитать статью в формате Markdown.
search: Поиск статей на Hub.

hf papers info

Получить информацию о статье на Hub.

Использование:

$ hf papers info [OPTIONS] PAPER_ID

Аргументы:

PAPER_ID: идентификатор статьи на arXiv (например, ‘2502.08025’). [обязательный]

Параметры:

--token TEXT: токен доступа пользователя, созданный на странице https://huggingface.co/settings/tokens.
--help: Показать это сообщение и выйти.

Примеры $ hf papers info 2601.15621

hf papers list

Список ежедневных статей на Hub. [alias: ls]

Использование:

$ hf papers list [OPTIONS]

Параметры:

--date TEXT: Дата в формате ISO (ГГГГ-ММ-ДД) или ‘today’.
--week TEXT: ISO-неделя для фильтрации, например, ‘2025-W09’.
--month TEXT: месяц для фильтрации в формате ISO (ГГГГ-ММ), например, ‘2025-02’.
--submitter TEXT: Фильтр по имени пользователя отправителя.
--sort [publishedAt|trending]: сортировка результатов.
--limit INTEGER: Ограничивает количество результатов. [по умолчанию: 50]
--token TEXT: токен доступа пользователя, созданный на странице https://huggingface.co/settings/tokens.
--help: Показать это сообщение и выйти.

Примеры $ hf papers ls $ hf papers ls —sort trending $ hf papers ls —date 2025-01-23 $ hf papers ls —week 2025-W09 $ hf papers ls —submitter akhaliq $ hf papers ls —format json

hf papers read

Чтение статьи в формате Markdown.

Использование:

$ hf papers read [OPTIONS] PAPER_ID

Аргументы:

PAPER_ID: идентификатор статьи на arXiv (например, ‘2502.08025’). [обязательный]

Параметры:

--token TEXT: токен доступа пользователя, созданный на странице https://huggingface.co/settings/tokens.
--help: Показать это сообщение и выйти.

Примеры $ hf papers read 2601.15621

hf papers search

Ищите статьи на Hub.

Использование:

$ hf papers search [OPTIONS] QUERY

Аргументы:

QUERY: строка поискового запроса. [обязательный]

Параметры:

--limit INTEGER: Ограничивает количество результатов. [по умолчанию: 20]
--token TEXT: токен доступа пользователя, созданный на странице https://huggingface.co/settings/tokens.
--help: Показать это сообщение и выйти.

Примеры $ hf papers search “vision language” $ hf papers search “attention mechanism” —limit 10 $ hf papers search “diffusion” —format json

hf repos

Управление репозиториями на Hub.

Использование:

$ hf repos [OPTIONS] COMMAND [ARGS]...

Параметры:

--help: Показать это сообщение и выйти.

Команды:

branch: управление ветками репозитория на Hub.
cp: Копирование файлов между локальными путями, репозиториями и хранилищами.
create: создать новый репозиторий на Hub.
delete: Удалить репозиторий с Hub.
delete-files: Удаляет файлы из репозитория на Hub.
duplicate: Дублировать репозиторий на Hub (модель, датасет или Space).
list: Выводит список всех репозиториев (моделей, наборов данных, пространств, хранилищ) с информацией о хранилище. [псевдоним: ls]
move: Переместить репозиторий из одного пространства имён в другое.
settings: обновить настройки репозитория.
tag: управление тегами репозитория на Hub.

hf repos branch

Управление ветками репозитория на Hub.

Использование:

$ hf repos branch [OPTIONS] COMMAND [ARGS]...

Параметры:

--help: Показать это сообщение и выйти.

Команды:

create: Создать новую ветку для репозитория на Hub.
delete: Удалить ветку из репозитория на Hub.

hf repos branch create

Создайте новую ветку для репозитория на Hub.

Использование:

$ hf repos branch create [OPTIONS] REPO_ID BRANCH

Аргументы:

REPO_ID: идентификатор репозитория (например, username/repo-name или spaces/username/repo-name). [обязательный]
BRANCH: Имя создаваемой ветки. [обязательный параметр]

Параметры:

--revision TEXT: идентификатор ревизии Git, который может быть именем ветки, тегом или хэшем коммита.
--token TEXT: токен доступа пользователя, созданный на странице https://huggingface.co/settings/tokens.
--type, --repo-type [model|dataset|space|kernel]: тип репозитория (model, dataset, space или kernel). [по умолчанию: model]
--exist-ok / --no-exist-ok: если установлено значение True, не вызывать ошибку, если ветка уже существует. [по умолчанию: no-exist-ok]
--help: Показать это сообщение и выйти.

Примеры $ hf repos branch create my-model dev $ hf repos branch create my-model dev —revision abc123

hf repos branch delete

Удалить ветку из репозитория на Hub.

Использование:

$ hf repos branch delete [OPTIONS] REPO_ID BRANCH

Аргументы:

REPO_ID: идентификатор репозитория (например, username/repo-name или spaces/username/repo-name). [обязательный]
BRANCH: имя ветки, которую нужно удалить. [обязательный параметр]

Параметры:

--token TEXT: токен доступа пользователя, созданный на странице https://huggingface.co/settings/tokens.
--type, --repo-type [model|dataset|space|kernel]: тип репозитория (model, dataset, space или kernel). [по умолчанию: model]
--help: Показать это сообщение и выйти.

Примеры $ hf repos branch delete my-model dev

hf repos cp

Копирование файлов между локальными путями, репозиториями и хранилищами.

Использование:

$ hf repos cp [OPTIONS] SRC [DST]

Аргументы:

SRC: Источник: локальный файл, URI hf:// (репозиторий или бакет) или - для стандартного ввода. [обязательный]
[DST]: Назначение: локальный путь, URI hf:// (репозиторий или бакет) или - для stdout.

Параметры:

--token TEXT: токен доступа пользователя, созданный на странице https://huggingface.co/settings/tokens.
--help: Показать это сообщение и выйти.

Примеры $ hf repos cp hf://username/my-model/config.json config.json $ hf repos cp hf://datasets/username/my-dataset/data.csv data/ $ hf repos cp hf://username/my-model/config.json - $ hf repos cp model.safetensors hf://username/my-model/model.safetensors $ hf repos cp config.json hf://username/my-model/logs/ $ hf repos cp - hf://username/my-model/config.json $ hf repos cp hf://username/source-model/config.json hf://username/dest-model/config.json $ hf repos cp hf://datasets/username/my-dataset/processed/ hf://datasets/username/dest-dataset/processed/ $ hf repos cp hf://username/my-model/logs/ hf://username/archive-model/logs/

hf repos create

Создайте новый репозиторий на Hub.

Использование:

$ hf repos create [OPTIONS] REPO_ID

Аргументы:

REPO_ID: идентификатор репозитория (например, username/repo-name или spaces/username/repo-name). [обязательный]

Параметры:

--type, --repo-type [model|dataset|space|kernel]: тип репозитория (model, dataset, space или kernel). [по умолчанию: model]
--sdk, --space-sdk TEXT: тип SDK Hugging Face Spaces. Обязателен, если —type установлен в значение ‘space’.
--template TEXT: Создать Space из официального шаблона. Укажите идентификатор репозитория шаблона (например, ‘SpacesExamples/jupyterlab’) или его короткое имя (например, ‘JupyterLab’). Список доступных шаблонов можно получить с помощью hf spaces templates. Только для Spaces.
--private / --no-private: создавать ли приватный репозиторий, если репозитория ещё нет на Hub. Игнорируется, если репозиторий уже существует.
--public: Сделает ли репозиторий публичным. Игнорируется, если репозиторий уже существует.
--protected: Указывает, нужно ли сделать Space защищённым (только для Spaces). Игнорируется, если репозиторий уже существует.
--token TEXT: токен доступа пользователя, созданный на странице https://huggingface.co/settings/tokens.
--exist-ok / --no-exist-ok: Не вызывать ошибку, если репозиторий уже существует. [по умолчанию: no-exist-ok]
--resource-group-id TEXT: Группа ресурсов, в которой будет создан репозиторий. Группы ресурсов доступны только для организаций Enterprise Hub.
--region [us|eu]: Область облака, в которой будет создан репозиторий. Может принимать значение ‘us’ или ‘eu’. Требуется тарифный план Team или выше.
--flavor [cpu-basic|cpu-upgrade|zero-a10g|t4-small|t4-medium|l4x1|l4x4|l40sx1|l40sx4|l40sx8|a10g-small|a10g-large|a10g-largex2|a10g-largex4|a100-large|a100x4|a100x8|rtx-pro-6000|rtx-pro-6000x2|rtx-pro-6000x4|rtx-pro-6000x8]: тип аппаратного обеспечения Spaces (например, ‘cpu-basic’, ‘t4-medium’, ‘l4x4’). Только для Spaces.
--sleep-time INTEGER: Количество секунд бездействия, после которых Space переходит в спящий режим. Используйте -1 для отключения. Только для Spaces.
-s, --secrets TEXT: Задаёт секретные переменные окружения. Рекомендуется использовать --secrets SECRET, чтобы читать значение из вашего окружения (например, --secrets HF_TOKEN для передачи вашего токена Hugging Face); --secrets SECRET=value сохраняет значение в истории командной строки.
--secrets-file TEXT: Читает файл с секретными переменными окружения. Используйте -, чтобы читать их из stdin.
-e, --env TEXT: Устанавливает переменные окружения. Например, —env ENV=value
--env-file TEXT: Читает файл с переменными окружения. Используйте -, чтобы читать их из stdin.
-v, --volume TEXT: Подключить один или несколько томов. Формат: hf://[TYPE/]SOURCE:/MOUNT_PATH[:ro]. TYPE — одно из: models, datasets, spaces, buckets. Если TYPE не указан, по умолчанию используется models. models, datasets и spaces всегда подключаются только для чтения. buckets по умолчанию подключаются для чтения и записи. Например, -v hf://org/m:/data или -v hf://datasets/org/ds:/data или -v hf://buckets/org/b:/mnt:ro
--help: Показать это сообщение и выйти.

Примеры $ hf repos create my-model $ hf repos create my-dataset —repo-type dataset —private $ hf repos create my-space —type space —sdk gradio —flavor t4-medium —secrets HF_TOKEN -e THEME=dark —protected $ hf repos create my-jupyterlab —type space —template SpacesExamples/jupyterlab $ hf repos create my-space —type space —sdk gradio -v hf://org/my-model:/models -v hf://buckets/org/b:/data $ hf repos create my-model —region us

hf repos delete

Удалить репозиторий из Hub. Это необратимая операция.

Использование:

$ hf repos delete [OPTIONS] REPO_ID

Аргументы:

REPO_ID: идентификатор репозитория (например, username/repo-name или spaces/username/repo-name). [обязательный]

Параметры:

--type, --repo-type [model|dataset|space|kernel]: тип репозитория (model, dataset, space или kernel). [по умолчанию: model]
--token TEXT: токен доступа пользователя, созданный на странице https://huggingface.co/settings/tokens.
--missing-ok / --no-missing-ok: если установлено значение True, не вызывать ошибку, если репозиторий не существует. [по умолчанию: no-missing-ok]
-y, --yes: автоматически отвечать «Да» на запрос.
--help: Показать это сообщение и выйти.

Примеры $ hf repos delete my-model

hf repos delete-files

Удаление файлов из репозитория на Hub.

Использование:

$ hf repos delete-files [OPTIONS] REPO_ID PATTERNS...

Аргументы:

REPO_ID: идентификатор репозитория (например, username/repo-name или spaces/username/repo-name). [обязательный]
PATTERNS...: Глобальные шаблоны для соответствия файлам, которые нужно удалить. Основано на fnmatch, ’*’ сопоставляет файлы рекурсивно. [обязательно]

Параметры:

--type, --repo-type [model|dataset|space|kernel]: тип репозитория (model, dataset, space или kernel). [по умолчанию: model]
--revision TEXT: идентификатор ревизии Git, который может быть именем ветки, тегом или хэшем коммита.
--commit-message TEXT: краткое описание / заголовок / первая строка создаваемого коммита.
--commit-description TEXT: Описание сгенерированного коммита.
--create-pr / --no-create-pr: Создавать ли новый Pull Request для этих изменений. [по умолчанию: no-create-pr]
--token TEXT: токен доступа пользователя, созданный на странице https://huggingface.co/settings/tokens.
--help: Показать это сообщение и выйти.

Примеры $ hf repos delete-files my-model file.txt $ hf repos delete-files my-model “*.json” $ hf repos delete-files my-model folder/

hf repos duplicate

Создайте дубликат репозитория на Hub (модель, набор данных или Space).

Использование:

$ hf repos duplicate [OPTIONS] FROM_ID [TO_ID]

Аргументы:

FROM_ID: идентификатор репозитория (например, username/repo-name или spaces/username/repo-name). [обязательный параметр]
[TO_ID]: Идентификатор целевого репозитория (например, myorg/my-copy). По умолчанию используется ваше пространство имён с тем же именем репозитория.

Параметры:

--type, --repo-type [model|dataset|space|kernel]: тип репозитория (model, dataset, space или kernel). [по умолчанию: model]
--private / --no-private: создавать ли приватный репозиторий, если репозитория ещё нет на Hub. Игнорируется, если репозиторий уже существует.
--public: Сделает ли репозиторий публичным. Игнорируется, если репозиторий уже существует.
--protected: Указывает, нужно ли сделать Space защищённым (только для Spaces). Игнорируется, если репозиторий уже существует.
--token TEXT: токен доступа пользователя, созданный на странице https://huggingface.co/settings/tokens.
--exist-ok / --no-exist-ok: Не вызывать ошибку, если репозиторий уже существует. [по умолчанию: no-exist-ok]
--resource-group-id TEXT: Группа ресурсов, в которой будет создан новый репозиторий. Группы ресурсов доступны только для организаций Enterprise Hub.
--flavor [cpu-basic|cpu-upgrade|zero-a10g|t4-small|t4-medium|l4x1|l4x4|l40sx1|l40sx4|l40sx8|a10g-small|a10g-large|a10g-largex2|a10g-largex4|a100-large|a100x4|a100x8|rtx-pro-6000|rtx-pro-6000x2|rtx-pro-6000x4|rtx-pro-6000x8]: тип аппаратного обеспечения Spaces (например, ‘cpu-basic’, ‘t4-medium’, ‘l4x4’). Только для Spaces.
--sleep-time INTEGER: Количество секунд бездействия, после которых Space переходит в спящий режим. Используйте -1 для отключения. Только для Spaces.
-s, --secrets TEXT: Задаёт секретные переменные окружения. Рекомендуется использовать --secrets SECRET, чтобы читать значение из вашего окружения (например, --secrets HF_TOKEN для передачи вашего токена Hugging Face); --secrets SECRET=value сохраняет значение в истории командной строки.
--secrets-file TEXT: Читает файл с секретными переменными окружения. Используйте -, чтобы читать их из stdin.
-e, --env TEXT: Устанавливает переменные окружения. Например, —env ENV=value
--env-file TEXT: Читает файл с переменными окружения. Используйте -, чтобы читать их из stdin.
-v, --volume TEXT: Подключить один или несколько томов. Формат: hf://[TYPE/]SOURCE:/MOUNT_PATH[:ro]. TYPE — одно из: models, datasets, spaces, buckets. Если TYPE не указан, по умолчанию используется models. models, datasets и spaces всегда подключаются только для чтения. buckets по умолчанию подключаются для чтения и записи. Например, -v hf://org/m:/data или -v hf://datasets/org/ds:/data или -v hf://buckets/org/b:/mnt:ro
--help: Показать это сообщение и выйти.

Примеры $ hf repos duplicate openai/gdpval —type dataset $ hf repos duplicate multimodalart/dreambooth-training my-dreambooth —type space —flavor l4x4 —secrets HF_TOKEN —private $ hf repos duplicate org/my-space my-space —type space -v hf://org/my-model:/models -v hf://buckets/org/b:/data

hf repos list

Список всех репозиториев (моделей, наборов данных, пространств, хранилищ) с информацией о хранилище. [alias: ls]

Использование:

$ hf repos list [OPTIONS]

Параметры:

--namespace TEXT: Имя организации. Если не указано, выводит список репозиториев для аутентифицированного пользователя.
--type, --repo-type [model|dataset|space|bucket]: Фильтрация по типу репозитория (модель, датасет, space или bucket).
--search TEXT: поисковый запрос.
--limit INTEGER: Ограничивает количество результатов. [по умолчанию: 30]
--explore: Исследуйте свои репозитории в виде интерактивного 3D-города.
--token TEXT: токен доступа пользователя, созданный на странице https://huggingface.co/settings/tokens.
--help: Показать это сообщение и выйти.

Примеры $ hf repos ls $ hf repos ls —explore $ hf repos ls —namespace my-org —search bert

hf repos move

Переместить репозиторий из одного пространства имён в другое.

Использование:

$ hf repos move [OPTIONS] FROM_ID TO_ID

Аргументы:

FROM_ID: идентификатор репозитория (например, username/repo-name или spaces/username/repo-name). [обязательный параметр]
TO_ID: идентификатор репозитория (например, username/repo-name или spaces/username/repo-name). [обязательный]

Параметры:

--token TEXT: токен доступа пользователя, созданный на странице https://huggingface.co/settings/tokens.
--type, --repo-type [model|dataset|space|kernel]: тип репозитория (model, dataset, space или kernel). [по умолчанию: model]
--help: Показать это сообщение и выйти.

Примеры $ hf repos move old-namespace/my-model new-namespace/my-model

hf repos settings

Обновите настройки репозитория.

Использование:

$ hf repos settings [OPTIONS] REPO_ID

Аргументы:

REPO_ID: идентификатор репозитория (например, username/repo-name или spaces/username/repo-name). [обязательный]

Параметры:

--gated [auto|manual|false]: статус gated для репозитория.
--private / --no-private: создавать ли приватный репозиторий, если репозитория ещё нет на Hub. Игнорируется, если репозиторий уже существует.
--public: Сделает ли репозиторий публичным. Игнорируется, если репозиторий уже существует.
--protected: Указывает, нужно ли сделать Space защищённым (только для Spaces). Игнорируется, если репозиторий уже существует.
--token TEXT: токен доступа пользователя, созданный на странице https://huggingface.co/settings/tokens.
--type, --repo-type [model|dataset|space|kernel]: тип репозитория (model, dataset, space или kernel). [по умолчанию: model]
--help: Показать это сообщение и выйти.

Примеры $ hf repos settings my-model —private $ hf repos settings my-model —gated auto $ hf repos settings my-space —repo-type space —protected

hf repos tag

Управление тегами репозитория на Hub.

Использование:

$ hf repos tag [OPTIONS] COMMAND [ARGS]...

Параметры:

--help: Показать это сообщение и выйти.

Команды:

create: Создать тег для репозитория.
delete: Удалить тег для репозитория.
list: Список тегов для репозитория. [alias: ls]

hf repos tag create

Создайте тег для репозитория.

Использование:

$ hf repos tag create [OPTIONS] REPO_ID TAG

Аргументы:

REPO_ID: идентификатор репозитория (например, username/repo-name или spaces/username/repo-name). [обязательный]
TAG: Имя создаваемого тега. [обязательный параметр]

Параметры:

-m, --message TEXT: описание создаваемого тега.
--revision TEXT: идентификатор ревизии Git, который может быть именем ветки, тегом или хэшем коммита.
--token TEXT: токен доступа пользователя, созданный на странице https://huggingface.co/settings/tokens.
--type, --repo-type [model|dataset|space|kernel]: тип репозитория (model, dataset, space или kernel). [по умолчанию: model]
--help: Показать это сообщение и выйти.

Примеры $ hf repos tag create my-model v1.0 $ hf repos tag create my-model v1.0 -m “First release”

hf repos tag delete

Удалить тег для репозитория.

Использование:

$ hf repos tag delete [OPTIONS] REPO_ID TAG

Аргументы:

REPO_ID: идентификатор репозитория (например, username/repo-name или spaces/username/repo-name). [обязательный]
TAG: Имя тега, который нужно удалить. [обязательный]

Параметры:

-y, --yes: автоматически отвечать «Да» на запрос
--token TEXT: токен доступа пользователя, созданный на странице https://huggingface.co/settings/tokens.
--type, --repo-type [model|dataset|space|kernel]: тип репозитория (model, dataset, space или kernel). [по умолчанию: model]
--help: Показать это сообщение и выйти.

Примеры $ hf repos tag delete my-model v1.0

hf repos tag list

Список тегов для репозитория. [alias: ls]

Использование:

$ hf repos tag list [OPTIONS] REPO_ID

Аргументы:

REPO_ID: идентификатор репозитория (например, username/repo-name или spaces/username/repo-name). [обязательный]

Параметры:

--token TEXT: токен доступа пользователя, созданный на странице https://huggingface.co/settings/tokens.
--type, --repo-type [model|dataset|space|kernel]: тип репозитория (model, dataset, space или kernel). [по умолчанию: model]
--help: Показать это сообщение и выйти.

Примеры $ hf repos tag list my-model

hf sandbox

Запускайте и управляйте экспериментальными песочницами в Hugging Face Jobs.

Использование:

$ hf sandbox [OPTIONS] COMMAND [ARGS]...

Параметры:

--help: Показать это сообщение и выйти.

Команды:

cp: Копирование файла между локальной машиной и песочницей (в стиле docker).
create: создание песочницы: по умолчанию — выделенная ВМ, либо дешёвая общая с --pool.
exec: выполняет команду в песочнице, транслируя вывод.
kill: завершает работу песочницы, всего общего хоста или всего (—all).
pool: Предварительно прогревать пулы хостовых ВМ и создавать экспериментальные общие песочницы для рабочих нагрузок в пределах одной границы доверия.
process: список и остановка фоновых процессов, выполняющихся в песочнице.
spawn: Запускает длительную команду в фоновом режиме и возвращает её pid (не ожидает завершения).

hf sandbox cp

Копирование файла между локальной машиной и песочницей (в стиле docker).

Использование:

$ hf sandbox cp [OPTIONS] SRC DST

Аргументы:

SRC: Источник: локальный путь или <sandbox_id>:<path>. [обязательный]
DST: Destination: локальный путь или <sandbox_id>:<path>. [обязательный]

Параметры:

--namespace TEXT: пространство имён, в котором будет выполняться задание. По умолчанию используется пространство имён текущего пользователя.
--token TEXT: токен доступа пользователя, созданный на странице https://huggingface.co/settings/tokens.
--help: Показать это сообщение и выйти.

Примеры $ hf sandbox cp data.csv <sandbox_id>:/data/data.csv $ hf sandbox cp <sandbox_id>:/app/result.json result.json

hf sandbox create

Создайте песочницу: по умолчанию — выделенная ВМ, либо дешёвая общая с --pool.

Параметры Env и idle-timeout применяются к песочнице в обоих режимах. При использовании --pool образ и flavor берутся из пула, поэтому их передача здесь является ошибкой; --secrets также отклоняется, так как у песочниц из пула нет канала для зашифрованных секретов (используйте --env). Сначала определите пул с помощью hf sandbox pool create.

Использование:

$ hf sandbox create [OPTIONS] [IMAGE]

Аргументы:

[IMAGE]: образ Docker (требуется /bin/sh).

Параметры:

--pool TEXT: Создать дешёвую общую песочницу в этом пуле (из hf sandbox pool create).
--flavor [cpu-basic|cpu-upgrade|cpu-performance|cpu-xl|t4-small|t4-medium|l4x1|l4x4|l40sx1|l40sx4|l40sx8|a10g-small|a10g-large|a10g-largex2|a10g-largex4|a100-large|a100x4|a100x8|h200|h200x2|h200x4|h200x8|rtx-pro-6000|rtx-pro-6000x2|rtx-pro-6000x4|rtx-pro-6000x8]: Тип аппаратного обеспечения. Выполните команду ‘hf jobs hardware’, чтобы получить список доступных типов. По умолчанию используется cpu-basic.
--idle-timeout TEXT: Автоматически завершать работу песочницы после указанного периода бездействия (например, ‘10m’). По умолчанию — 10m.
-e, --env TEXT: Устанавливает переменные окружения. Например, —env ENV=value
-s, --secrets TEXT: Задаёт секретные переменные окружения. Рекомендуется использовать --secrets SECRET, чтобы читать значение из вашего окружения (например, --secrets HF_TOKEN для передачи вашего токена Hugging Face); --secrets SECRET=value сохраняет значение в истории командной строки.
-l, --label TEXT: Установить метки. Например, —label KEY=VALUE или —label LABEL
--env-file TEXT: Читает файл с переменными окружения. Используйте -, чтобы читать их из stdin.
--secrets-file TEXT: Читает файл с секретными переменными окружения. Используйте -, чтобы читать их из stdin.
-v, --volume TEXT: Подключить один или несколько томов. Формат: hf://[TYPE/]SOURCE:/MOUNT_PATH[:ro]. TYPE — одно из: models, datasets, spaces, buckets. Если TYPE не указан, по умолчанию используется models. models, datasets и spaces всегда подключаются только для чтения. buckets по умолчанию подключаются для чтения и записи. Например, -v hf://org/m:/data или -v hf://datasets/org/ds:/data или -v hf://buckets/org/b:/mnt:ro
--namespace TEXT: пространство имён, в котором будет выполняться задание. По умолчанию используется пространство имён текущего пользователя.
--forward-hf-token: передаёт ваш HF-токен в песочницу как HF_TOKEN.
--token TEXT: токен доступа пользователя, созданный на странице https://huggingface.co/settings/tokens.
--help: Показать это сообщение и выйти.

Примеры $ hf sandbox create $ hf sandbox create ubuntu:24.04 $ hf sandbox create —flavor a10g-small $ hf sandbox create —label controller-run=run-42 $ hf sandbox create —pool pool-ab12cd34ef56 —env LOG_LEVEL=debug

hf sandbox exec

Выполнить команду в песочнице с потоковой передачей вывода. Завершается с кодом выхода команды.

Чтобы запустить длительную команду в фоне, а не ждать её завершения, используйте hf sandbox spawn.

Использование:

$ hf sandbox exec [OPTIONS] SANDBOX_ID COMMAND...

Аргументы:

SANDBOX_ID: идентификатор песочницы, выведенный командой hf sandbox create. [обязательный]
COMMAND...: команда для запуска. [обязательный параметр]

Параметры:

-w, --workdir TEXT: Рабочая директория.
-e, --env TEXT: Устанавливает переменные окружения. Например, —env ENV=value
--env-file TEXT: Читает файл с переменными окружения. Используйте -, чтобы читать их из stdin.
--timeout FLOAT: завершает команду после указанного количества секунд.
--namespace TEXT: пространство имён, в котором будет выполняться задание. По умолчанию используется пространство имён текущего пользователя.
--token TEXT: токен доступа пользователя, созданный на странице https://huggingface.co/settings/tokens.
--help: Показать это сообщение и выйти.

Примеры $ hf sandbox exec <sandbox_id> — python -c “print(42)” $ hf sandbox exec -w /app <sandbox_id> — pytest -x

hf sandbox kill

Завершите работу песочницы, всего общего хоста или всего (—all).

Использование:

$ hf sandbox kill [OPTIONS] [SANDBOX_ID]

Аргументы:

[SANDBOX_ID]: идентификатор песочницы или хоста, который нужно завершить.

Параметры:

--all: завершает работу всех песочниц и хостов в пространстве имён.
-y, --yes: автоматически отвечать «Да» на запросы.
--namespace TEXT: пространство имён, в котором будет выполняться задание. По умолчанию используется пространство имён текущего пользователя.
--token TEXT: токен доступа пользователя, созданный на странице https://huggingface.co/settings/tokens.
--help: Показать это сообщение и выйти.

Примеры $ hf sandbox kill <sandbox_id> $ hf sandbox kill <host_id> # завершает работу всего общего хоста (всех его песочниц) $ hf sandbox kill —all

hf sandbox pool

Поддерживайте «тёплые» пулы хостовых виртуальных машин и создавайте экспериментальные общие песочницы для рабочих нагрузок в пределах одной границы доверия.

Использование:

$ hf sandbox pool [OPTIONS] COMMAND [ARGS]...

Параметры:

--help: Показать это сообщение и выйти.

Команды:

create: Разогрев пула: сейчас запускается один хост-ВМ, помеченный так, чтобы его можно было найти позже по идентификатору пула.
delete: завершает работу всех хостовых ВМ пула (а следовательно, и всех его песочниц). [псевдоним: rm]
ls: список запущенных пулов песочниц (сгруппированных по их хост-ВМ). [псевдоним: list]

hf sandbox pool create

Подготовка пула: запустите один хостовый ВМ сейчас, пометив его так, чтобы его можно было найти позже по идентификатору пула.

Использование:

$ hf sandbox pool create [OPTIONS] [IMAGE]

Аргументы:

[IMAGE]: образ Docker для хостов (требуется /bin/sh).

Параметры:

--flavor [cpu-basic|cpu-upgrade|cpu-performance|cpu-xl|t4-small|t4-medium|l4x1|l4x4|l40sx1|l40sx4|l40sx8|a10g-small|a10g-large|a10g-largex2|a10g-largex4|a100-large|a100x4|a100x8|h200|h200x2|h200x4|h200x8|rtx-pro-6000|rtx-pro-6000x2|rtx-pro-6000x4|rtx-pro-6000x8]: Тип аппаратного обеспечения. Выполните команду ‘hf jobs hardware’, чтобы получить список доступных типов. По умолчанию используется cpu-basic.
--per-host INTEGER RANGE: количество песочниц, упакованных на один хост-ВМ (по умолчанию 50). [default: 50; x>=1]
--max-hosts INTEGER RANGE: Необязательное ограничение на количество хостовых ВМ. [x>=1]
--idle-timeout TEXT: Останавливает хост, если в течение этого времени в нём не было ни одного песочницы (например, ‘10m’). По умолчанию — 10m.
--namespace TEXT: пространство имён, в котором будет выполняться задание. По умолчанию используется пространство имён текущего пользователя.
--token TEXT: токен доступа пользователя, созданный на странице https://huggingface.co/settings/tokens.
--help: Показать это сообщение и выйти.

Примеры $ hf sandbox pool create $ hf sandbox pool create python:3.12 —flavor cpu-basic $ hf sandbox pool create —per-host 50 —idle-timeout 30m

hf sandbox pool delete

Остановить все хостовые ВМ пула (а следовательно, и все его песочницы). [alias: rm]

Использование:

$ hf sandbox pool delete [OPTIONS] POOL_ID

Аргументы:

POOL_ID: Идентификатор пула для удаления. [обязательный]

Параметры:

-y, --yes: автоматически отвечать «Да» на запросы.
--namespace TEXT: пространство имён, в котором будет выполняться задание. По умолчанию используется пространство имён текущего пользователя.
--token TEXT: токен доступа пользователя, созданный на странице https://huggingface.co/settings/tokens.
--help: Показать это сообщение и выйти.

Примеры $ hf sandbox pool delete <pool_id>

hf sandbox pool ls

Список запущенных пулов песочниц (сгруппированных по их хост-ВМ). [alias: list]

Использование:

$ hf sandbox pool ls [OPTIONS]

Параметры:

--namespace TEXT: пространство имён, в котором будет выполняться задание. По умолчанию используется пространство имён текущего пользователя.
--token TEXT: токен доступа пользователя, созданный на странице https://huggingface.co/settings/tokens.
--help: Показать это сообщение и выйти.

Примеры $ hf sandbox pool ls

hf sandbox process

Просмотр и остановка фоновых процессов, выполняемых в песочнице.

Использование:

$ hf sandbox process [OPTIONS] COMMAND [ARGS]...

Параметры:

--help: Показать это сообщение и выйти.

Команды:

kill: Остановить фоновый процесс, работающий в песочнице.
ls: список фоновых процессов, запущенных в песочнице (созданных с помощью hf sandbox spawn). [alias: list]

hf sandbox process kill

Остановите фоновый процесс, работающий в песочнице.

Использование:

$ hf sandbox process kill [OPTIONS] SANDBOX_ID PID

Аргументы:

SANDBOX_ID: идентификатор песочницы, выведенный командой hf sandbox create. [обязательный]
PID: PID, как выводится командой hf sandbox process ls. [обязательный]

Параметры:

--namespace TEXT: пространство имён, в котором будет выполняться задание. По умолчанию используется пространство имён текущего пользователя.
--token TEXT: токен доступа пользователя, созданный на странице https://huggingface.co/settings/tokens.
--help: Показать это сообщение и выйти.

Примеры $ hf sandbox process kill <sandbox_id> <pid>

hf sandbox process ls

Список фоновых процессов, запущенных в песочнице (стартованных с помощью hf sandbox spawn). [alias: list]

Использование:

$ hf sandbox process ls [OPTIONS] SANDBOX_ID

Аргументы:

SANDBOX_ID: идентификатор песочницы, выведенный командой hf sandbox create. [обязательный]

Параметры:

--namespace TEXT: пространство имён, в котором будет выполняться задание. По умолчанию используется пространство имён текущего пользователя.
--token TEXT: токен доступа пользователя, созданный на странице https://huggingface.co/settings/tokens.
--help: Показать это сообщение и выйти.

Примеры $ hf sandbox process ls <sandbox_id>

hf sandbox spawn

Запустите длительную команду в фоновом режиме и верните её pid (не ждите завершения).

Просмотрите процессы песочницы с помощью hf sandbox process ls и остановьте один из них с помощью hf sandbox process kill.

Использование:

$ hf sandbox spawn [OPTIONS] SANDBOX_ID COMMAND...

Аргументы:

SANDBOX_ID: идентификатор песочницы, выведенный командой hf sandbox create. [обязательный]
COMMAND...: команда для запуска в фоновом режиме. [обязательно]

Параметры:

-w, --workdir TEXT: Рабочая директория.
-e, --env TEXT: Устанавливает переменные окружения. Например, —env ENV=value
--env-file TEXT: Читает файл с переменными окружения. Используйте -, чтобы читать их из stdin.
--namespace TEXT: пространство имён, в котором будет выполняться задание. По умолчанию используется пространство имён текущего пользователя.
--token TEXT: токен доступа пользователя, созданный на странице https://huggingface.co/settings/tokens.
--help: Показать это сообщение и выйти.

Примеры $ hf sandbox spawn <sandbox_id> — python -m http.server 8000 $ hf sandbox spawn -w /app <sandbox_id> — uvicorn app:app

hf skills

Управление навыками ИИ-ассистентов.

Использование:

$ hf skills [OPTIONS] COMMAND [ARGS]...

Параметры:

--help: Показать это сообщение и выйти.

Команды:

add: установка навыка Hugging Face для ИИ-ассистента.
list: Список доступных навыков на маркетплейсе Hugging Face. [alias: ls]
preview: Вывести сгенерированный файл hf-cli SKILL.md в стандартный вывод.
update: Обновление установленных навыков Hugging Face marketplace.

hf skills add

Установите навык Hugging Face для ИИ-ассистента.

Навык hf-cli по умолчанию генерируется локально из установленной версии CLI; остальные навыки загружаются с маркетплейса Hugging Face. Расположение по умолчанию — в текущем каталоге (.agents/skills) или на уровне пользователя (~/.agents/skills). Ссылка на навык также создаётся в каталоге навыков Claude Code (.claude/skills или ~/.claude/skills, с учётом переменной CLAUDE_CONFIG_DIR, если она задана), если не используется --dest.

Использование:

$ hf skills add [OPTIONS] [NAME]

Аргументы:

[NAME]: имя навыка на маркетплейсе.

Параметры:

-g, --global: Установить глобально (на уровне пользователя), а не в текущей директории проекта.
--dest PATH: установка в пользовательское место назначения (путь к каталогу skills).
--force: перезаписать существующие навыки в целевом месте.
--help: Показать это сообщение и выйти.

Примеры $ hf skills add $ hf skills add huggingface-gradio —dest=~/my-skills $ hf skills add —global $ hf skills add huggingface-gradio —global

hf skills list

Получить список доступных навыков с маркетплейса Hugging Face. [alias: ls]

Использование:

$ hf skills list [OPTIONS]

Параметры:

--token TEXT: токен доступа пользователя, созданный на странице https://huggingface.co/settings/tokens.
--help: Показать это сообщение и выйти.

Примеры $ hf skills list $ hf skills list —format json

hf skills preview

Вывести сгенерированный hf-cli SKILL.md в стандартный вывод.

Использование:

$ hf skills preview [OPTIONS]

Параметры:

--help: Показать это сообщение и выйти.

hf skills update

Обновите установленные навыки Hugging Face marketplace.

Использование:

$ hf skills update [OPTIONS] [NAME]

Аргументы:

[NAME]: Необязательное имя установленной функции для обновления.

Параметры:

-g, --global: Использовать глобальные каталоги навыков вместо текущего проекта.
--dest PATH: обновить навыки в каталоге пользовательских навыков.
--help: Показать это сообщение и выйти.

Примеры $ hf skills update $ hf skills update hf-cli $ hf skills update huggingface-gradio —dest=~/my-skills $ hf skills update -g

hf spaces

Взаимодействуйте с пространствами на Hub.

Использование:

$ hf spaces [OPTIONS] COMMAND [ARGS]...

Параметры:

--help: Показать это сообщение и выйти.

Команды:

card: Получить карточку Space (README) для Space на Hub.
dev-mode: Включить или отключить режим разработки в Space.
hardware: список доступных вариантов аппаратного обеспечения для Spaces.
hot-reload: Горячая перезагрузка любого Python-файла в Space без полной пересборки и перезапуска.
info: получить информацию о пространстве на Hub.
list: Список пространств на Hub или файлов в репозитории пространства. [alias: ls]
logs: Получить журналы выполнения или сборки Space.
pause: Приостановить Space.
restart: перезапуск Space.
search: поиск пространств на Hub с использованием семантического поиска.
secrets: управление секретами для Space на Hub.
settings: обновить настройки Space.
ssh: подключение по SSH к контейнеру Dev Mode Space.
templates: Список доступных шаблонов Space.
variables: управление переменными окружения для Space на Hub.
volumes: управление томами для Space на Hub.
wait: Подождать, пока Space завершит сборку/запуск.
zero-gpu: Управление использованием ZeroGPU на Hub.

hf spaces card

Получите карточку Space (README) для Space на Hub.

Использование:

$ hf spaces card [OPTIONS] SPACE_ID

Аргументы:

SPACE_ID: идентификатор пространства (например, username/repo-name). [обязательный]

Параметры:

--metadata: выводить только метаданные из карточки.
--text: выводить только текстовое содержимое (без метаданных).
--token TEXT: токен доступа пользователя, созданный на странице https://huggingface.co/settings/tokens.
--help: Показать это сообщение и выйти.

Примеры $ hf spaces card mteb/leaderboard $ hf spaces card mteb/leaderboard —metadata $ hf spaces card mteb/leaderboard —metadata —format json $ hf spaces card mteb/leaderboard —text

hf spaces dev-mode

Включить или отключить режим разработки в Space.

Spaces Dev Mode упрощает отладку вашего приложения и ускоряет итерации в Spaces, позволяя перезапускать приложение без остановки самого контейнера Space. Для включения dev mode требуется тариф PRO или Team & Enterprise. Отключение (--stop) всегда разрешено.

См. документацию: https://huggingface.co/docs/hub/spaces-dev-mode

Использование:

$ hf spaces dev-mode [OPTIONS] SPACE_ID

Аргументы:

SPACE_ID: идентификатор пространства (например, username/repo-name). [обязательный]

Параметры:

--stop / --no-stop: Остановить режим разработки. [по умолчанию: no-stop]
--token TEXT: токен доступа пользователя, созданный на странице https://huggingface.co/settings/tokens.
--help: Показать это сообщение и выйти.

Примеры $ hf spaces dev-mode my-user-name/deepsite

hf spaces hardware

Список доступных вариантов аппаратного обеспечения для Spaces.

Использование:

$ hf spaces hardware [OPTIONS]

Параметры:

--token TEXT: токен доступа пользователя, созданный на странице https://huggingface.co/settings/tokens.
--help: Показать это сообщение и выйти.

Примеры $ hf spaces hardware

hf spaces hot-reload

Горячая перезагрузка любого Python-файла Space без полной пересборки и перезапуска.

⚠ Эта функция является экспериментальной ⚠

Работает только с Gradio SDK (6.1+) Открывает интерактивный редактор, если не указан параметр —local-file/-f.

Эта команда применяет патчи к работающему процессу Python с помощью https://github.com/breuleux/jurigged (дифф на основе AST, обновление функций на месте и т. д.), интегрированный с нативной поддержкой горячей перезагрузки в Gradio (что означает, что изменения объекта демо Gradio отражаются в интерфейсе)

Команда создаёт удалённый коммит. Если вы работаете с локальным клонированием, выполните git pull --autostash после этого, чтобы вернуть коммит и синхронизировать локальное состояние git.

Использование:

$ hf spaces hot-reload [OPTIONS] SPACE_ID [FILENAME]

Аргументы:

SPACE_ID: идентификатор пространства (например, username/repo-name). [обязательный]
[FILENAME]: Путь к файлу Python в репозитории Space. Можно опустить, если указан —local-file и путь в репозитории совпадает.

Параметры:

-f, --local-file PATH: Путь к локальному файлу. Если не указан, включается режим интерактивного редактора
--skip-checks / --no-skip-checks: Пропуск проверок совместимости с горячей перезагрузкой. [по умолчанию: no-skip-checks]
--skip-summary / --no-skip-summary: Пропускать отображение сводки после запуска горячей перезагрузки [по умолчанию: no-skip-summary]
--token TEXT: токен доступа пользователя, созданный на странице https://huggingface.co/settings/tokens.
--help: Показать это сообщение и выйти.

Примеры $ hf spaces hot-reload username/repo-name app.py # Open an interactive editor to the remote app.py file $ hf spaces hot-reload username/repo-name -f app.py # Take local version from ./app.py and patch app.py remotely $ hf spaces hot-reload username/repo-name app.py -f src/app.py # Take local version from ./src/app.py

hf spaces info

Получить информацию о пространстве на Hub.

Использование:

$ hf spaces info [OPTIONS] SPACE_ID

Аргументы:

SPACE_ID: идентификатор пространства (например, username/repo-name). [обязательный]

Параметры:

--revision TEXT: идентификатор ревизии Git, который может быть именем ветки, тегом или хэшем коммита.
--expand TEXT: свойства, возвращаемые в ответе, через запятую. При использовании этого параметра возвращаются только указанные свойства (а также id). Пример: ‘—expand=likes,tags’. Допустимые значения: author, cardData, createdAt, datasets, disabled, lastModified, likes, models, private, region, resourceGroup, runtime, sdk, sha, siblings, subdomain, tags, trendingScore, usedStorage.
--token TEXT: токен доступа пользователя, созданный на странице https://huggingface.co/settings/tokens.
--help: Показать это сообщение и выйти.

Примеры $ hf spaces info enzostvs/deepsite $ hf spaces info gradio/theme_builder —expand sdk,runtime,likes

hf spaces list

Получить список пространств на Hub или файлов в репозитории пространства. [alias: ls]

При вызове без аргументов выводит список пространств на Hub. При вызове с идентификатором пространства выводит список файлов в репозитории этого пространства.

Использование:

$ hf spaces list [OPTIONS] [REPO_ID]

Аргументы:

[REPO_ID]: идентификатор Space (например, username/repo-name), для которого нужно получить список файлов. Если не указан, выводится список Spaces.

Параметры:

--search TEXT: поисковый запрос.
--author TEXT: Фильтр по автору или организации.
--filter TEXT: Фильтрация по тегам (например, ‘text-classification’). Можно использовать несколько раз.
--sort [created_at|last_modified|likes|trending_score]: сортировка результатов.
--limit INTEGER: Ограничивает количество результатов. [по умолчанию: 30]
--expand TEXT: свойства, возвращаемые в ответе, через запятую. При использовании этого параметра возвращаются только указанные свойства (а также id). Пример: ‘—expand=likes,tags’. Допустимые значения: author, cardData, createdAt, datasets, disabled, lastModified, likes, models, private, region, resourceGroup, runtime, sdk, sha, siblings, subdomain, tags, trendingScore, usedStorage.
-h, --human-readable: отображать размеры в человекочитаемом формате (только для списка файлов).
--tree: выводит список файлов в формате дерева (только для просмотра списка файлов).
-R, --recursive: Рекурсивно выводить список файлов (только для вывода списка файлов).
--revision TEXT: идентификатор ревизии Git, который может быть именем ветки, тегом или хэшем коммита.
--token TEXT: токен доступа пользователя, созданный на странице https://huggingface.co/settings/tokens.
--help: Показать это сообщение и выйти.

Примеры $ hf spaces ls —limit 10 $ hf spaces ls —search “chatbot” —author huggingface $ hf spaces ls victor/deepsite $ hf spaces ls victor/deepsite -R $ hf spaces ls victor/deepsite —tree -h

hf spaces logs

Получить журналы выполнения или сборки Space.

По умолчанию выводит текущие доступные журналы выполнения и завершает работу (неблокирующий режим, как docker logs). Используйте —follow/-f, чтобы получать поток данных до закрытия потока сервером. Используйте —build, чтобы вместо этого просмотреть журналы сборки контейнера (полезно, если Space застрял в состоянии BUILD_ERROR).

Использование:

$ hf spaces logs [OPTIONS] SPACE_ID

Аргументы:

SPACE_ID: идентификатор пространства (например, username/repo-name). [обязательный]

Параметры:

--build: получить журналы сборки контейнера вместо журналов выполнения. Полезно, если Space застрял в состоянии BUILD_ERROR.
-f, --follow: Следить за выводом журнала (поток до закрытия сервером). Без этого флага выводятся только доступные в данный момент записи журнала.
-n, --tail INTEGER: количество строк, отображаемых с конца журнала.
--token TEXT: токен доступа пользователя, созданный на странице https://huggingface.co/settings/tokens.
--help: Показать это сообщение и выйти.

Примеры $ hf spaces logs username/my-space $ hf spaces logs username/my-space —build $ hf spaces logs -f username/my-space $ hf spaces logs -n 50 username/my-space

hf spaces pause

Приостановить Space.

Использование:

$ hf spaces pause [OPTIONS] SPACE_ID

Аргументы:

SPACE_ID: идентификатор пространства (например, username/repo-name). [обязательный]

Параметры:

--token TEXT: токен доступа пользователя, созданный на странице https://huggingface.co/settings/tokens.
--help: Показать это сообщение и выйти.

Примеры $ hf spaces pause username/my-space

hf spaces restart

Перезапустить Space.

Использование:

$ hf spaces restart [OPTIONS] SPACE_ID

Аргументы:

SPACE_ID: идентификатор пространства (например, username/repo-name). [обязательный]

Параметры:

--factory-reboot: Пересоздать Space с нуля, не используя кэш сборки.
--token TEXT: токен доступа пользователя, созданный на странице https://huggingface.co/settings/tokens.
--help: Показать это сообщение и выйти.

Примеры $ hf spaces restart username/my-space $ hf spaces restart username/my-space —factory-reboot

hf spaces search

Ищите пространства на Hub с помощью семантического поиска.

Использование:

$ hf spaces search [OPTIONS] QUERY

Аргументы:

QUERY: поисковый запрос. [обязательный]

Параметры:

--filter TEXT: Фильтрация по тегам (например, ‘text-classification’). Можно использовать несколько раз.
--sdk TEXT: Фильтр по SDK (например, gradio, docker, static).
--include-non-running / --no-include-non-running: Включать неработающие пространства в результаты. [по умолчанию: no-include-non-running]
--description / --no-description: Показывать описания, сгенерированные ИИ. [по умолчанию: no-description]
--limit INTEGER: Ограничивает количество результатов. [по умолчанию: 10]
--token TEXT: токен доступа пользователя, созданный на странице https://huggingface.co/settings/tokens.
--help: Показать это сообщение и выйти.

Примеры $ hf spaces search “generate image” $ hf spaces search “identify objects in pictures” —sdk gradio —limit 5 $ hf spaces search “remove background from photo” —description —json

hf spaces secrets

Управление секретами для Space на Hub.

Использование:

$ hf spaces secrets [OPTIONS] COMMAND [ARGS]...

Параметры:

--help: Показать это сообщение и выйти.

Команды:

add: добавляет или обновляет секреты для Space.
delete: Удалить секрет из Space.
list: Список секретов для Space. [alias: ls]

hf spaces secrets add

Добавьте или обновите секреты для Space.

Использование:

$ hf spaces secrets add [OPTIONS] SPACE_ID

Аргументы:

SPACE_ID: идентификатор пространства (например, username/repo-name). [обязательный]

Параметры:

-s, --secrets TEXT: Задаёт секретные переменные окружения. Рекомендуется использовать --secrets SECRET, чтобы читать значение из вашего окружения (например, --secrets HF_TOKEN для передачи вашего токена Hugging Face); --secrets SECRET=value сохраняет значение в истории командной строки.
--secrets-file TEXT: Читает файл с секретными переменными окружения. Используйте -, чтобы читать их из stdin.
--token TEXT: токен доступа пользователя, созданный на странице https://huggingface.co/settings/tokens.
--help: Показать это сообщение и выйти.

Примеры $ hf spaces secrets add username/my-space -s HF_TOKEN $ hf spaces secrets add username/my-space -s OPENAI_API_KEY=sk-… -s ANTHROPIC_API_KEY=sk-… $ hf spaces secrets add username/my-space —secrets-file .env.secrets

hf spaces secrets delete

Удалить секрет из Space.

Использование:

$ hf spaces secrets delete [OPTIONS] SPACE_ID KEY

Аргументы:

SPACE_ID: идентификатор пространства (например, username/repo-name). [обязательный]
KEY: Имя секрета, который нужно удалить. [обязательный]

Параметры:

-y, --yes: автоматически отвечать «Да» на запрос.
--token TEXT: токен доступа пользователя, созданный на странице https://huggingface.co/settings/tokens.
--help: Показать это сообщение и выйти.

Примеры $ hf spaces secrets delete username/my-space HF_TOKEN $ hf spaces secrets delete username/my-space HF_TOKEN —yes

hf spaces secrets list

Список секретов для Space. Значения секретов доступны только для записи и не возвращаются. [alias: ls]

Использование:

$ hf spaces secrets list [OPTIONS] SPACE_ID

Аргументы:

SPACE_ID: идентификатор пространства (например, username/repo-name). [обязательный]

Параметры:

--token TEXT: токен доступа пользователя, созданный на странице https://huggingface.co/settings/tokens.
--help: Показать это сообщение и выйти.

Примеры $ hf spaces secrets ls username/my-space

hf spaces settings

Обновите настройки Space.

Использование:

$ hf spaces settings [OPTIONS] SPACE_ID

Аргументы:

SPACE_ID: идентификатор пространства (например, username/repo-name). [обязательный]

Параметры:

--sleep-time INTEGER: Время простоя в секундах, после которого Space переходит в спящий режим. Используйте -1, чтобы Space никогда не засыпал. Доступно только на улучшенном оборудовании.
--hardware [cpu-basic|cpu-upgrade|zero-a10g|t4-small|t4-medium|l4x1|l4x4|l40sx1|l40sx4|l40sx8|a10g-small|a10g-large|a10g-largex2|a10g-largex4|a100-large|a100x4|a100x8|rtx-pro-6000|rtx-pro-6000x2|rtx-pro-6000x4|rtx-pro-6000x8]: тип аппаратного обеспечения Space (например, ‘cpu-basic’, ‘t4-medium’, ‘l4x4’). Выполните ‘hf spaces hardware’, чтобы получить список доступных вариантов.
--token TEXT: токен доступа пользователя, созданный на странице https://huggingface.co/settings/tokens.
--help: Показать это сообщение и выйти.

Примеры $ hf spaces settings username/my-space —sleep-time 300 $ hf spaces settings username/my-space —hardware t4-medium

hf spaces ssh

Подключитесь по SSH к контейнеру Dev Mode Space.

Требуется, чтобы Dev Mode был запущен в Space, а ваш публичный SSH-ключ был зарегистрирован на странице https://huggingface.co/settings/keys.

См.: https://huggingface.co/docs/hub/spaces-dev-mode

Использование:

$ hf spaces ssh [OPTIONS] SPACE_ID

Аргументы:

SPACE_ID: идентификатор пространства (например, username/repo-name). [обязательный]

Параметры:

-i, --identity-file PATH: Путь к файлу SSH-идентификации (передаётся в ssh -i).
--dry-run: Вывести команду SSH вместо её выполнения.
--auto: Включить Dev Mode без запроса, если он ещё не включён.
--token TEXT: токен доступа пользователя, созданный на странице https://huggingface.co/settings/tokens.
--help: Показать это сообщение и выйти.

Примеры $ hf spaces ssh username/my-space $ hf spaces ssh username/my-space —dry-run $ hf spaces ssh username/my-space -i ~/.ssh/id_ed25519 $ hf spaces ssh username/my-space —auto

hf spaces templates

Получите список доступных шаблонов Space.

Идентификатор repo_id (или name) шаблона можно передать в hf repos create --template ..., чтобы создать новое Space на основе этого шаблона.

Использование:

$ hf spaces templates [OPTIONS]

Параметры:

--token TEXT: токен доступа пользователя, созданный на странице https://huggingface.co/settings/tokens.
--help: Показать это сообщение и выйти.

Примеры $ hf spaces templates

hf spaces variables

Управление переменными окружения для Space на Hub.

Использование:

$ hf spaces variables [OPTIONS] COMMAND [ARGS]...

Параметры:

--help: Показать это сообщение и выйти.

Команды:

add: добавляет или обновляет переменные окружения для Space.
delete: Удаляет переменную окружения из Space.
list: Список переменных окружения для Space. [alias: ls]

hf spaces variables add

Добавьте или обновите переменные окружения для Space.

Использование:

$ hf spaces variables add [OPTIONS] SPACE_ID

Аргументы:

SPACE_ID: идентификатор пространства (например, username/repo-name). [обязательный]

Параметры:

-e, --env TEXT: Устанавливает переменные окружения. Например, —env ENV=value
--env-file TEXT: Читает файл с переменными окружения. Используйте -, чтобы читать их из stdin.
--token TEXT: токен доступа пользователя, созданный на странице https://huggingface.co/settings/tokens.
--help: Показать это сообщение и выйти.

Примеры $ hf spaces variables add username/my-space -e DEBUG=1 $ hf spaces variables add username/my-space -e MODEL_ID=gpt2 -e MAX_TOKENS=512 $ hf spaces variables add username/my-space —env-file .env

hf spaces variables delete

Удалить переменную окружения из Space.

Использование:

$ hf spaces variables delete [OPTIONS] SPACE_ID KEY

Аргументы:

SPACE_ID: идентификатор пространства (например, username/repo-name). [обязательный]
KEY: Имя переменной, которую нужно удалить. [обязательный параметр]

Параметры:

-y, --yes: автоматически отвечать «Да» на запрос.
--token TEXT: токен доступа пользователя, созданный на странице https://huggingface.co/settings/tokens.
--help: Показать это сообщение и выйти.

Примеры $ hf spaces variables delete username/my-space DEBUG $ hf spaces variables delete username/my-space DEBUG —yes

hf spaces variables list

Список переменных окружения для Space. [alias: ls]

Использование:

$ hf spaces variables list [OPTIONS] SPACE_ID

Аргументы:

SPACE_ID: идентификатор пространства (например, username/repo-name). [обязательный]

Параметры:

--token TEXT: токен доступа пользователя, созданный на странице https://huggingface.co/settings/tokens.
--help: Показать это сообщение и выйти.

Примеры $ hf spaces variables ls username/my-space

hf spaces volumes

Управление томами для Space на Hub.

Использование:

$ hf spaces volumes [OPTIONS] COMMAND [ARGS]...

Параметры:

--help: Показать это сообщение и выйти.

Команды:

delete: Удаляет все тома из Space.
list: Список томов, смонтированных в Space. [alias: ls]
set: Установить (заменить) тома для Space.

hf spaces volumes delete

Удалите все тома из Space.

Использование:

$ hf spaces volumes delete [OPTIONS] SPACE_ID

Аргументы:

SPACE_ID: идентификатор пространства (например, username/repo-name). [обязательный]

Параметры:

-y, --yes: автоматически отвечать «Да» на запрос.
--token TEXT: токен доступа пользователя, созданный на странице https://huggingface.co/settings/tokens.
--help: Показать это сообщение и выйти.

Примеры $ hf spaces volumes delete username/my-space $ hf spaces volumes delete username/my-space —yes

hf spaces volumes list

Список томов, смонтированных в Space. [alias: ls]

Использование:

$ hf spaces volumes list [OPTIONS] SPACE_ID

Аргументы:

SPACE_ID: идентификатор пространства (например, username/repo-name). [обязательный]

Параметры:

--token TEXT: токен доступа пользователя, созданный на странице https://huggingface.co/settings/tokens.
--help: Показать это сообщение и выйти.

Примеры $ hf spaces volumes ls username/my-space

hf spaces volumes set

Установить (заменить) тома для Space.

Использование:

$ hf spaces volumes set [OPTIONS] SPACE_ID

Аргументы:

SPACE_ID: идентификатор пространства (например, username/repo-name). [обязательный]

Параметры:

-v, --volume TEXT: Подключить один или несколько томов. Формат: hf://[TYPE/]SOURCE:/MOUNT_PATH[:ro]. TYPE — одно из: models, datasets, spaces, buckets. Если TYPE не указан, по умолчанию используется models. models, datasets и spaces всегда подключаются только для чтения. buckets по умолчанию подключаются для чтения и записи. Например, -v hf://org/m:/data или -v hf://datasets/org/ds:/data или -v hf://buckets/org/b:/mnt:ro
--token TEXT: токен доступа пользователя, созданный на странице https://huggingface.co/settings/tokens.
--help: Показать это сообщение и выйти.

Примеры $ hf spaces volumes set username/my-space -v hf://models/username/my-model:/models $ hf spaces volumes set username/my-space -v hf://buckets/username/my-bucket:/data -v hf://datasets/username/my-dataset:/datasets:ro

hf spaces wait

Дождитесь, пока Space завершит сборку/запуск.

Блокирует выполнение, пока Space не покинет промежуточное состояние (BUILDING, APP_STARTING и т. д.) и не перейдёт в стабильное состояние. Завершается с кодом 0, если Space находится в состоянии RUNNING, или с ненулевым кодом в противном случае (например, BUILD_ERROR, RUNTIME_ERROR).

Использование:

$ hf spaces wait [OPTIONS] SPACE_ID

Аргументы:

SPACE_ID: идентификатор пространства (например, username/repo-name). [обязательный]

Параметры:

--timeout TEXT: Максимальное время ожидания: целое число с s (секунды, по умолчанию), m (минуты), h (часы) или d (дни).
--token TEXT: токен доступа пользователя, созданный на странице https://huggingface.co/settings/tokens.
--help: Показать это сообщение и выйти.

Примеры $ hf spaces wait username/my-space $ hf spaces wait username/my-space —timeout 5m

hf spaces zero-gpu

Управляйте использованием ZeroGPU на Hub.

Использование:

$ hf spaces zero-gpu [OPTIONS] COMMAND [ARGS]...

Параметры:

--help: Показать это сообщение и выйти.

Команды:

quota: показывает вашу квоту ZeroGPU (остаток времени на GPU и дата сброса).

hf spaces zero-gpu quota

Показать вашу квоту ZeroGPU (остаток времени на GPU и дата сброса).

Значения указаны в секундах GPU. При использовании --quiet выводится только оставшееся время в секундах GPU.

Использование:

$ hf spaces zero-gpu quota [OPTIONS]

Параметры:

--token TEXT: токен доступа пользователя, созданный на странице https://huggingface.co/settings/tokens.
--help: Показать это сообщение и выйти.

Примеры $ hf spaces zero-gpu quota $ hf spaces zero-gpu quota —format json

hf sync

Синхронизация файлов между локальным каталогом и хранилищем.

Использование:

$ hf sync [OPTIONS] [SOURCE] [DEST]

Аргументы:

[SOURCE]: Путь к источнику: локальный каталог или hf://buckets/namespace/bucket_name(/prefix)
[DEST]: Путь назначения: локальный каталог или hf://buckets/namespace/bucket_name(/prefix)

Параметры:

--delete / --no-delete: Удаляет файлы в пункте назначения, отсутствующие в источнике. [по умолчанию: no-delete]
--ignore-times: Пропускать файлы только на основе размера, игнорируя время изменения.
--ignore-sizes: Пропускать файлы только на основе времени изменения, игнорируя размеры.
--plan TEXT: Сохранить план синхронизации в файл JSONL для проверки вместо выполнения.
--apply TEXT: Применить ранее сохранённый файл плана.
--dry-run: Выводит план синхронизации в stdout в формате JSONL без выполнения.
--include TEXT: Включить файлы, соответствующие шаблону (можно указать несколько).
--exclude TEXT: Исключить файлы, соответствующие шаблону (можно указать несколько).
--filter-from TEXT: читать шаблоны включения/исключения из файла.
--existing: не создавать новые файлы на стороне приёмника (обновлять только существующие файлы).
--ignore-existing: Пропускать обновление файлов, которые уже существуют на стороне получателя (создавать только новые файлы).
-v, --verbose: Показывать подробные логи с обоснованием.
--token TEXT: токен доступа пользователя, созданный на странице https://huggingface.co/settings/tokens.
--help: Показать это сообщение и выйти.

hf update

Обновите hf CLI до последней версии.

Использование:

$ hf update [OPTIONS]

Параметры:

--help: Показать это сообщение и выйти.

hf upload

Загрузите файл или папку в Hub.

Папки с большим количеством файлов разбиваются на несколько коммитов. Если загрузка папки прервана, повторите выполнение той же команды, чтобы продолжить её.

Использование:

$ hf upload [OPTIONS] REPO_ID [LOCAL_PATH] [PATH_IN_REPO]

Аргументы:

REPO_ID: идентификатор репозитория (например, username/repo-name или spaces/username/repo-name). [обязательный]
[LOCAL_PATH]: локальный путь к файлу или папке для загрузки. Поддерживаются шаблоны с подстановочными символами. По умолчанию используется текущий каталог.
[PATH_IN_REPO]: Путь к файлу или папке в репозитории. По умолчанию используется относительный путь к файлу или папке.

Параметры:

--type, --repo-type [model|dataset|space|kernel]: тип репозитория (модель, набор данных, пространство или ядро). [по умолчанию: (model)]
--revision TEXT: идентификатор ревизии Git, который может быть именем ветки, тегом или хэшем коммита.
--private / --no-private: создавать ли приватный репозиторий, если репозитория ещё нет на Hub. Игнорируется, если репозиторий уже существует.
--include TEXT: Глобальные шаблоны для выбора файлов для загрузки.
--exclude TEXT: Глобальные шаблоны для исключения файлов из загрузки.
--delete TEXT: Шаблоны Glob для файлов, которые будут удалены из репозитория при коммите.
--commit-message TEXT: краткое описание / заголовок / первая строка создаваемого коммита.
--commit-description TEXT: Описание сгенерированного коммита.
--create-pr / --no-create-pr: Загружать ли содержимое в виде нового Pull Request. [по умолчанию: no-create-pr]
--every FLOAT: если задано, фоновая задача создаёт коммиты каждые every минут.
--token TEXT: токен доступа пользователя, созданный на странице https://huggingface.co/settings/tokens.
--help: Показать это сообщение и выйти.

Примеры $ hf upload my-cool-model . . $ hf upload Wauplin/my-cool-model ./models/model.safetensors $ hf upload Wauplin/my-cool-dataset ./data /train —repo-type=dataset $ hf upload Wauplin/my-cool-model ./models . —commit-message=“Epoch 34/50” —commit-description=“Val accuracy: 68%” $ hf upload bigcode/the-stack . . —repo-type dataset —create-pr

hf version

Выводит информацию о версии hf.

Использование:

$ hf version [OPTIONS]

Параметры:

--help: Показать это сообщение и выйти.

hf webhooks

Управление вебхуками на Hub.

Использование:

$ hf webhooks [OPTIONS] COMMAND [ARGS]...

Параметры:

--help: Показать это сообщение и выйти.

Команды:

create: Создать новый вебхук.
delete: Удалить вебхук безвозвратно.
disable: Отключить активный вебхук.
enable: Включить отключённый вебхук.
info: показывает подробные сведения о конкретном вебхуке.
list: Список всех вебхуков для текущего пользователя. [alias: ls]
update: Обновление существующего вебхука.

hf webhooks create

Создайте новый вебхук.

Укажите либо —url (для отправки запроса на удалённый сервер), либо —job-id (для запуска Job), но не оба параметра одновременно. Секреты исходного Job не копируются в webhook: передайте их повторно с помощью —secrets / —secrets-file.

Использование:

$ hf webhooks create [OPTIONS]

Параметры:

--watch TEXT: Элемент для отслеживания в формате ‘type:name’ (например, ‘model:bert-base-uncased’). Можно указать несколько раз. [обязательный]
--url TEXT: URL для отправки данных вебхука. Взаимоисключающийся с —job-id.
--job-id TEXT: ID задачи, которую нужно запустить (из job.id), вместо отправки пинга по URL. Взаимоисключающийся с —url.
--domain [repo|discussion]: Домен для отслеживания: ‘repo’ или ‘discussion’. Можно указать несколько раз. По умолчанию отслеживаются все домены.
--secret TEXT: Необязательный секрет, используемый для подписи полезных данных вебхука.
-s, --secrets TEXT: Задаёт секретные переменные окружения. Рекомендуется использовать --secrets SECRET, чтобы читать значение из вашего окружения (например, --secrets HF_TOKEN для передачи вашего токена Hugging Face); --secrets SECRET=value сохраняет значение в истории командной строки.
--secrets-file TEXT: Читает файл с секретными переменными окружения. Используйте -, чтобы читать их из stdin.
--token TEXT: токен доступа пользователя, созданный на странице https://huggingface.co/settings/tokens.
--help: Показать это сообщение и выйти.

Примеры $ hf webhooks create —url https://example.com/hook —watch model:bert-base-uncased $ hf webhooks create —url https://example.com/hook —watch org:HuggingFace —watch model:gpt2 —domain repo $ hf webhooks create —job-id 687f911eaea852de79c4a50a —watch user:julien-c $ hf webhooks create —job-id 687f911eaea852de79c4a50a —watch bucket:my-org/my-bucket —secrets HF_TOKEN

hf webhooks delete

Безвозвратно удалить вебхук.

Использование:

$ hf webhooks delete [OPTIONS] WEBHOOK_ID

Аргументы:

WEBHOOK_ID: идентификатор вебхука, который нужно удалить. [обязательный]

Параметры:

-y, --yes: Пропустить запрос подтверждения.
--token TEXT: токен доступа пользователя, созданный на странице https://huggingface.co/settings/tokens.
--help: Показать это сообщение и выйти.

Примеры $ hf webhooks delete abc123 $ hf webhooks delete abc123 —yes

hf webhooks disable

Отключить активный вебхук.

Использование:

$ hf webhooks disable [OPTIONS] WEBHOOK_ID

Аргументы:

WEBHOOK_ID: идентификатор вебхука, который нужно отключить. [обязательный]

Параметры:

--token TEXT: токен доступа пользователя, созданный на странице https://huggingface.co/settings/tokens.
--help: Показать это сообщение и выйти.

Примеры $ hf webhooks disable abc123

hf webhooks enable

Включить отключённый вебхук.

Использование:

$ hf webhooks enable [OPTIONS] WEBHOOK_ID

Аргументы:

WEBHOOK_ID: идентификатор вебхука, который нужно включить. [обязательный]

Параметры:

--token TEXT: токен доступа пользователя, созданный на странице https://huggingface.co/settings/tokens.
--help: Показать это сообщение и выйти.

Примеры $ hf webhooks enable abc123

hf webhooks info

Показать все детали для одного вебхука.

Использование:

$ hf webhooks info [OPTIONS] WEBHOOK_ID

Аргументы:

WEBHOOK_ID: идентификатор вебхука. [обязательный]

Параметры:

--token TEXT: токен доступа пользователя, созданный на странице https://huggingface.co/settings/tokens.
--help: Показать это сообщение и выйти.

Примеры $ hf webhooks info abc123

hf webhooks list

Получить список всех вебхуков для текущего пользователя. [alias: ls]

Использование:

$ hf webhooks list [OPTIONS]

Параметры:

--token TEXT: токен доступа пользователя, созданный на странице https://huggingface.co/settings/tokens.
--help: Показать это сообщение и выйти.

Примеры $ hf webhooks ls $ hf webhooks ls —format json $ hf webhooks ls —format quiet

hf webhooks update

Обновление существующего вебхука. Изменяются только переданные параметры.

Секреты задания, переданные с помощью —secrets, заменяют сохранённые значения с тем же именем; остальные сохраняются.

Использование:

$ hf webhooks update [OPTIONS] WEBHOOK_ID

Аргументы:

WEBHOOK_ID: идентификатор вебхука, который нужно обновить. [обязательный]

Параметры:

--url TEXT: Новый URL для отправки полезных данных вебхука.
--job-id TEXT: ID исходного Job, который нужно запустить (может быть текущим). Обязателен при использовании —secrets / —secrets-file.
--watch TEXT: Новый список элементов для отслеживания в формате ‘type:name’. Можно указывать несколько раз. Заменяет весь существующий список отслеживаемых элементов.
--domain [repo|discussion]: новый список доменов для отслеживания: ‘repo’ или ‘discussion’. Можно указать несколько раз.
--secret TEXT: Новый секрет, используемый для подписи полезных данных вебхуков.
-s, --secrets TEXT: Задаёт секретные переменные окружения. Рекомендуется использовать --secrets SECRET, чтобы читать значение из вашего окружения (например, --secrets HF_TOKEN для передачи вашего токена Hugging Face); --secrets SECRET=value сохраняет значение в истории командной строки.
--secrets-file TEXT: Читает файл с секретными переменными окружения. Используйте -, чтобы читать их из stdin.
--token TEXT: токен доступа пользователя, созданный на странице https://huggingface.co/settings/tokens.
--help: Показать это сообщение и выйти.

Примеры $ hf webhooks update abc123 —url https://new-url.com/hook $ hf webhooks update abc123 —watch model:gpt2 —domain repo $ hf webhooks update abc123 —secret newsecret $ hf webhooks update abc123 —job-id 687f911eaea852de79c4a50a —secrets HF_TOKEN

Update on GitHub

←API Hugging Face Hub Загрузка файлов→