# ВНИМАНИЕ
# Этот файл целиком был сгенерирован из реализации CLI `hf`.
# Чтобы повторно сгенерировать код, выполните `make style` или `python ./utils/generate_cli_reference.py --update`.
# ВНИМАНИЕ
-->

# `hf`

CLI Hugging Face Hub

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

```console
$ 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`

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

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

```console
$ 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]

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

```console
$ 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.

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

```console
$ 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 <command> --help` для получения дополнительной информации о команде. Прочитайте документацию по адресу https://huggingface.co/docs/huggingface_hub/en/guides/cli

### `hf auth logout`

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

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

```console
$ hf auth logout [OPTIONS]
```

**Параметры**:

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

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

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

### `hf auth switch`

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

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

```console
$ 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 <command> --help` для получения дополнительной информации о команде. Прочитайте документацию по адресу https://huggingface.co/docs/huggingface_hub/en/guides/cli

### `hf auth token`

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

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

```console
$ hf auth token [OPTIONS]
```

**Параметры**:

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

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

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

### `hf auth whoami`

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

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

```console
$ hf auth whoami [OPTIONS]
```

**Параметры**:

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

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

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

## `hf buckets`

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

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

```console
$ 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).

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

```console
$ 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 <command> --help` для получения дополнительной информации о команде. Прочитайте документацию по адресу https://huggingface.co/docs/huggingface_hub/en/guides/cli

### `hf buckets create`

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

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

```console
$ 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 <command> --help` для получения дополнительной информации о команде. Прочитайте документацию по адресу https://huggingface.co/docs/huggingface_hub/en/guides/cli

### `hf buckets delete`

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

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

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

```console
$ 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 <command> --help` для получения дополнительной информации о команде. Прочитайте документацию по адресу https://huggingface.co/docs/huggingface_hub/en/guides/cli

### `hf buckets info`

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

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

```console
$ 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 <command> --help` для получения дополнительной информации о команде. Прочитайте документацию по адресу https://huggingface.co/docs/huggingface_hub/en/guides/cli

### `hf buckets list`

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

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

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

```console
$ 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 <command> --help` для получения дополнительной информации о команде. Прочитайте документацию по адресу https://huggingface.co/docs/huggingface_hub/en/guides/cli

### `hf buckets move`

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

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

```console
$ 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 <command> --help` для получения дополнительной информации о команде. Прочитайте документацию по адресу https://huggingface.co/docs/huggingface_hub/en/guides/cli

### `hf buckets remove`

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

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

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

```console
$ 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 <command> --help` для получения дополнительной информации о команде. Прочитайте документацию по адресу https://huggingface.co/docs/huggingface_hub/en/guides/cli

### `hf buckets settings`

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

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

```console
$ 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 <command> --help` для получения дополнительной информации о команде. Прочитайте документацию по адресу https://huggingface.co/docs/huggingface_hub/en/guides/cli

### `hf buckets sync`

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

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

```console
$ 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 <command> --help` для получения дополнительной информации о команде. Прочитайте документацию по адресу https://huggingface.co/docs/huggingface_hub/en/guides/cli

## `hf cache`

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

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

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

**Параметры**:

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

**Команды**:

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

### `hf cache list`

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

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

```console
$ 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 <command> --help` для получения дополнительной информации о команде. Прочитайте документацию по адресу https://huggingface.co/docs/huggingface_hub/en/guides/cli

### `hf cache prune`

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

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

```console
$ 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 <command> --help` для получения дополнительной информации о команде. Прочитайте документацию по адресу https://huggingface.co/docs/huggingface_hub/en/guides/cli

### `hf cache rm`

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

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

```console
$ 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 $ hf cache rm model/gpt2 --dry-run $ hf cache rm model/gpt2 --yes

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

### `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`

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

```console
$ 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 <command> --help` для получения дополнительной информации о команде. Прочитайте документацию по адресу https://huggingface.co/docs/huggingface_hub/en/guides/cli

## `hf collections`

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

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

```console
$ 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`

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

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

```console
$ 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 <command> --help` для получения дополнительной информации о команде. Прочитайте документацию по адресу https://huggingface.co/docs/huggingface_hub/en/guides/cli

### `hf collections create`

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

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

```console
$ 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 <command> --help` для получения дополнительной информации о команде. Прочитайте документацию по адресу https://huggingface.co/docs/huggingface_hub/en/guides/cli

### `hf collections delete`

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

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

```console
$ 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 <command> --help` для получения дополнительной информации о команде. Прочитайте документацию по адресу https://huggingface.co/docs/huggingface_hub/en/guides/cli

### `hf collections delete-item`

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

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

```console
$ 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.

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

```console
$ 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 <command> --help` для получения дополнительной информации о команде. Прочитайте документацию по адресу https://huggingface.co/docs/huggingface_hub/en/guides/cli

### `hf collections list`

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

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

```console
$ 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 <command> --help` для получения дополнительной информации о команде. Прочитайте документацию по адресу https://huggingface.co/docs/huggingface_hub/en/guides/cli

### `hf collections update`

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

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

```console
$ 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 <command> --help` для получения дополнительной информации о команде. Прочитайте документацию по адресу https://huggingface.co/docs/huggingface_hub/en/guides/cli

### `hf collections update-item`

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

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

```console
$ 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 <command> --help` для получения дополнительной информации о команде. Прочитайте документацию по адресу https://huggingface.co/docs/huggingface_hub/en/guides/cli

## `hf cp`

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

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

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

```console
$ 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 <command> --help` для получения дополнительной информации о команде. Прочитайте документацию по адресу https://huggingface.co/docs/huggingface_hub/en/guides/cli

## `hf datasets`

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

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

```console
$ 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.

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

```console
$ 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 <command> --help` для получения дополнительной информации о команде. Прочитайте документацию по адресу https://huggingface.co/docs/huggingface_hub/en/guides/cli

### `hf datasets info`

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

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

```console
$ 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 <command> --help` для получения дополнительной информации о команде. Прочитайте документацию по адресу https://huggingface.co/docs/huggingface_hub/en/guides/cli

### `hf datasets leaderboard`

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

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

```console
$ 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 <command> --help` для получения дополнительной информации о команде. Прочитайте документацию по адресу https://huggingface.co/docs/huggingface_hub/en/guides/cli

### `hf datasets list`

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

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

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

```console
$ 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 <command> --help` для получения дополнительной информации о команде. Прочитайте документацию по адресу https://huggingface.co/docs/huggingface_hub/en/guides/cli

### `hf datasets parquet`

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

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

```console
$ 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 <command> --help` для получения дополнительной информации о команде. Прочитайте документацию по адресу https://huggingface.co/docs/huggingface_hub/en/guides/cli

### `hf datasets sql`

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

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

```console
$ 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 <command> --help` для получения дополнительной информации о команде. Прочитайте документацию по адресу https://huggingface.co/docs/huggingface_hub/en/guides/cli

## `hf discussions`

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

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

```console
$ 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.

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

```console
$ 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 "Closing as resolved."

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

### `hf discussions comment`

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

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

```console
$ 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'. Ссылка '![alt](FILE)' в тексте заменяется загруженным файлом, остальные файлы добавляются в конец. Можно использовать несколько раз.
* `--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 <command> --help` для получения дополнительной информации о команде. Прочитайте документацию по адресу https://huggingface.co/docs/huggingface_hub/en/guides/cli

### `hf discussions create`

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

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

```console
$ 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'. Ссылка '![alt](FILE)' в тексте заменяется загруженным файлом, остальные файлы добавляются в конец. Можно использовать несколько раз.
* `--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 <command> --help` для получения дополнительной информации о команде. Прочитайте документацию по адресу https://huggingface.co/docs/huggingface_hub/en/guides/cli

### `hf discussions diff`

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

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

```console
$ 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 <command> --help` для получения дополнительной информации о команде. Прочитайте документацию по адресу https://huggingface.co/docs/huggingface_hub/en/guides/cli

### `hf discussions edit`

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

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

```console
$ 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`: читать новый комментарий из файла. Используйте «-» для стандартного ввода.
* `--attach TEXT`: Прикрепить файл изображения, видео или аудио в формате 'FILE' или 'FILE#alt text'. Ссылка '![alt](FILE)' в тексте заменяется загруженным файлом, остальные файлы добавляются в конец. Можно использовать несколько раз.
* `--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](./after.png)" --attach ./after.png

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

### `hf discussions info`

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

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

```console
$ 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 <command> --help` для получения дополнительной информации о команде. Прочитайте документацию по адресу https://huggingface.co/docs/huggingface_hub/en/guides/cli

### `hf discussions list`

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

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

```console
$ 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 <command> --help` для получения дополнительной информации о команде. Прочитайте документацию по адресу https://huggingface.co/docs/huggingface_hub/en/guides/cli

### `hf discussions merge`

Слить pull request.

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

```console
$ 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 <command> --help` для получения дополнительной информации о команде. Прочитайте документацию по адресу https://huggingface.co/docs/huggingface_hub/en/guides/cli

### `hf discussions rename`

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

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

```console
$ 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 <command> --help` для получения дополнительной информации о команде. Прочитайте документацию по адресу https://huggingface.co/docs/huggingface_hub/en/guides/cli

### `hf discussions reopen`

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

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

```console
$ 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 <command> --help` для получения дополнительной информации о команде. Прочитайте документацию по адресу https://huggingface.co/docs/huggingface_hub/en/guides/cli

## `hf download`

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

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

```console
$ 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 <command> --help` для получения дополнительной информации о команде. Прочитайте документацию по адресу https://huggingface.co/docs/huggingface_hub/en/guides/cli

## `hf endpoints`

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

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

```console
$ 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.

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

```console
$ 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.

Catalog models are deployed through a recipe: a hardware and engine combination that has been tested for them. Pass --repo to deploy the default recipe of a model, optionally narrowed down with --accelerator and --gguf-file, or pass --recipe to deploy an exact recipe listed by `hf endpoints catalog ls`.

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

```console
$ 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 <command> --help` для получения дополнительной информации о команде. Прочитайте документацию по адресу https://huggingface.co/docs/huggingface_hub/en/guides/cli

#### `hf endpoints catalog list`

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

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

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

```console
$ 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 <command> --help` для получения дополнительной информации о команде. Прочитайте документацию по адресу https://huggingface.co/docs/huggingface_hub/en/guides/cli

### `hf endpoints delete`

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

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

```console
$ 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 <command> --help` для получения дополнительной информации о команде. Прочитайте документацию по адресу https://huggingface.co/docs/huggingface_hub/en/guides/cli

### `hf endpoints deploy`

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

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

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

```console
$ 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 <command> --help` для получения дополнительной информации о команде. Прочитайте документацию по адресу https://huggingface.co/docs/huggingface_hub/en/guides/cli

### `hf endpoints describe`

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

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

```console
$ hf endpoints describe [OPTIONS] NAME
```

**Аргументы**:

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

**Параметры**:

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

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

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

### `hf endpoints hardware`

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

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

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

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

```console
$ 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 <command> --help` для получения дополнительной информации о команде. Прочитайте документацию по адресу https://huggingface.co/docs/huggingface_hub/en/guides/cli

### `hf endpoints list`

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

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

```console
$ 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 <command> --help` для получения дополнительной информации о команде. Прочитайте документацию по адресу https://huggingface.co/docs/huggingface_hub/en/guides/cli

### `hf endpoints list-catalog`

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

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

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

```console
$ 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`

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

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

```console
$ hf endpoints pause [OPTIONS] NAME
```

**Аргументы**:

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

**Параметры**:

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

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

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

### `hf endpoints resume`

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

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

```console
$ 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 <command> --help` для получения дополнительной информации о команде. Прочитайте документацию по адресу https://huggingface.co/docs/huggingface_hub/en/guides/cli

### `hf endpoints scale-to-zero`

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

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

```console
$ 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 <command> --help` для получения дополнительной информации о команде. Прочитайте документацию по адресу https://huggingface.co/docs/huggingface_hub/en/guides/cli

### `hf endpoints update`

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

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

```console
$ 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 <command> --help` для получения дополнительной информации о команде. Прочитайте документацию по адресу https://huggingface.co/docs/huggingface_hub/en/guides/cli

## `hf env`

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

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

```console
$ hf env [OPTIONS]
```

**Параметры**:

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

## `hf extensions`

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

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

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

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

**Параметры**:

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

**Команды**:

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

### `hf extensions exec`

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

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

```console
$ hf extensions exec [OPTIONS] NAME
```

**Аргументы**:

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

**Параметры**:

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

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

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

### `hf extensions install`

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

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

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

```console
$ 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 <command> --help` для получения дополнительной информации о команде. Прочитайте документацию по адресу https://huggingface.co/docs/huggingface_hub/en/guides/cli

### `hf extensions list`

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

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

```console
$ hf extensions list [OPTIONS]
```

**Параметры**:

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

Примеры hf extensions list

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

### `hf extensions remove`

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

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

```console
$ hf extensions remove [OPTIONS] NAME
```

**Аргументы**:

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

**Параметры**:

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

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

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

### `hf extensions search`

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

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

```console
$ hf extensions search [OPTIONS]
```

**Параметры**:

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

Примеры hf extensions search

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

### `hf extensions update`

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

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

```console
$ 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 <command> --help` для получения дополнительной информации о команде. Прочитайте документацию по адресу https://huggingface.co/docs/huggingface_hub/en/guides/cli

## `hf jobs`

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

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

```console
$ 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`

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

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

```console
$ hf jobs cancel [OPTIONS] JOB_ID
```

**Аргументы**:

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

**Параметры**:

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

Примеры hf jobs cancel

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

### `hf jobs expose`

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

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

```console
$ 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  8000 $ hf jobs expose  8000 --public 9000 $ hf jobs expose  --clear

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

### `hf jobs hardware`

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

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

```console
$ hf jobs hardware [OPTIONS]
```

**Параметры**:

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

Примеры hf jobs hardware

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

### `hf jobs inspect`

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

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

```console
$ hf jobs inspect [OPTIONS] JOB_IDS...
```

**Аргументы**:

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

**Параметры**:

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

Примеры hf jobs inspect

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

### `hf jobs labels`

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

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

```console
$ 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  --name training-v2 $ hf jobs labels  --label env=prod --label team=ml $ hf jobs labels  --clear

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

### `hf jobs list | ls | ps`

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

Используйте `--status` для фильтрации по статусу (см. [JobStage](/docs/huggingface_hub/v2.4.0/ru/package_reference/jobs#huggingface_hub.JobStage) для возможных значений) и `--label` для фильтрации по меткам `key=value`. Для отображения в списке Job должен соответствовать каждому фильтру.

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

```console
$ 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 <command> --help` для получения дополнительной информации о команде. Прочитайте документацию по адресу https://huggingface.co/docs/huggingface_hub/en/guides/cli

### `hf jobs logs`

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

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

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

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

```console
$ 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 $ hf jobs logs -f $ hf jobs logs --tail 20 $ hf jobs logs -f --tail 100

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

### `hf jobs rerun`

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

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

```console
$ 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 $ hf jobs rerun --detach

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

### `hf jobs run`

Запустите Job.

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

```console
$ 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 <command> --help` для получения дополнительной информации о команде. Прочитайте документацию по адресу https://huggingface.co/docs/huggingface_hub/en/guides/cli

### `hf jobs scheduled`

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

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

```console
$ 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`

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

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

```console
$ 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

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

#### `hf jobs scheduled inspect`

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

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

```console
$ 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

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

#### `hf jobs scheduled labels`

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

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

```console
$ 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  --name daily-script hf jobs scheduled labels  --label env=prod --label team=ml hf jobs scheduled labels  --clear

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

#### `hf jobs scheduled list | ls | ps`

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

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

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

```console
$ 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 <command> --help` для получения дополнительной информации о команде. Прочитайте документацию по адресу https://huggingface.co/docs/huggingface_hub/en/guides/cli

#### `hf jobs scheduled reschedule`

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

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

```console
$ 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  "0 9 * * 1"

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

#### `hf jobs scheduled resume`

Resume (возобновить) запланированную Job.

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

```console
$ 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

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

#### `hf jobs scheduled run`

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

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

```console
$ 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 <command> --help` для получения дополнительной информации о команде. Прочитайте документацию по адресу https://huggingface.co/docs/huggingface_hub/en/guides/cli

#### `hf jobs scheduled suspend`

Suspend (пауза) запланированной задачи (Job).

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

```console
$ 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

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

#### `hf jobs scheduled trigger`

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

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

```console
$ 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

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

#### `hf jobs scheduled uv`

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

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

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

**Параметры**:

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

**Команды**:

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

##### `hf jobs scheduled uv run`

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

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

```console
$ 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 <command> --help` для получения дополнительной информации о команде. Прочитайте документацию по адресу https://huggingface.co/docs/huggingface_hub/en/guides/cli

### `hf jobs ssh`

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

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

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

```console
$ 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 $ hf jobs ssh  --dry-run $ hf jobs ssh  -i ~/.ssh/id_ed25519

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

### `hf jobs stats`

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

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

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

```console
$ 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 hf jobs stats -f

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

### `hf jobs uv`

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

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

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

**Параметры**:

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

**Команды**:

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

#### `hf jobs uv run`

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

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

```console
$ 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 <command> --help` для получения дополнительной информации о команде. Прочитайте документацию по адресу https://huggingface.co/docs/huggingface_hub/en/guides/cli

### `hf jobs wait`

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

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

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

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

```console
$ 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 $ hf jobs wait $ hf jobs ls -q | xargs hf jobs wait

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

## `hf lfs-enable-largefiles`

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

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

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

```console
$ hf lfs-enable-largefiles [OPTIONS] PATH
```

**Аргументы**:

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

**Параметры**:

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

## `hf lfs-multipart-upload`

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

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

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

```console
$ hf lfs-multipart-upload [OPTIONS]
```

**Параметры**:

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

## `hf models`

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

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

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

**Параметры**:

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

**Команды**:

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

### `hf models card`

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

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

```console
$ 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 <command> --help` для получения дополнительной информации о команде. Прочитайте документацию по адресу https://huggingface.co/docs/huggingface_hub/en/guides/cli

### `hf models info`

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

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

```console
$ 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 <command> --help` для получения дополнительной информации о команде. Прочитайте документацию по адресу https://huggingface.co/docs/huggingface_hub/en/guides/cli

### `hf models list`

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

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

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

```console
$ 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 <command> --help` для получения дополнительной информации о команде. Прочитайте документацию по адресу https://huggingface.co/docs/huggingface_hub/en/guides/cli

## `hf papers`

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

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

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

**Параметры**:

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

**Команды**:

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

### `hf papers info`

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

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

```console
$ 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 <command> --help` для получения дополнительной информации о команде. Прочитайте документацию по адресу https://huggingface.co/docs/huggingface_hub/en/guides/cli

### `hf papers list`

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

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

```console
$ 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 <command> --help` для получения дополнительной информации о команде. Прочитайте документацию по адресу https://huggingface.co/docs/huggingface_hub/en/guides/cli

### `hf papers read`

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

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

```console
$ 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 <command> --help` для получения дополнительной информации о команде. Прочитайте документацию по адресу https://huggingface.co/docs/huggingface_hub/en/guides/cli

### `hf papers search`

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

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

```console
$ 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 <command> --help` для получения дополнительной информации о команде. Прочитайте документацию по адресу https://huggingface.co/docs/huggingface_hub/en/guides/cli

## `hf repos`

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

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

```console
$ 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.

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

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

**Параметры**:

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

**Команды**:

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

#### `hf repos branch create`

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

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

```console
$ 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 <command> --help` для получения дополнительной информации о команде. Прочитайте документацию по адресу https://huggingface.co/docs/huggingface_hub/en/guides/cli

#### `hf repos branch delete`

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

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

```console
$ 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 <command> --help` для получения дополнительной информации о команде. Прочитайте документацию по адресу https://huggingface.co/docs/huggingface_hub/en/guides/cli

### `hf repos cp`

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

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

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

```console
$ 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 <command> --help` для получения дополнительной информации о команде. Прочитайте документацию по адресу https://huggingface.co/docs/huggingface_hub/en/guides/cli

### `hf repos create`

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

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

```console
$ 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 <command> --help` для получения дополнительной информации о команде. Прочитайте документацию по адресу https://huggingface.co/docs/huggingface_hub/en/guides/cli

### `hf repos delete`

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

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

```console
$ 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 <command> --help` для получения дополнительной информации о команде. Прочитайте документацию по адресу https://huggingface.co/docs/huggingface_hub/en/guides/cli

### `hf repos delete-files`

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

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

```console
$ 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 <command> --help` для получения дополнительной информации о команде. Прочитайте документацию по адресу https://huggingface.co/docs/huggingface_hub/en/guides/cli

### `hf repos duplicate`

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

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

```console
$ 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 <command> --help` для получения дополнительной информации о команде. Прочитайте документацию по адресу https://huggingface.co/docs/huggingface_hub/en/guides/cli

### `hf repos list`

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

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

```console
$ 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 <command> --help` для получения дополнительной информации о команде. Прочитайте документацию по адресу https://huggingface.co/docs/huggingface_hub/en/guides/cli

### `hf repos move`

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

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

```console
$ 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 <command> --help` для получения дополнительной информации о команде. Прочитайте документацию по адресу https://huggingface.co/docs/huggingface_hub/en/guides/cli

### `hf repos settings`

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

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

```console
$ 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 <command> --help` для получения дополнительной информации о команде. Прочитайте документацию по адресу https://huggingface.co/docs/huggingface_hub/en/guides/cli

### `hf repos tag`

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

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

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

**Параметры**:

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

**Команды**:

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

#### `hf repos tag create`

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

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

```console
$ 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 <command> --help` для получения дополнительной информации о команде. Прочитайте документацию по адресу https://huggingface.co/docs/huggingface_hub/en/guides/cli

#### `hf repos tag delete`

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

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

```console
$ 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 <command> --help` для получения дополнительной информации о команде. Прочитайте документацию по адресу https://huggingface.co/docs/huggingface_hub/en/guides/cli

#### `hf repos tag list`

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

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

```console
$ 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 <command> --help` для получения дополнительной информации о команде. Прочитайте документацию по адресу https://huggingface.co/docs/huggingface_hub/en/guides/cli

## `hf sandbox`

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

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

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

**Параметры**:

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

**Команды**:

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

### `hf sandbox cp`

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

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

```console
$ hf sandbox cp [OPTIONS] SRC DST
```

**Аргументы**:

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

**Параметры**:

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

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

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

### `hf sandbox create`

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

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

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

```console
$ 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 <command> --help` для получения дополнительной информации о команде. Прочитайте документацию по адресу https://huggingface.co/docs/huggingface_hub/en/guides/cli

### `hf sandbox exec`

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

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

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

```console
$ 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  -- python -c "print(42)" $ hf sandbox exec -w /app  -- pytest -x

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

### `hf sandbox kill`

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

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

```console
$ hf sandbox kill [OPTIONS] [SANDBOX_ID]
```

**Аргументы**:

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

**Параметры**:

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

Примеры $ hf sandbox kill $ hf sandbox kill    # останавливает весь общий хост (все его песочницы) $ hf sandbox kill --all

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

### `hf sandbox pool`

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

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

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

**Параметры**:

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

**Команды**:

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

#### `hf sandbox pool create`

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

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

```console
$ 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 <command> --help` для получения дополнительной информации о команде. Прочитайте документацию по адресу https://huggingface.co/docs/huggingface_hub/en/guides/cli

#### `hf sandbox pool delete`

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

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

```console
$ 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

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

#### `hf sandbox pool ls`

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

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

```console
$ hf sandbox pool ls [OPTIONS]
```

**Параметры**:

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

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

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

### `hf sandbox process`

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

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

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

**Параметры**:

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

**Команды**:

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

#### `hf sandbox process kill`

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

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

```console
$ 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

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

#### `hf sandbox process ls`

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

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

```console
$ 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

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

### `hf sandbox spawn`

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

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

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

```console
$ 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  -- python -m http.server 8000 $ hf sandbox spawn -w /app  -- uvicorn app:app

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

## `hf skills`

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

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

```console
$ 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`.

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

```console
$ 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 <command> --help` для получения дополнительной информации о команде. Прочитайте документацию по адресу https://huggingface.co/docs/huggingface_hub/en/guides/cli

### `hf skills list`

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

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

```console
$ hf skills list [OPTIONS]
```

**Параметры**:

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

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

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

### `hf skills preview`

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

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

```console
$ hf skills preview [OPTIONS]
```

**Параметры**:

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

### `hf skills update`

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

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

```console
$ 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 <command> --help` для получения дополнительной информации о команде. Прочитайте документацию по адресу https://huggingface.co/docs/huggingface_hub/en/guides/cli

## `hf spaces`

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

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

```console
$ 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.

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

```console
$ 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 <command> --help` для получения дополнительной информации о команде. Прочитайте документацию по адресу https://huggingface.co/docs/huggingface_hub/en/guides/cli

### `hf spaces dev-mode`

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

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

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

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

```console
$ 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 <command> --help` для получения дополнительной информации о команде. Прочитайте документацию по адресу https://huggingface.co/docs/huggingface_hub/en/guides/cli

### `hf spaces hardware`

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

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

```console
$ hf spaces hardware [OPTIONS]
```

**Параметры**:

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

Примеры hf spaces hardware

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

### `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.

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

```console
$ 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     # Открыть интерактивный редактор для удалённого файла app.py $ hf spaces hot-reload username/repo-name -f app.py  # Взять локальную версию из ./app.py и применить изменения к app.py удалённо $ hf spaces hot-reload username/repo-name app.py -f src/app.py # Взять локальную версию из ./src/app.py

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

### `hf spaces info`

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

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

```console
$ 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 <command> --help` для получения дополнительной информации о команде. Прочитайте документацию по адресу https://huggingface.co/docs/huggingface_hub/en/guides/cli

### `hf spaces list`

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

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

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

```console
$ 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 <command> --help` для получения дополнительной информации о команде. Прочитайте документацию по адресу https://huggingface.co/docs/huggingface_hub/en/guides/cli

### `hf spaces logs`

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

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

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

```console
$ 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 <command> --help` для получения дополнительной информации о команде. Прочитайте документацию по адресу https://huggingface.co/docs/huggingface_hub/en/guides/cli

### `hf spaces pause`

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

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

```console
$ 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 <command> --help` для получения дополнительной информации о команде. Прочитайте документацию по адресу https://huggingface.co/docs/huggingface_hub/en/guides/cli

### `hf spaces restart`

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

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

```console
$ 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 <command> --help` для получения дополнительной информации о команде. Прочитайте документацию по адресу https://huggingface.co/docs/huggingface_hub/en/guides/cli

### `hf spaces search`

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

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

```console
$ 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 <command> --help` для получения дополнительной информации о команде. Прочитайте документацию по адресу https://huggingface.co/docs/huggingface_hub/en/guides/cli

### `hf spaces secrets`

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

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

```console
$ hf spaces secrets [OPTIONS] COMMAND [ARGS]...
```

**Параметры**:

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

**Команды**:

* `add`: добавляет или обновляет секреты для Space.
* `delete`: Удалить секрет из Space.
* `list`: Список секретов для Space. [alias: ls]

#### `hf spaces secrets add`

Добавьте или обновите секреты для Space.

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

```console
$ 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 <command> --help` для получения дополнительной информации о команде. Прочитайте документацию по адресу https://huggingface.co/docs/huggingface_hub/en/guides/cli

#### `hf spaces secrets delete`

Удалить секрет из Space.

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

```console
$ 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 <command> --help` для получения дополнительной информации о команде. Прочитайте документацию по адресу https://huggingface.co/docs/huggingface_hub/en/guides/cli

#### `hf spaces secrets list`

Список секретов для Space. Значения секретов доступны только для записи и не возвращаются. [alias: ls]

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

```console
$ 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 <command> --help` для получения дополнительной информации о команде. Прочитайте документацию по адресу https://huggingface.co/docs/huggingface_hub/en/guides/cli

### `hf spaces settings`

Обновите настройки Space.

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

```console
$ 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 <command> --help` для получения дополнительной информации о команде. Прочитайте документацию по адресу https://huggingface.co/docs/huggingface_hub/en/guides/cli

### `hf spaces ssh`

Подключитесь по SSH к контейнеру Dev Mode Space.

Для этого необходимо, чтобы в Space был запущен режим Dev Mode, а ваш публичный SSH-ключ был зарегистрирован по адресу https://huggingface.co/settings/keys.

См.: https://huggingface.co/docs/hub/spaces-dev-mode

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

```console
$ 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 <command> --help` для получения дополнительной информации о команде. Прочитайте документацию по адресу https://huggingface.co/docs/huggingface_hub/en/guides/cli

### `hf spaces templates`

Получите список доступных шаблонов Space.

Идентификатор `repo_id` (или `name`) шаблона можно передать в `hf repos create --template ...`, чтобы создать новое Space на основе этого шаблона.

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

```console
$ hf spaces templates [OPTIONS]
```

**Параметры**:

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

Примеры hf spaces templates

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

### `hf spaces variables`

Управление переменными окружения для Space на Hub.

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

```console
$ hf spaces variables [OPTIONS] COMMAND [ARGS]...
```

**Параметры**:

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

**Команды**:

* `add`: добавляет или обновляет переменные окружения для Space.
* `delete`: Удаляет переменную окружения из Space.
* `list`: Список переменных окружения для Space. [alias: ls]

#### `hf spaces variables add`

Добавьте или обновите переменные окружения для Space.

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

```console
$ 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 <command> --help` для получения дополнительной информации о команде. Прочитайте документацию по адресу https://huggingface.co/docs/huggingface_hub/en/guides/cli

#### `hf spaces variables delete`

Удалить переменную окружения из Space.

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

```console
$ 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 <command> --help` для получения дополнительной информации о команде. Прочитайте документацию по адресу https://huggingface.co/docs/huggingface_hub/en/guides/cli

#### `hf spaces variables list`

Список переменных окружения для Space. [alias: ls]

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

```console
$ 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 <command> --help` для получения дополнительной информации о команде. Прочитайте документацию по адресу https://huggingface.co/docs/huggingface_hub/en/guides/cli

### `hf spaces volumes`

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

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

```console
$ hf spaces volumes [OPTIONS] COMMAND [ARGS]...
```

**Параметры**:

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

**Команды**:

* `delete`: Удаляет все тома из Space.
* `list`: Список томов, смонтированных в Space. [alias: ls]
* `set`: Установить (заменить) тома для Space.

#### `hf spaces volumes delete`

Удалите все тома из Space.

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

```console
$ 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 <command> --help` для получения дополнительной информации о команде. Прочитайте документацию по адресу https://huggingface.co/docs/huggingface_hub/en/guides/cli

#### `hf spaces volumes list`

Список томов, смонтированных в Space. [alias: ls]

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

```console
$ 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 <command> --help` для получения дополнительной информации о команде. Прочитайте документацию по адресу https://huggingface.co/docs/huggingface_hub/en/guides/cli

#### `hf spaces volumes set`

Set (replace) тома для Space.

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

```console
$ 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 <command> --help` для получения дополнительной информации о команде. Прочитайте документацию по адресу https://huggingface.co/docs/huggingface_hub/en/guides/cli

### `hf spaces wait`

Дождитесь, пока Space завершит сборку/запуск.

Блокирует выполнение, пока Space не покинет промежуточное состояние (BUILDING, APP_STARTING и т. д.) и не перейдёт в стабильное состояние. Завершается с кодом 0, если Space находится в состоянии RUNNING, или с ненулевым кодом в противном случае (например, BUILD_ERROR, RUNTIME_ERROR).

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

```console
$ 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 <command> --help` для получения дополнительной информации о команде. Прочитайте документацию по адресу https://huggingface.co/docs/huggingface_hub/en/guides/cli

### `hf spaces zero-gpu`

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

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

```console
$ hf spaces zero-gpu [OPTIONS] COMMAND [ARGS]...
```

**Параметры**:

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

**Команды**:

* `quota`: показывает вашу квоту ZeroGPU (остаток времени на GPU и дата сброса).

#### `hf spaces zero-gpu quota`

Показать вашу квоту ZeroGPU (остаток времени на GPU и дата сброса).

Значения указаны в секундах GPU. При использовании `--quiet` выводится только оставшееся время в секундах GPU.

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

```console
$ 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 <command> --help` для получения дополнительной информации о команде. Прочитайте документацию по адресу https://huggingface.co/docs/huggingface_hub/en/guides/cli

## `hf sync`

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

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

```console
$ 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 до последней версии.

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

```console
$ hf update [OPTIONS]
```

**Параметры**:

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

## `hf upload`

Загрузите файл или папку в Hub.

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

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

```console
$ 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 <command> --help` для получения дополнительной информации о команде. Прочитайте документацию по адресу https://huggingface.co/docs/huggingface_hub/en/guides/cli

## `hf version`

Выводит информацию о версии hf.

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

```console
$ hf version [OPTIONS]
```

**Параметры**:

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

## `hf webhooks`

Управление вебхуками на Hub.

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

```console
$ 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.

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

```console
$ hf webhooks create [OPTIONS]
```

**Параметры**:

* `--watch TEXT`: Элемент для отслеживания в формате 'type:name' (например, 'model:bert-base-uncased'). Можно указать несколько раз.  [обязательный]
* `--url TEXT`: URL для отправки webhook-нагрузок. Взаимоисключающийся с --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 <command> --help` для получения дополнительной информации о команде. Прочитайте документацию по адресу https://huggingface.co/docs/huggingface_hub/en/guides/cli

### `hf webhooks delete`

Безвозвратно удалить вебхук.

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

```console
$ 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 <command> --help` для получения дополнительной информации о команде. Прочитайте документацию по адресу https://huggingface.co/docs/huggingface_hub/en/guides/cli

### `hf webhooks disable`

Отключить активный вебхук.

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

```console
$ hf webhooks disable [OPTIONS] WEBHOOK_ID
```

**Аргументы**:

* `WEBHOOK_ID`: идентификатор вебхука, который нужно отключить. [обязательный]

**Параметры**:

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

Примеры hf webhooks disable abc123

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

### `hf webhooks enable`

Включить отключённый вебхук.

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

```console
$ hf webhooks enable [OPTIONS] WEBHOOK_ID
```

**Аргументы**:

* `WEBHOOK_ID`: идентификатор вебхука, который нужно включить. [обязательный]

**Параметры**:

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

Примеры $ hf webhooks enable abc123

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

### `hf webhooks info`

Показать все детали для одного вебхука.

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

```console
$ hf webhooks info [OPTIONS] WEBHOOK_ID
```

**Аргументы**:

* `WEBHOOK_ID`: идентификатор вебхука. [обязательный]

**Параметры**:

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

Примеры $ hf webhooks info abc123

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

### `hf webhooks list`

Получить список всех вебхуков для текущего пользователя. [alias: ls]

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

```console
$ 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 <command> --help` для получения дополнительной информации о команде. Прочитайте документацию по адресу https://huggingface.co/docs/huggingface_hub/en/guides/cli

### `hf webhooks update`

Обновление существующего вебхука. Изменяются только переданные параметры.

Секреты задания, переданные с помощью --secrets, заменяют сохранённые значения с тем же именем; остальные сохраняются.

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

```console
$ 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

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