# ADVERTENCIA
# Este archivo completo se ha generado a partir de la implementación de la CLI `hf`.
# Para regenerar el código, ejecute `make style` o `python ./utils/generate_cli_reference.py --update`.
# ADVERTENCIA
-->

# `hf`

CLI de Hugging Face Hub

**Uso**:

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

**Opciones**:

* `--skills`: Imprime el `hf-cli` SKILL.md en stdout (alias de `hf skills preview`).
* `--install-completion`: Instala la autocompletación para el shell actual.
* `--show-completion`: Muestra la autocompletación para el shell actual, para copiarla o personalizar la instalación.
* `--help`: Muestra este mensaje y sale.

**Comandos**:

* `auth`: Gestionar la autenticación (inicio de sesión, cierre de sesión, etc.).
* `buckets`: Comandos para interactuar con buckets.
* `cache`: Gestiona el directorio de caché local.
* `collections`: Interactuar con colecciones en el Hub.
* `cp`: Copia archivos entre rutas locales, repositorios y cubos.
* `datasets`: Interactuar con los conjuntos de datos en el Hub.
* `discussions`: Gestiona las discusiones y las pull requests en el Hub.
* `download`: Descarga archivos desde el Hub.
* `endpoints`: Gestionar los Hugging Face Inference Endpoints.
* `env`: Imprime información sobre el entorno.
* `extensions`: Gestiona las extensiones de la CLI de hf. [alias: ext]
* `jobs`: Ejecutar y gestionar Jobs en el Hub.
* `lfs-enable-largefiles`: Configura tu repositorio para habilitar la carga de archivos > 5GB.
* `lfs-multipart-upload`: Agente de transferencia personalizado de git-lfs para subidas multipartes.
* `models`: Interactuar con los modelos del Hub.
* `papers`: Interactúa con los papers en el Hub.
* `repos`: Gestiona repositorios en el Hub.
* `sandbox`: Ejecuta y gestiona sandboxes experimentales en Hugging Face Jobs.
* `skills`: Gestionar habilidades para asistentes de IA.
* `spaces`: Interactuar con espacios en el Hub.
* `sync`: Sincroniza archivos entre un directorio local y un bucket.
* `update`: Actualiza la CLI `hf` a la última versión.
* `upload`: Sube un archivo o una carpeta al Hub.
* `version`: Imprime información sobre la versión de hf.
* `webhooks`: Gestionar webhooks en el Hub.

## `hf auth`

Gestionar la autenticación (inicio de sesión, cierre de sesión, etc.).

**Uso**:

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

**Opciones**:

* `--help`: Muestra este mensaje y sale.

**Comandos**:

* `list`: Lista todos los tokens de acceso almacenados. [alias: ls]
* `login`: Inicia sesión desde tu navegador o usando un token de huggingface.co/settings/tokens.
* `logout`: Cerrar sesión con un token específico.
* `switch`: Cambia entre tokens de acceso.
* `token`: Imprime el token de acceso actual en stdout.
* `whoami`: Descubre con qué cuenta de huggingface.co has iniciado sesión.

### `hf auth list`

Listar todos los tokens de acceso almacenados. [alias: ls]

**Uso**:

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

**Opciones**:

* `--help`: Muestra este mensaje y sale.

Ejemplos $ hf auth list

Más información Utilice `hf <command> --help` para obtener más información sobre un comando. Lea la documentación en https://huggingface.co/docs/huggingface_hub/en/guides/cli

### `hf auth login`

Inicia sesión desde tu navegador o usando un token de huggingface.co/settings/tokens.

**Uso**:

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

**Opciones**:

* `--token TEXT`: un User Access Token generado desde https://huggingface.co/settings/tokens.
* `--add-to-git-credential / --no-add-to-git-credential`: Guardar en el helper de credenciales de git. Útil solo si planeas ejecutar comandos de git directamente. [predeterminado: no-add-to-git-credential]
* `--force / --no-force`: Fuerza el inicio de sesión de nuevo aunque ya se haya iniciado sesión. [predeterminado: no-force]
* `--help`: Muestra este mensaje y sale.

Ejemplos $ hf auth login $ hf auth login --token $HF_TOKEN $ hf auth login --token $HF_TOKEN --add-to-git-credential $ hf auth login --force

Más información Utilice `hf <command> --help` para obtener más información sobre un comando. Lea la documentación en https://huggingface.co/docs/huggingface_hub/en/guides/cli

### `hf auth logout`

Cerrar sesión con un token específico.

**Uso**:

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

**Opciones**:

* `--token-name TEXT`: Nombre del token para cerrar la sesión
* `--help`: Muestra este mensaje y sale.

Ejemplos $ hf auth logout $ hf auth logout --token-name my-token

Más información Utilice `hf <command> --help` para obtener más información sobre un comando. Lea la documentación en https://huggingface.co/docs/huggingface_hub/en/guides/cli

### `hf auth switch`

Cambiar entre tokens de acceso.

**Uso**:

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

**Opciones**:

* `--token-name TEXT`: Nombre del token al que cambiar
* `--add-to-git-credential / --no-add-to-git-credential`: Guardar en el helper de credenciales de git. Útil solo si planeas ejecutar comandos de git directamente. [predeterminado: no-add-to-git-credential]
* `--help`: Muestra este mensaje y sale.

Ejemplos $ hf auth switch $ hf auth switch --token-name my-token

Más información Utilice `hf <command> --help` para obtener más información sobre un comando. Lea la documentación en https://huggingface.co/docs/huggingface_hub/en/guides/cli

### `hf auth token`

Imprime el token de acceso actual en la salida estándar.

**Uso**:

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

**Opciones**:

* `--help`: Muestra este mensaje y sale.

Ejemplos $ hf auth token $ hf auth token | xargs curl -H 'Authorization: Bearer {}'

Más información Utilice `hf <command> --help` para obtener más información sobre un comando. Lea la documentación en https://huggingface.co/docs/huggingface_hub/en/guides/cli

### `hf auth whoami`

Descubre con qué cuenta de huggingface.co has iniciado sesión.

**Uso**:

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

**Opciones**:

* `--help`: Muestra este mensaje y sale.

Ejemplos $ hf auth whoami $ hf auth whoami --format json

Más información Utilice `hf <command> --help` para obtener más información sobre un comando. Lea la documentación en https://huggingface.co/docs/huggingface_hub/en/guides/cli

## `hf buckets`

Comandos para interactuar con cubos.

**Uso**:

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

**Opciones**:

* `--help`: Muestra este mensaje y sale.

**Comandos**:

* `cp`: Copia archivos entre rutas locales, repositorios y cubos.
* `create`: Crea un nuevo bucket.
* `delete`: Elimina un bucket.
* `info`: Obtiene información sobre un bucket.
* `list`: Lista los cubos o los archivos de un cubo. [alias: ls]
* `move`: Mover (renombrar) un bucket a un nuevo nombre o espacio de nombres.
* `remove`: Elimina archivos de un bucket. [alias: rm]
* `settings`: Actualizar la configuración del cubo (visibilidad).
* `sync`: Sincroniza archivos entre un directorio local y un bucket.

### `hf buckets cp`

Copiar archivos entre rutas locales, repositorios y cubos.

Gestiona las cargas (local/stdin -> repo/bucket), las descargas (repo/bucket -> local/stdout) y las copias remotas (repo/bucket -> repo/bucket). No se admiten las copias de bucket a repo ni las copias locales. Para directorios, use `hf upload`/`hf download` (repos) o `hf buckets sync` (buckets). Las copias remotas solo funcionan dentro de la misma región de almacenamiento (https://huggingface.co/docs/hub/storage-regions).

**Uso**:

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

**Argumentos**:

* `SRC`: Origen: archivo local, URI hf:// (repositorio o bucket) o - para stdin. [obligatorio]
* `[DST]`: Destino: ruta local, URI hf:// (repositorio o bucket) o - para stdout.

**Opciones**:

* `--token TEXT`: un User Access Token generado desde https://huggingface.co/settings/tokens.
* `--help`: Muestra este mensaje y sale.

Ejemplos $ 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/

Más información Utilice `hf <command> --help` para obtener más información sobre un comando. Lea la documentación en https://huggingface.co/docs/huggingface_hub/en/guides/cli

### `hf buckets create`

Crea un nuevo bucket.

**Uso**:

```console
$ hf buckets create [OPTIONS] BUCKET_ID
```

**Argumentos**:

* `BUCKET_ID`: ID del bucket: bucket_name, namespace/bucket_name o hf://buckets/namespace/bucket_name  [obligatorio]

**Opciones**:

* `--private`: Crea un bucket privado.
* `--region [us|eu]`: Región de la nube en la que se creará el bucket. Puede ser 'us' o 'eu'. Requiere un plan Team o superior.
* `--exist-ok`: No genera un error si el bucket ya existe.
* `--token TEXT`: un User Access Token generado desde https://huggingface.co/settings/tokens.
* `--help`: Muestra este mensaje y sale.

Ejemplos $ 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

Más información Utilice `hf <command> --help` para obtener más información sobre un comando. Lea la documentación en https://huggingface.co/docs/huggingface_hub/en/guides/cli

### `hf buckets delete`

Eliminar un bucket.

Esto elimina el bucket completo y todo su contenido. Use `hf buckets rm` para eliminar archivos individuales.

**Uso**:

```console
$ hf buckets delete [OPTIONS] BUCKET_ID
```

**Argumentos**:

* `BUCKET_ID`: ID del bucket: namespace/bucket_name o hf://buckets/namespace/bucket_name  [obligatorio]

**Opciones**:

* `-y, --yes`: Omite la solicitud de confirmación.
* `--missing-ok`: No genera un error si el bucket no existe.
* `--token TEXT`: un User Access Token generado desde https://huggingface.co/settings/tokens.
* `--help`: Muestra este mensaje y sale.

Ejemplos $ 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

Más información Utilice `hf <command> --help` para obtener más información sobre un comando. Lea la documentación en https://huggingface.co/docs/huggingface_hub/en/guides/cli

### `hf buckets info`

Obtén información sobre un bucket.

**Uso**:

```console
$ hf buckets info [OPTIONS] BUCKET_ID
```

**Argumentos**:

* `BUCKET_ID`: ID del bucket: namespace/bucket_name o hf://buckets/namespace/bucket_name  [obligatorio]

**Opciones**:

* `--token TEXT`: un User Access Token generado desde https://huggingface.co/settings/tokens.
* `--help`: Muestra este mensaje y sale.

Ejemplos $ hf buckets info user/my-bucket $ hf buckets info hf://buckets/user/my-bucket

Más información Utilice `hf <command> --help` para obtener más información sobre un comando. Lea la documentación en https://huggingface.co/docs/huggingface_hub/en/guides/cli

### `hf buckets list`

Listar cubos o archivos en un cubo. [alias: ls]

Cuando se llama sin argumentos o con un espacio de nombres, lista los cubos. Cuando se llama con un ID de cubo (namespace/bucket_name), lista los archivos del cubo.

**Uso**:

```console
$ hf buckets list [OPTIONS] [ARGUMENT]
```

**Argumentos**:

* `[ARGUMENT]`: Namespace (usuario u organización) para listar cubos, o ID del cubo (namespace/bucket_name(/prefix) o hf://buckets/...) para listar archivos.

**Opciones**:

* `-h, --human-readable`: Muestra los tamaños en un formato legible para humanos.
* `--tree`: Lista los archivos en formato de árbol (solo para listar archivos).
* `-R, --recursive`: Lista los archivos de forma recursiva (solo para listar archivos).
* `--search TEXT`: Consulta de búsqueda.
* `--token TEXT`: un User Access Token generado desde https://huggingface.co/settings/tokens.
* `--help`: Muestra este mensaje y sale.

Ejemplos $ 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

Más información Utilice `hf <command> --help` para obtener más información sobre un comando. Lea la documentación en https://huggingface.co/docs/huggingface_hub/en/guides/cli

### `hf buckets move`

Move renombrar un bucket a un nuevo nombre o espacio de nombres.

**Uso**:

```console
$ hf buckets move [OPTIONS] FROM_ID TO_ID
```

**Argumentos**:

* `FROM_ID`: ID del bucket de origen: namespace/bucket_name o hf://buckets/namespace/bucket_name  [obligatorio]
* `TO_ID`: ID del cubo de destino: namespace/bucket_name o hf://buckets/namespace/bucket_name  [obligatorio]

**Opciones**:

* `--token TEXT`: un User Access Token generado desde https://huggingface.co/settings/tokens.
* `--help`: Muestra este mensaje y sale.

Ejemplos $ 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

Más información Utilice `hf <command> --help` para obtener más información sobre un comando. Lea la documentación en https://huggingface.co/docs/huggingface_hub/en/guides/cli

### `hf buckets remove`

Eliminar archivos de un bucket. [alias: rm]

Para eliminar un bucket completo, use `hf buckets delete` en su lugar.

**Uso**:

```console
$ hf buckets remove [OPTIONS] ARGUMENT
```

**Argumentos**:

* `ARGUMENT`: Ruta del bucket: namespace/bucket_name/path o hf://buckets/namespace/bucket_name/path. Con --recursive, namespace/bucket_name también se acepta para apuntar a todos los archivos.  [obligatorio]

**Opciones**:

* `-R, --recursive`: Elimina archivos de forma recursiva bajo el prefijo indicado.
* `-y, --yes`: Omite la solicitud de confirmación.
* `--dry-run`: Previsualiza lo que se eliminaría sin borrar nada realmente.
* `--include TEXT`: Incluye solo los archivos que coincidan con el patrón (se pueden especificar varios). Requiere --recursive.
* `--exclude TEXT`: Excluye archivos que coincidan con el patrón (se puede especificar varios). Requiere --recursive.
* `--token TEXT`: un User Access Token generado desde https://huggingface.co/settings/tokens.
* `--help`: Muestra este mensaje y sale.

Ejemplos $ 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

Más información Utilice `hf <command> --help` para obtener más información sobre un comando. Lea la documentación en https://huggingface.co/docs/huggingface_hub/en/guides/cli

### `hf buckets settings`

Actualizar la configuración del bucket (visibilidad).

**Uso**:

```console
$ hf buckets settings [OPTIONS] BUCKET_ID
```

**Argumentos**:

* `BUCKET_ID`: ID del bucket: namespace/bucket_name o hf://buckets/namespace/bucket_name  [obligatorio]

**Opciones**:

* `--private`: Hace que el bucket sea privado.
* `--public`: Hace que el bucket sea público.
* `--token TEXT`: un User Access Token generado desde https://huggingface.co/settings/tokens.
* `--help`: Muestra este mensaje y sale.

Ejemplos $ hf buckets settings user/my-bucket --private $ hf buckets settings user/my-bucket --public $ hf buckets settings hf://buckets/user/my-bucket --private

Más información Utilice `hf <command> --help` para obtener más información sobre un comando. Lea la documentación en https://huggingface.co/docs/huggingface_hub/en/guides/cli

### `hf buckets sync`

Sincronizar archivos entre un directorio local y un bucket.

**Uso**:

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

**Argumentos**:

* `[SOURCE]`: Ruta de origen: directorio local o hf://buckets/namespace/bucket_name(/prefix)
* `[DEST]`: Ruta de destino: directorio local o hf://buckets/namespace/bucket_name(/prefix)

**Opciones**:

* `--delete / --no-delete`: Elimina los archivos de destino que no están presentes en el origen. [predeterminado: no-delete]
* `--ignore-times`: Omitir archivos solo en función del tamaño, ignorando las fechas de modificación.
* `--ignore-sizes`: Omitir archivos solo en función de las horas de modificación, ignorando los tamaños.
* `--plan TEXT`: Guarda el plan de sincronización en un archivo JSONL para su revisión en lugar de ejecutarlo.
* `--apply TEXT`: Aplica un archivo de plan guardado previamente.
* `--dry-run`: Imprime el plan de sincronización en stdout como JSONL sin ejecutarlo.
* `--include TEXT`: Incluye archivos que coincidan con el patrón (se pueden especificar varios).
* `--exclude TEXT`: Excluye archivos que coincidan con el patrón (se puede especificar varios).
* `--filter-from TEXT`: Lee los patrones de inclusión/exclusión desde un archivo.
* `--existing`: Omitir la creación de nuevos archivos en el receptor (solo actualizar archivos existentes).
* `--ignore-existing`: Omitir la actualización de archivos que ya existen en el receptor (solo crear archivos nuevos).
* `-v, --verbose`: Muestra registros detallados con razonamiento.
* `--token TEXT`: un User Access Token generado desde https://huggingface.co/settings/tokens.
* `--help`: Muestra este mensaje y sale.

Ejemplos $ 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 .

Más información Utilice `hf <command> --help` para obtener más información sobre un comando. Lea la documentación en https://huggingface.co/docs/huggingface_hub/en/guides/cli

## `hf cache`

Gestionar el directorio de caché local.

**Uso**:

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

**Opciones**:

* `--help`: Muestra este mensaje y sale.

**Comandos**:

* `list`: Lista los repositorios o revisiones en caché. [alias: ls]
* `prune`: Elimina las revisiones desconectadas y las descargas incompletas de la caché.
* `rm`: Elimina repositorios, revisiones o archivos en caché.
* `verify`: Verifica las sumas de verificación de una única revisión de un repositorio desde la caché o un directorio local.

### `hf cache list`

Listar repositorios o revisiones en caché. [alias: ls]

**Uso**:

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

**Opciones**:

* `--cache-dir TEXT`: Directorio de caché para escanear (por defecto, la caché de Hugging Face).
* `--revisions / --no-revisions`: Incluye revisiones en la salida en lugar de repositorios agregados. [predeterminado: no-revisions]
* `-f, --filter TEXT`: Filtra entradas (p. ej., 'size>1GB', 'type=model', 'accessed>7d'). Se puede usar varias veces.
* `--sort [accessed|accessed:asc|accessed:desc|modified|modified:asc|modified:desc|name|name:asc|name:desc|size|size:asc|size:desc]`: Ordena las entradas por clave. Claves admitidas: 'accessed', 'modified', 'name', 'size'. Añade ':asc' o ':desc' para establecer el orden de forma explícita (p. ej., 'modified:asc'). Valores predeterminados: 'accessed', 'modified' y 'size' usan 'desc' (los más recientes/grandes primero); 'name' usa 'asc' (alfabético).
* `--limit INTEGER`: Limita el número de resultados devueltos. Devuelve solo las N primeras entradas después de ordenar.
* `--show-warnings / --no-show-warnings`: Muestra advertencias sobre inconsistencias en la caché. [predeterminado: no-show-warnings]
* `--help`: Muestra este mensaje y sale.

Ejemplos $ hf cache ls $ hf cache ls --revisions $ hf cache ls --filter "size>1GB" --limit 20 $ hf cache ls --format json

Más información Utilice `hf <command> --help` para obtener más información sobre un comando. Lea la documentación en https://huggingface.co/docs/huggingface_hub/en/guides/cli

### `hf cache prune`

Elimina las revisiones desconectadas y las descargas incompletas de la caché.

**Uso**:

```console
$ hf cache prune [OPTIONS]
```

**Opciones**:

* `--cache-dir TEXT`: Directorio de caché para escanear (por defecto, la caché de Hugging Face).
* `-y, --yes`: Omite la solicitud de confirmación.
* `--dry-run / --no-dry-run`: Vista previa de las eliminaciones sin borrar nada. [predeterminado: no-dry-run]
* `--help`: Muestra este mensaje y sale.

Ejemplos $ hf cache prune $ hf cache prune --dry-run

Más información Utilice `hf <command> --help` para obtener más información sobre un comando. Lea la documentación en https://huggingface.co/docs/huggingface_hub/en/guides/cli

### `hf cache rm`

Eliminar repositorios, revisiones o archivos en caché.

**Uso**:

```console
$ hf cache rm [OPTIONS] TARGETS...
```

**Argumentos**:

* `TARGETS...`: uno o más IDs de repositorio (p. ej. model/bert-base-uncased), URIs hf:// (repositorio o archivo) o hashes de revisión a eliminar. [obligatorio]

**Opciones**:

* `--cache-dir TEXT`: Directorio de caché para escanear (por defecto, la caché de Hugging Face).
* `-y, --yes`: Omite la solicitud de confirmación.
* `--dry-run / --no-dry-run`: Vista previa de las eliminaciones sin borrar nada. [predeterminado: no-dry-run]
* `--help`: Muestra este mensaje y sale.

Ejemplos $ 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

Más información Utilice `hf <command> --help` para obtener más información sobre un comando. Lea la documentación en https://huggingface.co/docs/huggingface_hub/en/guides/cli

### `hf cache verify`

Verifique las sumas de verificación para una sola revisión de un repositorio desde la caché o un directorio local.

Ejemplos:
  - Verificar la revisión principal en la caché: `hf cache verify gpt2`
  - Verificar una revisión específica: `hf cache verify gpt2 --revision refs/pr/1`
  - Verificar el conjunto de datos: `hf cache verify karpathy/fineweb-edu-100b-shuffle --repo-type dataset`
  - Verificar el directorio local: `hf cache verify deepseek-ai/DeepSeek-OCR --local-dir /path/to/repo`

**Uso**:

```console
$ hf cache verify [OPTIONS] REPO_ID
```

**Argumentos**:

* `REPO_ID`: El ID del repositorio (p. ej. `username/repo-name` o `spaces/username/repo-name`). [obligatorio]

**Opciones**:

* `--type, --repo-type [model|dataset|space|kernel]`: El tipo de repositorio (model, dataset, space o kernel). [predeterminado: model]
* `--revision TEXT`: id de la revisión de Git, que puede ser un nombre de rama, una etiqueta o un hash de commit.
* `--cache-dir TEXT`: Directorio de caché que se usará al verificar archivos desde la caché (por defecto, la caché de Hugging Face).
* `--local-dir TEXT`: Si se establece, verifica los archivos bajo este directorio en lugar de la caché.
* `--fail-on-missing-files`: Falla si algunos archivos existen en el remoto pero faltan localmente.
* `--fail-on-extra-files`: Falla si algunos archivos existen localmente pero no están presentes en la revisión remota.
* `--token TEXT`: un User Access Token generado desde https://huggingface.co/settings/tokens.
* `--help`: Muestra este mensaje y sale.

Ejemplos $ hf cache verify gpt2 $ hf cache verify gpt2 --revision refs/pr/1 $ hf cache verify my-dataset --repo-type dataset

Más información Utilice `hf <command> --help` para obtener más información sobre un comando. Lea la documentación en https://huggingface.co/docs/huggingface_hub/en/guides/cli

## `hf collections`

Interactúa con las colecciones en el Hub.

**Uso**:

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

**Opciones**:

* `--help`: Muestra este mensaje y sale.

**Comandos**:

* `add-item`: Agrega un elemento a una colección.
* `create`: Crea una nueva colección en el Hub.
* `delete`: Elimina una colección del Hub.
* `delete-item`: Elimina un elemento de una colección.
* `info`: Obtiene información sobre una colección en el Hub.
* `list`: Lista las colecciones en el Hub. [alias: ls]
* `update`: Actualiza los metadatos de una colección en el Hub.
* `update-item`: Actualiza un elemento en una colección.

### `hf collections add-item`

Añade un elemento a una colección.

**Uso**:

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

**Argumentos**:

* `COLLECTION_SLUG`: El slug de la colección (p. ej., 'username/collection-slug'). [obligatorio]
* `ITEM_ID`: El ID del elemento a añadir (repo_id para repositorios, ID del paper para papers). [obligatorio]
* `ITEM_TYPE:{model|dataset|space|paper|collection|bucket}`: El tipo de elemento (model, dataset, space, paper, collection o bucket). [obligatorio]

**Opciones**:

* `--note TEXT`: Una nota para adjuntar al elemento (máx. 500 caracteres).
* `--exists-ok / --no-exists-ok`: No genera un error si el elemento ya está en la colección. [predeterminado: no-exists-ok]
* `--token TEXT`: un User Access Token generado desde https://huggingface.co/settings/tokens.
* `--help`: Muestra este mensaje y sale.

Ejemplos $ 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

Más información Utilice `hf <command> --help` para obtener más información sobre un comando. Lea la documentación en https://huggingface.co/docs/huggingface_hub/en/guides/cli

### `hf collections create`

Crea una nueva colección en el Hub.

**Uso**:

```console
$ hf collections create [OPTIONS] TITLE
```

**Argumentos**:

* `TITLE`: El título de la colección.  [obligatorio]

**Opciones**:

* `--namespace TEXT`: El espacio de nombres (nombre de usuario u organización). Por defecto, es el usuario autenticado.
* `--description TEXT`: Una descripción para la colección (máx. 150 caracteres).
* `--private / --no-private`: Crea una colección privada. [predeterminado: no-private]
* `--exists-ok / --no-exists-ok`: No genera un error si la colección ya existe. [predeterminado: no-exists-ok]
* `--token TEXT`: un User Access Token generado desde https://huggingface.co/settings/tokens.
* `--help`: Muestra este mensaje y sale.

Ejemplos $ 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

Más información Utilice `hf <command> --help` para obtener más información sobre un comando. Lea la documentación en https://huggingface.co/docs/huggingface_hub/en/guides/cli

### `hf collections delete`

Eliminar una colección del Hub.

**Uso**:

```console
$ hf collections delete [OPTIONS] COLLECTION_SLUG
```

**Argumentos**:

* `COLLECTION_SLUG`: El slug de la colección (p. ej., 'username/collection-slug'). [obligatorio]

**Opciones**:

* `--missing-ok / --no-missing-ok`: No genera un error si la colección no existe. [predeterminado: no-missing-ok]
* `--token TEXT`: un User Access Token generado desde https://huggingface.co/settings/tokens.
* `--help`: Muestra este mensaje y sale.

Ejemplos $ hf collections delete username/my-collection $ hf collections delete username/my-collection --missing-ok

Más información Utilice `hf <command> --help` para obtener más información sobre un comando. Lea la documentación en https://huggingface.co/docs/huggingface_hub/en/guides/cli

### `hf collections delete-item`

Eliminar un elemento de una colección.

**Uso**:

```console
$ hf collections delete-item [OPTIONS] COLLECTION_SLUG ITEM_OBJECT_ID
```

**Argumentos**:

* `COLLECTION_SLUG`: El slug de la colección (p. ej., 'username/collection-slug'). [obligatorio]
* `ITEM_OBJECT_ID`: El ID del elemento en la colección (obtenido del campo `item_object_id` devuelto por 'hf collections info'. [obligatorio])

**Opciones**:

* `--missing-ok / --no-missing-ok`: No genera un error si el elemento no existe. [predeterminado: no-missing-ok]
* `--token TEXT`: un User Access Token generado desde https://huggingface.co/settings/tokens.
* `--help`: Muestra este mensaje y sale.

### `hf collections info`

Obtén información sobre una colección en el Hub.

**Uso**:

```console
$ hf collections info [OPTIONS] COLLECTION_SLUG
```

**Argumentos**:

* `COLLECTION_SLUG`: El slug de la colección (p. ej., 'username/collection-slug'). [obligatorio]

**Opciones**:

* `--token TEXT`: un User Access Token generado desde https://huggingface.co/settings/tokens.
* `--help`: Muestra este mensaje y sale.

Ejemplos $ hf collections info username/my-collection-slug

Más información Utilice `hf <command> --help` para obtener más información sobre un comando. Lea la documentación en https://huggingface.co/docs/huggingface_hub/en/guides/cli

### `hf collections list`

Listar colecciones en el Hub. [alias: ls]

**Uso**:

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

**Opciones**:

* `--owner TEXT`: Filtrar por nombre de usuario o organización del propietario.
* `--item TEXT`: Filtra colecciones que contienen un elemento específico (p. ej., "models/gpt2", "datasets/squad", "papers/2311.12983").
* `--sort [lastModified|trending|upvotes]`: Ordena los resultados por fecha de última modificación, tendencia o votos a favor.
* `--limit INTEGER`: Limita el número de resultados. [predeterminado: 10]
* `--token TEXT`: un User Access Token generado desde https://huggingface.co/settings/tokens.
* `--help`: Muestra este mensaje y sale.

Ejemplos $ hf collections ls $ hf collections ls --owner nvidia $ hf collections ls --item models/teknium/OpenHermes-2.5-Mistral-7B --limit 10

Más información Utilice `hf <command> --help` para obtener más información sobre un comando. Lea la documentación en https://huggingface.co/docs/huggingface_hub/en/guides/cli

### `hf collections update`

Actualice los metadatos de una colección en el Hub.

**Uso**:

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

**Argumentos**:

* `COLLECTION_SLUG`: El slug de la colección (p. ej., 'username/collection-slug'). [obligatorio]

**Opciones**:

* `--title TEXT`: El nuevo título para la colección.
* `--description TEXT`: La nueva descripción para la colección (máx. 150 caracteres).
* `--position INTEGER`: La nueva posición de la colección en la lista del propietario.
* `--private / --no-private`: Si la colección debe ser privada.
* `--theme TEXT`: El color del tema para la colección (p. ej., 'green', 'blue').
* `--token TEXT`: un User Access Token generado desde https://huggingface.co/settings/tokens.
* `--help`: Muestra este mensaje y sale.

Ejemplos $ 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

Más información Utilice `hf <command> --help` para obtener más información sobre un comando. Lea la documentación en https://huggingface.co/docs/huggingface_hub/en/guides/cli

### `hf collections update-item`

Actualizar un elemento en una colección.

**Uso**:

```console
$ hf collections update-item [OPTIONS] COLLECTION_SLUG ITEM_OBJECT_ID
```

**Argumentos**:

* `COLLECTION_SLUG`: El slug de la colección (p. ej., 'username/collection-slug'). [obligatorio]
* `ITEM_OBJECT_ID`: El ID del elemento en la colección (del campo 'item_object_id', no del repo_id). [obligatorio]

**Opciones**:

* `--note TEXT`: Una nueva nota para el elemento (máx. 500 caracteres).
* `--position INTEGER`: La nueva posición del elemento en la colección.
* `--token TEXT`: un User Access Token generado desde https://huggingface.co/settings/tokens.
* `--help`: Muestra este mensaje y sale.

Ejemplos $ 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

Más información Utilice `hf <command> --help` para obtener más información sobre un comando. Lea la documentación en https://huggingface.co/docs/huggingface_hub/en/guides/cli

## `hf cp`

Copiar archivos entre rutas locales, repositorios y cubos.

Gestiona las cargas (local/stdin -> repo/bucket), las descargas (repo/bucket -> local/stdout) y las copias remotas (repo/bucket -> repo/bucket). No se admiten las copias de bucket a repo ni las copias locales. Para directorios, use `hf upload`/`hf download` (repos) o `hf buckets sync` (buckets). Las copias remotas solo funcionan dentro de la misma región de almacenamiento (https://huggingface.co/docs/hub/storage-regions).

**Uso**:

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

**Argumentos**:

* `SRC`: Origen: archivo local, URI hf:// (repositorio o bucket) o - para stdin. [obligatorio]
* `[DST]`: Destino: ruta local, URI hf:// (repositorio o bucket) o - para stdout.

**Opciones**:

* `--token TEXT`: un User Access Token generado desde https://huggingface.co/settings/tokens.
* `--help`: Muestra este mensaje y sale.

Ejemplos $ 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/ # solo copia el contenido

Más información Utilice `hf <command> --help` para obtener más información sobre un comando. Lea la documentación en https://huggingface.co/docs/huggingface_hub/en/guides/cli

## `hf datasets`

Interactúa con los conjuntos de datos en el Hub.

**Uso**:

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

**Opciones**:

* `--help`: Muestra este mensaje y sale.

**Comandos**:

* `card`: Obtiene la tarjeta del conjunto de datos (README) de un conjunto de datos en el Hub.
* `info`: Obtiene información sobre un conjunto de datos en el Hub.
* `leaderboard`: Lista las puntuaciones de los modelos de un tablero de clasificación de un conjunto de datos.
* `list`: Lista los conjuntos de datos en el Hub o los archivos en un repositorio de conjuntos de datos. [alias: ls]
* `parquet`: Lista las URLs de los archivos parquet disponibles para un conjunto de datos.
* `sql`: Ejecuta una consulta SQL cruda con DuckDB contra las URLs de parquet del conjunto de datos.

### `hf datasets card`

Obtén la tarjeta del conjunto de datos (README) de un conjunto de datos en el Hub.

**Uso**:

```console
$ hf datasets card [OPTIONS] DATASET_ID
```

**Argumentos**:

* `DATASET_ID`: El ID del conjunto de datos (p. ej. `username/repo-name`). [obligatorio]

**Opciones**:

* `--metadata`: Solo muestra los metadatos de la tarjeta.
* `--text`: Solo muestra el cuerpo del texto (sin metadatos).
* `--token TEXT`: un User Access Token generado desde https://huggingface.co/settings/tokens.
* `--help`: Muestra este mensaje y sale.

Ejemplos $ 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

Más información Utilice `hf <command> --help` para obtener más información sobre un comando. Lea la documentación en https://huggingface.co/docs/huggingface_hub/en/guides/cli

### `hf datasets info`

Obtén información sobre un conjunto de datos en el Hub.

**Uso**:

```console
$ hf datasets info [OPTIONS] DATASET_ID
```

**Argumentos**:

* `DATASET_ID`: El ID del conjunto de datos (p. ej. `username/repo-name`). [obligatorio]

**Opciones**:

* `--revision TEXT`: id de la revisión de Git, que puede ser un nombre de rama, una etiqueta o un hash de commit.
* `--expand TEXT`: Propiedades separadas por comas que se devolverán. Cuando se usa, solo se devuelven las propiedades enumeradas (y id). Ejemplo: '--expand=downloads,likes,tags'. Válido: author, cardData, citation, createdAt, description, disabled, downloads, downloadsAllTime, gated, lastModified, likes, mainSize, paperswithcode_id, private, resourceGroup, sha, siblings, tags, trendingScore, usedStorage.
* `--token TEXT`: un User Access Token generado desde https://huggingface.co/settings/tokens.
* `--help`: Muestra este mensaje y sale.

Ejemplos $ hf datasets info HuggingFaceFW/fineweb $ hf datasets info my-dataset --expand downloads,likes,tags

Más información Utilice `hf <command> --help` para obtener más información sobre un comando. Lea la documentación en https://huggingface.co/docs/huggingface_hub/en/guides/cli

### `hf datasets leaderboard`

Obtén la lista de puntuaciones de los modelos de un tablero de clasificación de conjuntos de datos. Este comando ayuda a encontrar los mejores modelos para una tarea o a comparar modelos según sus puntuaciones en las pruebas de referencia. Usa hf datasets ls --filter benchmark:official para listar los tableros de clasificación disponibles.

**Uso**:

```console
$ hf datasets leaderboard [OPTIONS] DATASET_ID
```

**Argumentos**:

* `DATASET_ID`: El ID del conjunto de datos de referencia (p. ej., `SWE-bench/SWE-bench_Verified`). [obligatorio]

**Opciones**:

* `--limit INTEGER`: Limita el número de resultados. [predeterminado: 20]
* `--token TEXT`: un User Access Token generado desde https://huggingface.co/settings/tokens.
* `--help`: Muestra este mensaje y sale.

Ejemplos $ 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  # lista los tableros de clasificación disponibles

Más información Utilice `hf <command> --help` para obtener más información sobre un comando. Lea la documentación en https://huggingface.co/docs/huggingface_hub/en/guides/cli

### `hf datasets list`

Listar conjuntos de datos en el Hub, o archivos en un repositorio de conjuntos de datos. [alias: ls]

Cuando se llama sin argumentos, lista los conjuntos de datos en el Hub. Cuando se llama con un ID de conjunto de datos, lista los archivos en ese repositorio de conjuntos de datos.

**Uso**:

```console
$ hf datasets list [OPTIONS] [REPO_ID]
```

**Argumentos**:

* `[REPO_ID]`: ID del dataset (p. ej. `username/repo-name`) del que se listarán los archivos. Si se omite, lista los datasets.

**Opciones**:

* `--search TEXT`: Consulta de búsqueda.
* `--author TEXT`: Filtrar por autor u organización.
* `--filter TEXT`: Filtrar por etiquetas (p. ej., 'text-classification'). Se puede usar varias veces.
* `--sort [created_at|downloads|last_modified|likes|trending_score]`: Ordena los resultados.
* `--limit INTEGER`: Limita el número de resultados. [predeterminado: 30]
* `--expand TEXT`: Propiedades separadas por comas que se devolverán. Cuando se usa, solo se devuelven las propiedades enumeradas (y id). Ejemplo: '--expand=downloads,likes,tags'. Válido: author, cardData, citation, createdAt, description, disabled, downloads, downloadsAllTime, gated, lastModified, likes, mainSize, paperswithcode_id, private, resourceGroup, sha, siblings, tags, trendingScore, usedStorage.
* `-h, --human-readable`: Muestra los tamaños en un formato legible por humanos (solo para listar archivos).
* `--tree`: Lista los archivos en formato de árbol (solo para listar archivos).
* `-R, --recursive`: Lista los archivos de forma recursiva (solo para listar archivos).
* `--revision TEXT`: id de la revisión de Git, que puede ser un nombre de rama, una etiqueta o un hash de commit.
* `--token TEXT`: un User Access Token generado desde https://huggingface.co/settings/tokens.
* `--help`: Muestra este mensaje y sale.

Ejemplos $ 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

Más información Utilice `hf <command> --help` para obtener más información sobre un comando. Lea la documentación en https://huggingface.co/docs/huggingface_hub/en/guides/cli

### `hf datasets parquet`

Muestra las URLs de los archivos parquet disponibles para un conjunto de datos.

**Uso**:

```console
$ hf datasets parquet [OPTIONS] DATASET_ID
```

**Argumentos**:

* `DATASET_ID`: El ID del conjunto de datos (p. ej. `username/repo-name`). [obligatorio]

**Opciones**:

* `--subset TEXT`: Filtra las entradas de parquet por subconjunto/configuración.
* `--split TEXT`: Filtra las entradas de parquet por split.
* `--token TEXT`: un User Access Token generado desde https://huggingface.co/settings/tokens.
* `--help`: Muestra este mensaje y sale.

Ejemplos $ 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

Más información Utilice `hf <command> --help` para obtener más información sobre un comando. Lea la documentación en https://huggingface.co/docs/huggingface_hub/en/guides/cli

### `hf datasets sql`

Ejecuta una consulta SQL sin procesar con DuckDB contra las URL de parquet del conjunto de datos.

**Uso**:

```console
$ hf datasets sql [OPTIONS] SQL
```

**Argumentos**:

* `SQL`: Consulta SQL cruda para ejecutar. [obligatorio]

**Opciones**:

* `--token TEXT`: un User Access Token generado desde https://huggingface.co/settings/tokens.
* `--help`: Muestra este mensaje y sale.

Ejemplos $ 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

Más información Utilice `hf <command> --help` para obtener más información sobre un comando. Lea la documentación en https://huggingface.co/docs/huggingface_hub/en/guides/cli

## `hf discussions`

Gestiona las discusiones y las solicitudes de extracción (pull requests) en el Hub.

**Uso**:

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

**Opciones**:

* `--help`: Muestra este mensaje y sale.

**Comandos**:

* `close`: Cierra una discusión o una solicitud de extracción (pull request).
* `comment`: Comentar en una discusión o solicitud de extracción.
* `create`: Crea una nueva discusión o solicitud de extracción (pull request) en un repositorio.
* `diff`: Muestra el diff de una pull request.
* `edit`: Editar un comentario existente en una discusión o solicitud de extracción.
* `info`: Obtiene información sobre una discusión o una solicitud de extracción.
* `list`: Lista las discusiones y las solicitudes de extracción (pull requests) en un repositorio. [alias: ls]
* `merge`: Fusiona una solicitud de extracción.
* `rename`: Cambia el nombre de una discusión o solicitud de extracción.
* `reopen`: Reabrir una discusión o solicitud de extracción cerrada.

### `hf discussions close`

Cerrar una discusión o una solicitud de extracción (pull request).

**Uso**:

```console
$ hf discussions close [OPTIONS] REPO_ID NUM
```

**Argumentos**:

* `REPO_ID`: El ID del repositorio (p. ej. `username/repo-name` o `spaces/username/repo-name`). [obligatorio]
* `NUM`: El número de la discusión o la solicitud de extracción. [obligatorio]

**Opciones**:

* `--comment TEXT`: Un comentario opcional para publicar al cerrar.
* `-y, --yes`: Omite la solicitud de confirmación.
* `--type, --repo-type [model|dataset|space|kernel]`: El tipo de repositorio (model, dataset, space o kernel). [predeterminado: model]
* `--token TEXT`: un User Access Token generado desde https://huggingface.co/settings/tokens.
* `--help`: Muestra este mensaje y sale.

Ejemplos $ hf discussions close username/my-model 5 $ hf discussions close username/my-model 5 --comment "Closing as resolved."

Más información Utilice `hf <command> --help` para obtener más información sobre un comando. Lea la documentación en https://huggingface.co/docs/huggingface_hub/en/guides/cli

### `hf discussions comment`

Comenta en una discusión o solicitud de extracción.

**Uso**:

```console
$ hf discussions comment [OPTIONS] REPO_ID NUM
```

**Argumentos**:

* `REPO_ID`: El ID del repositorio (p. ej. `username/repo-name` o `spaces/username/repo-name`). [obligatorio]
* `NUM`: El número de la discusión o la solicitud de extracción. [obligatorio]

**Opciones**:

* `--body TEXT`: El texto del comentario (admite Markdown).
* `--body-file PATH`: Lee el comentario desde un archivo. Usa '-' para stdin.
* `--attach TEXT`: Adjunta un archivo de imagen, video o audio, como 'FILE' o 'FILE#texto alternativo'. Una referencia '![alt](FILE)' en el cuerpo se reemplaza por el archivo subido; los demás archivos se agregan al final. Se puede usar varias veces.
* `--type, --repo-type [model|dataset|space|kernel]`: El tipo de repositorio (model, dataset, space o kernel). [predeterminado: model]
* `--token TEXT`: un User Access Token generado desde https://huggingface.co/settings/tokens.
* `--help`: Muestra este mensaje y sale.

Ejemplos $ 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

Más información Utilice `hf <command> --help` para obtener más información sobre un comando. Lea la documentación en https://huggingface.co/docs/huggingface_hub/en/guides/cli

### `hf discussions create`

Crea una nueva discusión o solicitud de extracción (pull request) en un repositorio.

**Uso**:

```console
$ hf discussions create [OPTIONS] REPO_ID
```

**Argumentos**:

* `REPO_ID`: El ID del repositorio (p. ej. `username/repo-name` o `spaces/username/repo-name`). [obligatorio]

**Opciones**:

* `--title TEXT`: El título de la discusión o la solicitud de extracción. [obligatorio]
* `--body TEXT`: La descripción (admite Markdown).
* `--body-file PATH`: Lee la descripción desde un archivo. Usa '-' para stdin.
* `--pull-request, --pr`: Crea una pull request en lugar de una discusión.
* `--attach TEXT`: Adjunta un archivo de imagen, video o audio, como 'FILE' o 'FILE#texto alternativo'. Una referencia '![alt](FILE)' en el cuerpo se reemplaza por el archivo subido; los demás archivos se agregan al final. Se puede usar varias veces.
* `--type, --repo-type [model|dataset|space|kernel]`: El tipo de repositorio (model, dataset, space o kernel). [predeterminado: model]
* `--token TEXT`: un User Access Token generado desde https://huggingface.co/settings/tokens.
* `--help`: Muestra este mensaje y sale.

Ejemplos $ 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

Más información Utilice `hf <command> --help` para obtener más información sobre un comando. Lea la documentación en https://huggingface.co/docs/huggingface_hub/en/guides/cli

### `hf discussions diff`

Mostrar la diferencia de una solicitud de extracción (pull request).

**Uso**:

```console
$ hf discussions diff [OPTIONS] REPO_ID NUM
```

**Argumentos**:

* `REPO_ID`: El ID del repositorio (p. ej. `username/repo-name` o `spaces/username/repo-name`). [obligatorio]
* `NUM`: El número de la discusión o la solicitud de extracción. [obligatorio]

**Opciones**:

* `--type, --repo-type [model|dataset|space|kernel]`: El tipo de repositorio (model, dataset, space o kernel). [predeterminado: model]
* `--token TEXT`: un User Access Token generado desde https://huggingface.co/settings/tokens.
* `--help`: Muestra este mensaje y sale.

Ejemplos $ hf discussions diff username/my-model 5

Más información Utilice `hf <command> --help` para obtener más información sobre un comando. Lea la documentación en https://huggingface.co/docs/huggingface_hub/en/guides/cli

### `hf discussions edit`

Edit a comment existing in a discussion or pull request.

**Uso**:

```console
$ hf discussions edit [OPTIONS] REPO_ID NUM COMMENT_ID
```

**Argumentos**:

* `REPO_ID`: El ID del repositorio (p. ej. `username/repo-name` o `spaces/username/repo-name`). [obligatorio]
* `NUM`: El número de la discusión o la solicitud de extracción. [obligatorio]
* `COMMENT_ID`: El ID del comentario que se va a editar (consulte 'hf discussions info ... --format json'). [obligatorio]

**Opciones**:

* `--body TEXT`: El texto del nuevo comentario (admite Markdown).
* `--body-file PATH`: Lee el nuevo comentario desde un archivo. Usa '-' para stdin.
* `--attach TEXT`: Adjunta un archivo de imagen, video o audio, como 'FILE' o 'FILE#texto alternativo'. Una referencia '![alt](FILE)' en el cuerpo se reemplaza por el archivo subido; los demás archivos se agregan al final. Se puede usar varias veces.
* `--type, --repo-type [model|dataset|space|kernel]`: El tipo de repositorio (model, dataset, space o kernel). [predeterminado: model]
* `--token TEXT`: un User Access Token generado desde https://huggingface.co/settings/tokens.
* `--help`: Muestra este mensaje y sale.

Ejemplos $ 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

Más información Utilice `hf <command> --help` para obtener más información sobre un comando. Lea la documentación en https://huggingface.co/docs/huggingface_hub/en/guides/cli

### `hf discussions info`

Obtén información sobre una discusión o una solicitud de extracción (pull request).

**Uso**:

```console
$ hf discussions info [OPTIONS] REPO_ID NUM
```

**Argumentos**:

* `REPO_ID`: El ID del repositorio (p. ej. `username/repo-name` o `spaces/username/repo-name`). [obligatorio]
* `NUM`: El número de la discusión o la solicitud de extracción. [obligatorio]

**Opciones**:

* `--type, --repo-type [model|dataset|space|kernel]`: El tipo de repositorio (model, dataset, space o kernel). [predeterminado: model]
* `--token TEXT`: un User Access Token generado desde https://huggingface.co/settings/tokens.
* `--help`: Muestra este mensaje y sale.

Ejemplos $ hf discussions info username/my-model 5 $ hf discussions info username/my-model 5 --format json

Más información Utilice `hf <command> --help` para obtener más información sobre un comando. Lea la documentación en https://huggingface.co/docs/huggingface_hub/en/guides/cli

### `hf discussions list`

Listar discusiones y solicitudes de extracción en un repositorio. [alias: ls]

**Uso**:

```console
$ hf discussions list [OPTIONS] REPO_ID
```

**Argumentos**:

* `REPO_ID`: El ID del repositorio (p. ej. `username/repo-name` o `spaces/username/repo-name`). [obligatorio]

**Opciones**:

* `-s, --status [open|closed|merged|draft|all]`: Filtrar por estado (open, closed, merged, draft, all). [predeterminado: open]
* `-k, --kind [all|discussion|pull_request]`: Filtrar por tipo (discussion, pull_request, all). [predeterminado: all]
* `--author TEXT`: Filtrar por autor u organización.
* `--limit INTEGER`: Limita el número de resultados. [predeterminado: 30]
* `--type, --repo-type [model|dataset|space|kernel]`: El tipo de repositorio (model, dataset, space o kernel). [predeterminado: model]
* `--token TEXT`: un User Access Token generado desde https://huggingface.co/settings/tokens.
* `--help`: Muestra este mensaje y sale.

Ejemplos $ 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

Más información Utilice `hf <command> --help` para obtener más información sobre un comando. Lea la documentación en https://huggingface.co/docs/huggingface_hub/en/guides/cli

### `hf discussions merge`

Fusiona una solicitud de extracción (pull request).

**Uso**:

```console
$ hf discussions merge [OPTIONS] REPO_ID NUM
```

**Argumentos**:

* `REPO_ID`: El ID del repositorio (p. ej. `username/repo-name` o `spaces/username/repo-name`). [obligatorio]
* `NUM`: El número de la discusión o la solicitud de extracción. [obligatorio]

**Opciones**:

* `--comment TEXT`: Un comentario opcional para publicar al fusionar.
* `-y, --yes`: Omite la solicitud de confirmación.
* `--type, --repo-type [model|dataset|space|kernel]`: El tipo de repositorio (model, dataset, space o kernel). [predeterminado: model]
* `--token TEXT`: un User Access Token generado desde https://huggingface.co/settings/tokens.
* `--help`: Muestra este mensaje y sale.

Ejemplos $ hf discussions merge username/my-model 5 $ hf discussions merge username/my-model 5 --comment "Merging, thanks!"

Más información Utilice `hf <command> --help` para obtener más información sobre un comando. Lea la documentación en https://huggingface.co/docs/huggingface_hub/en/guides/cli

### `hf discussions rename`

Cambiar el nombre de una discusión o solicitud de extracción.

**Uso**:

```console
$ hf discussions rename [OPTIONS] REPO_ID NUM NEW_TITLE
```

**Argumentos**:

* `REPO_ID`: El ID del repositorio (p. ej. `username/repo-name` o `spaces/username/repo-name`). [obligatorio]
* `NUM`: El número de la discusión o la solicitud de extracción. [obligatorio]
* `NEW_TITLE`: El nuevo título. [obligatorio]

**Opciones**:

* `--type, --repo-type [model|dataset|space|kernel]`: El tipo de repositorio (model, dataset, space o kernel). [predeterminado: model]
* `--token TEXT`: un User Access Token generado desde https://huggingface.co/settings/tokens.
* `--help`: Muestra este mensaje y sale.

Ejemplos $ hf discussions rename username/my-model 5 "Updated title"

Más información Utilice `hf <command> --help` para obtener más información sobre un comando. Lea la documentación en https://huggingface.co/docs/huggingface_hub/en/guides/cli

### `hf discussions reopen`

Reabrir una discusión o solicitud de extracción cerrada.

**Uso**:

```console
$ hf discussions reopen [OPTIONS] REPO_ID NUM
```

**Argumentos**:

* `REPO_ID`: El ID del repositorio (p. ej. `username/repo-name` o `spaces/username/repo-name`). [obligatorio]
* `NUM`: El número de la discusión o la solicitud de extracción. [obligatorio]

**Opciones**:

* `--comment TEXT`: Un comentario opcional para publicar al reabrir.
* `-y, --yes`: Omite la solicitud de confirmación.
* `--type, --repo-type [model|dataset|space|kernel]`: El tipo de repositorio (model, dataset, space o kernel). [predeterminado: model]
* `--token TEXT`: un User Access Token generado desde https://huggingface.co/settings/tokens.
* `--help`: Muestra este mensaje y sale.

Ejemplos $ hf discussions reopen username/my-model 5 $ hf discussions reopen username/my-model 5 --comment "Reopening for further investigation."

Más información Utilice `hf <command> --help` para obtener más información sobre un comando. Lea la documentación en https://huggingface.co/docs/huggingface_hub/en/guides/cli

## `hf download`

Descarga archivos desde el Hub.

**Uso**:

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

**Argumentos**:

* `REPO_ID`: El ID del repositorio (p. ej. `username/repo-name` o `spaces/username/repo-name`). [obligatorio]
* `[FILENAMES]...`: Archivos para descargar (p. ej. `config.json`, `data/metadata.jsonl`).

**Opciones**:

* `--type, --repo-type [model|dataset|space|kernel]`: El tipo de repositorio (model, dataset, space o kernel). [predeterminado: (model)]
* `--revision TEXT`: id de la revisión de Git, que puede ser un nombre de rama, una etiqueta o un hash de commit.
* `--include TEXT`: Patrones globales para incluir en los archivos a descargar. Ej.: *.json
* `--exclude TEXT`: Patrones globales para excluir de los archivos a descargar.
* `--cache-dir TEXT`: Directorio donde se guardan los archivos.
* `--local-dir TEXT`: Si se establece, el archivo descargado se colocará en este directorio. Consulta https://huggingface.co/docs/huggingface_hub/guides/download#download-files-to-a-local-folder para más detalles.
* `--force-download / --no-force-download`: Si es True, los archivos se descargarán incluso si ya están en la caché. [predeterminado: no-force-download]
* `--dry-run / --no-dry-run`: Si es True, realiza una ejecución de prueba sin descargar realmente el archivo. [predeterminado: no-dry-run]
* `--token TEXT`: un User Access Token generado desde https://huggingface.co/settings/tokens.
* `--max-workers INTEGER`: Número máximo de workers para usar en la descarga de archivos. El valor predeterminado es 8. [predeterminado: 8]
* `--help`: Muestra este mensaje y sale.

Ejemplos $ 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

Más información Utilice `hf <command> --help` para obtener más información sobre un comando. Lea la documentación en https://huggingface.co/docs/huggingface_hub/en/guides/cli

## `hf endpoints`

Gestionar los Hugging Face Inference Endpoints.

**Uso**:

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

**Opciones**:

* `--help`: Muestra este mensaje y sale.

**Comandos**:

* `catalog`: Interactuar con el catálogo de Inference Endpoints.
* `delete`: Elimina un Inference Endpoint de forma permanente.
* `deploy`: Despliega un Inference Endpoint desde un repositorio de Hub.
* `describe`: Obtiene información sobre un punto de acceso existente.
* `hardware`: Lista el hardware disponible para desplegar un Inference Endpoint.
* `list`: Lista todos los Inference Endpoints para el espacio de nombres dado. [alias: ls]
* `list-catalog`: Lista los modelos disponibles en el Catálogo de Modelos.
* `pause`: Pausar un Inference Endpoint.
* `resume`: Reanudar un Inference Endpoint.
* `scale-to-zero`: Escala un Inference Endpoint a cero.
* `update`: Actualiza un punto de acceso existente.

### `hf endpoints catalog`

Interactúe con el catálogo de Inference Endpoints.

**Uso**:

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

**Opciones**:

* `--help`: Muestra este mensaje y sale.

**Comandos**:

* `deploy`: Despliega un Inference Endpoint desde el Model Catalog.
* `list`: Lista los modelos disponibles en el Catálogo de Modelos. [alias: ls]

#### `hf endpoints catalog deploy`

Despliega un punto de inferencia desde el catálogo de modelos.

Los modelos de catálogo se despliegan mediante una receta: una combinación de hardware y motor que ha sido probada para ellos. Pasa --repo para desplegar la receta predeterminada de un modelo, opcionalmente restringida con --accelerator y --gguf-file, o pasa --recipe para desplegar una receta exacta listada por `hf endpoints catalog ls`.

**Uso**:

```console
$ hf endpoints catalog deploy [OPTIONS]
```

**Opciones**:

* `--repo TEXT`: El nombre del repositorio de modelos asociado con el Inference Endpoint (p. ej., 'openai/gpt-oss-120b'). Despliega su receta predeterminada. Es mutuamente excluyente con --recipe.
* `--recipe TEXT`: El id de la receta del catálogo que se va a desplegar, tal como se lista con 'hf endpoints catalog ls'. Es mutuamente excluyente con --repo.
* `--name TEXT`: Nombre del endpoint.
* `--accelerator [cpu|gpu|neuron]`: El acelerador de hardware que se utilizará para la inferencia. Solo con --repo.
* `--gguf-file TEXT`: El archivo GGUF para desplegar, para modelos que tienen una receta por cuantización. Solo con --repo.
* `--namespace TEXT`: El espacio de nombres asociado con el Inference Endpoint. Por defecto, se usa el espacio de nombres del usuario actual.
* `--token TEXT`: un User Access Token generado desde https://huggingface.co/settings/tokens.
* `--help`: Muestra este mensaje y sale.

Ejemplos $ hf endpoints catalog deploy --repo meta-llama/Llama-3.2-1B-Instruct $ hf endpoints catalog deploy --recipe sizzling-biryani-g4xsi1ac

Más información Utilice `hf <command> --help` para obtener más información sobre un comando. Lea la documentación en https://huggingface.co/docs/huggingface_hub/en/guides/cli

#### `hf endpoints catalog list`

Muestra los modelos disponibles en el Catálogo de Modelos. [alias: ls]

Una fila por receta, es decir, por cada forma probada de desplegar un modelo. Despliega una con `hf endpoints catalog deploy --recipe <RECIPE_ID>`.

**Uso**:

```console
$ hf endpoints catalog list [OPTIONS]
```

**Opciones**:

* `--accelerator [cpu|gpu|neuron]`: Muestra solo las recetas que se ejecutan en este acelerador.
* `--engine [llamacpp|sglang|tei|vllm]`: Muestra solo las recetas que ejecutan este motor de inferencia.
* `--license TEXT`: Solo mostrar modelos bajo esta licencia (p. ej. 'Apache 2.0').
* `--task TEXT`: Solo muestra modelos para esta tarea (p. ej., 'text-generation').
* `--search TEXT`: Consulta de búsqueda.
* `--limit INTEGER`: Limita el número de modelos a devolver.
* `--token TEXT`: un User Access Token generado desde https://huggingface.co/settings/tokens.
* `--help`: Muestra este mensaje y sale.

Ejemplos $ hf endpoints catalog ls $ hf endpoints catalog ls --engine vllm

Más información Utilice `hf <command> --help` para obtener más información sobre un comando. Lea la documentación en https://huggingface.co/docs/huggingface_hub/en/guides/cli

### `hf endpoints delete`

Eliminar un punto de inferencia de forma permanente.

**Uso**:

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

**Argumentos**:

* `NAME`: Nombre del punto de conexión. [obligatorio]

**Opciones**:

* `--namespace TEXT`: El espacio de nombres asociado con el Inference Endpoint. Por defecto, se usa el espacio de nombres del usuario actual.
* `--yes`: Omite las confirmaciones.
* `--token TEXT`: un User Access Token generado desde https://huggingface.co/settings/tokens.
* `--help`: Muestra este mensaje y sale.

Ejemplos $ hf endpoints delete my-endpoint

Más información Utilice `hf <command> --help` para obtener más información sobre un comando. Lea la documentación en https://huggingface.co/docs/huggingface_hub/en/guides/cli

### `hf endpoints deploy`

Despliega un punto de inferencia desde un repositorio de Hub.

Ejecute `hf endpoints hardware` para listar las combinaciones válidas de `--vendor`, `--region`, `--accelerator`, `--instance-type` y `--instance-size`.

**Uso**:

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

**Argumentos**:

* `NAME`: Nombre del punto de conexión. [obligatorio]

**Opciones**:

* `--repo TEXT`: El nombre del repositorio de modelos asociado con el Inference Endpoint (p. ej., 'openai/gpt-oss-120b'). [obligatorio]
* `--framework TEXT`: El framework de machine learning utilizado para el modelo (p. ej., 'vllm'). [obligatorio]
* `--accelerator TEXT`: El acelerador de hardware que se utilizará para la inferencia (p. ej., 'cpu'). [obligatorio]
* `--instance-size TEXT`: El tamaño o tipo de la instancia que se usará para alojar el modelo (p. ej., 'x4'). [obligatorio]
* `--instance-type TEXT`: El tipo de instancia en la nube donde se desplegará el Inference Endpoint (p. ej., 'intel-icl'). [obligatorio]
* `--region TEXT`: La región de la nube en la que se creará el Inference Endpoint (p. ej., 'us-east-1'). [obligatorio]
* `--vendor TEXT`: El proveedor de nube o vendor donde se alojará el Inference Endpoint (p. ej., 'aws'). [obligatorio]
* `--namespace TEXT`: El espacio de nombres asociado con el Inference Endpoint. Por defecto, se usa el espacio de nombres del usuario actual.
* `--task TEXT`: La tarea en la que se desplegará el modelo (p. ej., 'text-classification').
* `--token TEXT`: un User Access Token generado desde https://huggingface.co/settings/tokens.
* `--min-replica INTEGER`: El número mínimo de réplicas (instancias) que se deben mantener en ejecución para el Inference Endpoint. [predeterminado: 1]
* `--max-replica INTEGER`: El número máximo de réplicas (instancias) al que escalar el Inference Endpoint. [predeterminado: 1]
* `--scale-to-zero-timeout INTEGER`: La duración en minutos antes de que un punto de acceso inactivo se escale a cero.
* `--scaling-metric [pendingRequests|hardwareUsage]`: La métrica de referencia para el escalado.
* `--scaling-threshold FLOAT`: Umbral de la métrica de escalado utilizado para activar un aumento de escala. Se ignora cuando no se proporciona la métrica de escalado.
* `--revision TEXT`: id de la revisión de Git, que puede ser un nombre de rama, una etiqueta o un hash de commit.
* `--custom-image TEXT`: URL de la imagen de Docker para el contenedor a ejecutar (p. ej., 'nexagi/sglang:v0.5.12'). Requiere '--framework custom'.
* `--engine [custom|hf-serve|llamacpp|sglang|tei|tgi|tgi-neuron|vllm|vllm-neuron]`: Imagen del motor administrado para ejecutar --custom-image (p. ej., 'vllm'). El valor predeterminado es un contenedor arbitrario.
* `--health-route TEXT`: Ruta de comprobación de estado expuesta por el contenedor (p. ej., '/health'). Requiere --custom-image.
* `--port INTEGER`: Puerto en el que escucha el contenedor (p. ej., 30000). Requiere --custom-image.
* `--container-registry-username TEXT`: Nombre de usuario utilizado para autenticarse con el registro que aloja --custom-image.
* `--container-registry-password TEXT`: Contraseña opcional que se utiliza para autenticarse con el registro que aloja --custom-image.
* `--tensor-parallel-size INTEGER`: Número de aceleradores en los que dividir una copia única del modelo (solo motores vLLM y SGLang).
* `--data-parallel-size INTEGER`: Número de copias del modelo que se ejecutarán, una por acelerador (solo motor de vLLM).
* `--container-command TEXT`: Sobrescribe el punto de entrada del contenedor, como una cadena entre comillas dividida en tokens (p. ej. "python -m sglang.launch_server").
* `--container-args TEXT`: Argumentos añadidos al entrypoint del contenedor, como una cadena entre comillas dividida en tokens (p. ej. "--tp 8 --reasoning-parser qwen3").
* `-e, --env TEXT`: Establece variables de entorno. Por ejemplo, --env ENV=value
* `--env-file TEXT`: Lee un archivo de variables de entorno. Usa `-` para leerlas desde stdin.
* `-s, --secrets TEXT`: Establece variables de entorno secretas. Prefiere `--secrets SECRET` para leer el valor desde tu entorno (p. ej. `--secrets HF_TOKEN` para pasar tu token de Hugging Face); `--secrets SECRET=value` deja el valor en el historial de tu shell.
* `--secrets-file TEXT`: Lee un archivo de variables de entorno secretas. Usa `-` para leerlas desde stdin.
* `--type [public|authenticated|private]`: Tipo de acceso al endpoint. El valor predeterminado es 'authenticated' (con control mediante token, accesible públicamente).
* `--help`: Muestra este mensaje y sale.

Ejemplos $ 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 ...

Más información Utilice `hf <command> --help` para obtener más información sobre un comando. Lea la documentación en https://huggingface.co/docs/huggingface_hub/en/guides/cli

### `hf endpoints describe`

Obtén información sobre un punto de acceso existente.

**Uso**:

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

**Argumentos**:

* `NAME`: Nombre del punto de conexión. [obligatorio]

**Opciones**:

* `--namespace TEXT`: El espacio de nombres asociado con el Inference Endpoint. Por defecto, se usa el espacio de nombres del usuario actual.
* `--token TEXT`: un User Access Token generado desde https://huggingface.co/settings/tokens.
* `--help`: Muestra este mensaje y sale.

Ejemplos $ hf endpoints describe my-endpoint

Más información Utilice `hf <command> --help` para obtener más información sobre un comando. Lea la documentación en https://huggingface.co/docs/huggingface_hub/en/guides/cli

### `hf endpoints hardware`

Muestra el hardware disponible para desplegar un Inference Endpoint.

Solo se enumeran los hardware en los que el namespace puede desplegar en este momento: un estado utilizable y suficiente cuota de aceleradores para una réplica. Utilice `--all` para enumerar todas las combinaciones que devuelve la API.

La cuota es por espacio de nombres, por lo que debe pasar el mismo `--namespace` que pasará a `hf endpoints deploy`. Los precios están en USD, por réplica y por hora.

**Uso**:

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

**Opciones**:

* `--namespace TEXT`: El espacio de nombres asociado con el Inference Endpoint. Por defecto, se usa el espacio de nombres del usuario actual.
* `--vendor TEXT`: Solo mostrar hardware alojado por este proveedor de nube (p. ej., 'aws').
* `--region TEXT`: Solo mostrar el hardware disponible en esta región de la nube (p. ej., 'us-east-1').
* `--accelerator TEXT`: Solo mostrar hardware con este acelerador (p. ej., 'cpu', 'gpu', 'neuron').
* `--instance-type TEXT`: Solo mostrar hardware de este tipo de instancia (p. ej., 'nvidia-l4').
* `-a, --all`: También muestra el hardware que no se puede desplegar ahora mismo (no disponible, obsoleto o sin cuota).
* `--token TEXT`: un User Access Token generado desde https://huggingface.co/settings/tokens.
* `--help`: Muestra este mensaje y sale.

Ejemplos $ hf endpoints hardware $ hf endpoints hardware --vendor aws --accelerator gpu

Más información Utilice `hf <command> --help` para obtener más información sobre un comando. Lea la documentación en https://huggingface.co/docs/huggingface_hub/en/guides/cli

### `hf endpoints list`

Lista todos los Inference Endpoints para el espacio de nombres dado. [alias: ls]

**Uso**:

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

**Opciones**:

* `--namespace TEXT`: El espacio de nombres asociado con el Inference Endpoint. Por defecto, se usa el espacio de nombres del usuario actual.
* `--token TEXT`: un User Access Token generado desde https://huggingface.co/settings/tokens.
* `--help`: Muestra este mensaje y sale.

Ejemplos $ hf endpoints ls $ hf endpoints ls --namespace my-org

Más información Utilice `hf <command> --help` para obtener más información sobre un comando. Lea la documentación en https://huggingface.co/docs/huggingface_hub/en/guides/cli

### `hf endpoints list-catalog`

Muestra los modelos disponibles en el Catálogo de modelos.

Una fila por receta, es decir, por cada forma probada de desplegar un modelo. Despliega una con `hf endpoints catalog deploy --recipe <RECIPE_ID>`.

**Uso**:

```console
$ hf endpoints list-catalog [OPTIONS]
```

**Opciones**:

* `--accelerator [cpu|gpu|neuron]`: Muestra solo las recetas que se ejecutan en este acelerador.
* `--engine [llamacpp|sglang|tei|vllm]`: Muestra solo las recetas que ejecutan este motor de inferencia.
* `--license TEXT`: Solo mostrar modelos bajo esta licencia (p. ej. 'Apache 2.0').
* `--task TEXT`: Solo muestra modelos para esta tarea (p. ej., 'text-generation').
* `--search TEXT`: Consulta de búsqueda.
* `--limit INTEGER`: Limita el número de modelos a devolver.
* `--token TEXT`: un User Access Token generado desde https://huggingface.co/settings/tokens.
* `--help`: Muestra este mensaje y sale.

### `hf endpoints pause`

Pausar un punto de inferencia.

**Uso**:

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

**Argumentos**:

* `NAME`: Nombre del punto de conexión. [obligatorio]

**Opciones**:

* `--namespace TEXT`: El espacio de nombres asociado con el Inference Endpoint. Por defecto, se usa el espacio de nombres del usuario actual.
* `--token TEXT`: un User Access Token generado desde https://huggingface.co/settings/tokens.
* `--help`: Muestra este mensaje y sale.

Ejemplos $ hf endpoints pause my-endpoint

Más información Utilice `hf <command> --help` para obtener más información sobre un comando. Lea la documentación en https://huggingface.co/docs/huggingface_hub/en/guides/cli

### `hf endpoints resume`

Resumir un punto de inferencia.

**Uso**:

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

**Argumentos**:

* `NAME`: Nombre del punto de conexión. [obligatorio]

**Opciones**:

* `--namespace TEXT`: El espacio de nombres asociado con el Inference Endpoint. Por defecto, se usa el espacio de nombres del usuario actual.
* `--fail-if-already-running`: Si `True`, el método lanzará un error si el Inference Endpoint ya está en ejecución.
* `--token TEXT`: un User Access Token generado desde https://huggingface.co/settings/tokens.
* `--help`: Muestra este mensaje y sale.

Ejemplos $ hf endpoints resume my-endpoint

Más información Utilice `hf <command> --help` para obtener más información sobre un comando. Lea la documentación en https://huggingface.co/docs/huggingface_hub/en/guides/cli

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

Escalar un punto de inferencia a cero.

**Uso**:

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

**Argumentos**:

* `NAME`: Nombre del punto de conexión. [obligatorio]

**Opciones**:

* `--namespace TEXT`: El espacio de nombres asociado con el Inference Endpoint. Por defecto, se usa el espacio de nombres del usuario actual.
* `--token TEXT`: un User Access Token generado desde https://huggingface.co/settings/tokens.
* `--help`: Muestra este mensaje y sale.

Ejemplos $ hf endpoints scale-to-zero my-endpoint

Más información Utilice `hf <command> --help` para obtener más información sobre un comando. Lea la documentación en https://huggingface.co/docs/huggingface_hub/en/guides/cli

### `hf endpoints update`

Actualizar un punto de acceso existente.

**Uso**:

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

**Argumentos**:

* `NAME`: Nombre del punto de conexión. [obligatorio]

**Opciones**:

* `--namespace TEXT`: El espacio de nombres asociado con el Inference Endpoint. Por defecto, se usa el espacio de nombres del usuario actual.
* `--repo TEXT`: El nombre del repositorio de modelos asociado con el Inference Endpoint (p. ej., 'openai/gpt-oss-120b').
* `--accelerator TEXT`: El acelerador de hardware que se utilizará para la inferencia (p. ej., 'cpu').
* `--instance-size TEXT`: El tamaño o tipo de la instancia que se usará para alojar el modelo (p. ej., 'x4').
* `--instance-type TEXT`: El tipo de instancia en la nube donde se desplegará el Inference Endpoint (p. ej., 'intel-icl').
* `--framework TEXT`: El framework de machine learning utilizado para el modelo (p. ej., 'custom').
* `--revision TEXT`: La revisión específica del modelo que se va a desplegar en el Inference Endpoint (p. ej. '6c0e6080953db56375760c0471a8c5f2929baf11').
* `--task TEXT`: La tarea en la que se desplegará el modelo (p. ej., 'text-classification').
* `--custom-image TEXT`: URL de la imagen de Docker para el contenedor que se ejecutará (p. ej., 'nexagi/sglang:v0.5.12'). Reemplaza la imagen configurada actualmente en el punto de acceso en lugar de parchearla, por lo que debe pasar junto con ella la configuración del motor y del contenedor que desee conservar; ejecute primero 'hf endpoints describe NAME' para verla.
* `--engine [custom|hf-serve|llamacpp|sglang|tei|tgi|tgi-neuron|vllm|vllm-neuron]`: Imagen del motor administrado para ejecutar --custom-image (p. ej., 'vllm'). El valor predeterminado es un contenedor arbitrario.
* `--health-route TEXT`: Ruta de comprobación de estado expuesta por el contenedor (p. ej., '/health'). Requiere --custom-image.
* `--port INTEGER`: Puerto en el que escucha el contenedor (p. ej., 30000). Requiere --custom-image.
* `--tensor-parallel-size INTEGER`: Número de aceleradores en los que dividir una copia única del modelo (solo motores vLLM y SGLang).
* `--data-parallel-size INTEGER`: Número de copias del modelo que se ejecutarán, una por acelerador (solo motor de vLLM).
* `--container-command TEXT`: Sobrescribe el punto de entrada del contenedor, como una cadena entre comillas dividida en tokens (p. ej. "python -m sglang.launch_server"). Reemplaza el valor actual; pase una cadena vacía para borrarlo.
* `--container-args TEXT`: Argumentos añadidos al entrypoint del contenedor, como una cadena entre comillas dividida en tokens (p. ej. "--enable-auto-tool-choice --tool-call-parser lfm2"). Reemplaza los argumentos actualmente configurados en el endpoint en lugar de añadirse a ellos, por lo que incluye los que quieras conservar; ejecuta 'hf endpoints describe NAME' primero para verlos. Pasa una cadena vacía para borrarlos.
* `--min-replica INTEGER`: El número mínimo de réplicas (instancias) que deben mantenerse en ejecución para el Inference Endpoint.
* `--max-replica INTEGER`: El número máximo de réplicas (instancias) al que escalar el Inference Endpoint.
* `--scale-to-zero-timeout INTEGER`: La duración en minutos antes de que un punto de acceso inactivo se escale a cero.
* `--scaling-metric [pendingRequests|hardwareUsage]`: La métrica de referencia para el escalado.
* `--scaling-threshold FLOAT`: Umbral de la métrica de escalado utilizado para activar un aumento de escala. Se ignora cuando no se proporciona la métrica de escalado.
* `--token TEXT`: un User Access Token generado desde https://huggingface.co/settings/tokens.
* `--help`: Muestra este mensaje y sale.

Ejemplos $ 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"

Más información Utilice `hf <command> --help` para obtener más información sobre un comando. Lea la documentación en https://huggingface.co/docs/huggingface_hub/en/guides/cli

## `hf env`

Imprime información sobre el entorno.

**Uso**:

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

**Opciones**:

* `--help`: Muestra este mensaje y sale.

## `hf extensions`

Gestiona las extensiones de la CLI de hf. [alias: ext]

Advertencia de seguridad: las extensiones son ejecutables de terceros o paquetes de Python. Instálelos solo desde fuentes de confianza.

**Uso**:

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

**Opciones**:

* `--help`: Muestra este mensaje y sale.

**Comandos**:

* `exec`: Ejecuta una extensión instalada.
* `install`: Instala una extensión desde un repositorio público de GitHub.
* `list`: Lista los comandos de extensión instalados. [alias: ls]
* `remove`: Elimina una extensión instalada. [alias: rm]
* `search`: Busca las extensiones disponibles en GitHub (etiquetadas con el tema 'hf-extension').
* `update`: Actualiza la(s) extensión(es) instalada(s) a su(s) última(s) versión(es).

### `hf extensions exec`

Ejecutar una extensión instalada.

**Uso**:

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

**Argumentos**:

* `NAME`: Nombre de la extensión (con o sin el prefijo `hf-`). [Obligatorio]

**Opciones**:

* `--help`: Muestra este mensaje y sale.

Ejemplos $ hf extensions exec claude -- --help $ hf extensions exec claude --model zai-org/GLM-5

Más información Utilice `hf <command> --help` para obtener más información sobre un comando. Lea la documentación en https://huggingface.co/docs/huggingface_hub/en/guides/cli

### `hf extensions install`

Instale una extensión desde un repositorio público de GitHub.

Advertencia de seguridad: esto instala un ejecutable o paquete de Python de un tercero. Instálelo solo desde fuentes de confianza.

**Uso**:

```console
$ hf extensions install [OPTIONS] REPO_ID
```

**Argumentos**:

* `REPO_ID`: repositorio de extensión de GitHub en el formato `[OWNER/]hf-<name>`. [obligatorio]

**Opciones**:

* `--force`: Sobrescribir si ya está instalado.
* `--help`: Muestra este mensaje y sale.

Ejemplos $ hf extensions install hf-claude $ hf extensions install hanouticelina/hf-claude $ hf extensions install alvarobartt/hf-mem

Más información Utilice `hf <command> --help` para obtener más información sobre un comando. Lea la documentación en https://huggingface.co/docs/huggingface_hub/en/guides/cli

### `hf extensions list`

Listar los comandos de extensiones instaladas. [alias: ls]

**Uso**:

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

**Opciones**:

* `--help`: Muestra este mensaje y sale.

Ejemplos $ hf extensions list

Más información Utilice `hf <command> --help` para obtener más información sobre un comando. Lea la documentación en https://huggingface.co/docs/huggingface_hub/en/guides/cli

### `hf extensions remove`

Eliminar una extensión instalada. [alias: rm]

**Uso**:

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

**Argumentos**:

* `NAME`: Nombre de la extensión a eliminar (con o sin el prefijo `hf-`). [obligatorio]

**Opciones**:

* `--help`: Muestra este mensaje y sale.

Ejemplos $ hf extensions remove claude

Más información Utilice `hf <command> --help` para obtener más información sobre un comando. Lea la documentación en https://huggingface.co/docs/huggingface_hub/en/guides/cli

### `hf extensions search`

Busque las extensiones disponibles en GitHub (etiquetadas con el tema 'hf-extension').

**Uso**:

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

**Opciones**:

* `--help`: Muestra este mensaje y sale.

Ejemplos $ hf extensions search

Más información Utilice `hf <command> --help` para obtener más información sobre un comando. Lea la documentación en https://huggingface.co/docs/huggingface_hub/en/guides/cli

### `hf extensions update`

Actualice la(s) extensión(es) instalada(s) a su(s) última(s) versión(es).

**Uso**:

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

**Argumentos**:

* `[NAME]`: Extensión a actualizar (con o sin el prefijo `hf-`, opcionalmente como `OWNER/hf-<name>`). Si se omite, se comprueban todas las extensiones instaladas y se actualizan las desactualizadas.

**Opciones**:

* `--help`: Muestra este mensaje y sale.

Ejemplos $ hf extensions update $ hf extensions update hf-claude $ hf extensions update alvarobartt/hf-mem

Más información Utilice `hf <command> --help` para obtener más información sobre un comando. Lea la documentación en https://huggingface.co/docs/huggingface_hub/en/guides/cli

## `hf jobs`

Ejecuta y gestiona Jobs en el Hub.

**Uso**:

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

**Opciones**:

* `--help`: Muestra este mensaje y sale.

**Comandos**:

* `cancel`: Cancelar un Job
* `expose`: Reemplaza los puertos expuestos en un Job en ejecución.
* `hardware`: Lista las opciones de hardware disponibles para Jobs
* `inspect`: Muestra información detallada sobre uno o más Jobs
* `labels`: Actualiza las etiquetas de un Job.
* `list`: Listar trabajos. [alias: ls, ps]
* `logs`: Obtiene los registros de un Job.
* `rerun`: Ejecuta un nuevo Job con la especificación de un Job existente.
* `run`: Ejecutar un Job.
* `scheduled`: Crea y gestiona Jobs programados en el Hub.
* `ssh`: Conectarse mediante SSH a un Job en ejecución.
* `stats`: Obtiene las estadísticas y métricas de uso de recursos de los Jobs.
* `uv`: Ejecuta scripts de UV (Python con dependencias en línea) en la infraestructura de HF.
* `wait`: Espera a que uno o más Jobs alcancen un estado terminal.

### `hf jobs cancel`

Cancelar un trabajo

**Uso**:

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

**Argumentos**:

* `JOB_ID`: ID del trabajo (o 'namespace/job_id')  [obligatorio]

**Opciones**:

* `--namespace TEXT`: El espacio de nombres donde se ejecutará el trabajo. Por defecto, se utiliza el espacio de nombres del usuario actual.
* `--token TEXT`: un User Access Token generado desde https://huggingface.co/settings/tokens.
* `--help`: Muestra este mensaje y sale.

Ejemplos $ hf jobs cancel

Más información Utilice `hf <command> --help` para obtener más información sobre un comando. Lea la documentación en https://huggingface.co/docs/huggingface_hub/en/guides/cli

### `hf jobs expose`

Reemplazar los puertos expuestos en un Job en ejecución.

**Uso**:

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

**Argumentos**:

* `JOB_ID`: ID del trabajo (o 'namespace/job_id')  [obligatorio]
* `[PORTS]...`: Puertos que se expondrán a través del proxy de trabajos. El acceso requiere un token de HF con permiso de lectura en el espacio de nombres del trabajo.

**Opciones**:

* `--public INTEGER`: Expone un puerto sin autenticación. Repita la bandera para varios puertos. No es necesario pasar el puerto también como argumento posicional.
* `--clear`: Cierra todos los puertos expuestos.
* `--namespace TEXT`: El espacio de nombres donde se ejecutará el trabajo. Por defecto, se utiliza el espacio de nombres del usuario actual.
* `--token TEXT`: un User Access Token generado desde https://huggingface.co/settings/tokens.
* `--help`: Muestra este mensaje y sale.

Ejemplos $ hf jobs expose  8000 $ hf jobs expose  8000 --public 9000 $ hf jobs expose  --clear

Más información Utilice `hf <command> --help` para obtener más información sobre un comando. Lea la documentación en https://huggingface.co/docs/huggingface_hub/en/guides/cli

### `hf jobs hardware`

Listar las opciones de hardware disponibles para Jobs

**Uso**:

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

**Opciones**:

* `--help`: Muestra este mensaje y sale.

Ejemplos $ hf jobs hardware

Más información Utilice `hf <command> --help` para obtener más información sobre un comando. Lea la documentación en https://huggingface.co/docs/huggingface_hub/en/guides/cli

### `hf jobs inspect`

Mostrar información detallada sobre uno o más Jobs

**Uso**:

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

**Argumentos**:

* `JOB_IDS...`: IDs de trabajos a inspeccionar (o 'namespace/job_id')  [obligatorio]

**Opciones**:

* `--namespace TEXT`: El espacio de nombres donde se ejecutará el trabajo. Por defecto, se utiliza el espacio de nombres del usuario actual.
* `--token TEXT`: un User Access Token generado desde https://huggingface.co/settings/tokens.
* `--help`: Muestra este mensaje y sale.

Ejemplos $ hf jobs inspect

Más información Utilice `hf <command> --help` para obtener más información sobre un comando. Lea la documentación en https://huggingface.co/docs/huggingface_hub/en/guides/cli

### `hf jobs labels`

Actualiza las etiquetas de un Job. Al pasar --label se reemplazan todas las etiquetas existentes; al pasar solo --name se conservan.

**Uso**:

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

**Argumentos**:

* `JOB_ID`: ID del trabajo (o 'namespace/job_id')  [obligatorio]

**Opciones**:

* `--name TEXT`: Nombre del Job. Se almacena como la etiqueta `name`. Los nombres no tienen que ser únicos. El valor predeterminado es el nombre de la imagen o del script más un hash corto de la configuración de lanzamiento resuelta.
* `-l, --label TEXT`: Establece etiquetas. Por ejemplo, --label KEY=VALUE o --label LABEL
* `--clear`: Elimina todas las etiquetas del trabajo.
* `--namespace TEXT`: El espacio de nombres donde se ejecutará el trabajo. Por defecto, se utiliza el espacio de nombres del usuario actual.
* `--token TEXT`: un User Access Token generado desde https://huggingface.co/settings/tokens.
* `--help`: Muestra este mensaje y sale.

Ejemplos $ hf jobs labels  --name training-v2 $ hf jobs labels  --label env=prod --label team=ml $ hf jobs labels  --clear

Más información Utilice `hf <command> --help` para obtener más información sobre un comando. Lea la documentación en https://huggingface.co/docs/huggingface_hub/en/guides/cli

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

Listar trabajos.

Use `--status` para filtrar por estado (consulte [JobStage](/docs/huggingface_hub/main/es/package_reference/jobs#huggingface_hub.JobStage) para los valores posibles) y `--label` para filtrar por etiquetas `key=value`. Un Job debe coincidir con todos los filtros para ser listado.

**Uso**:

```console
$ hf jobs list | ls | ps [OPTIONS]
```

**Opciones**:

* `-a, --all`: Muestra todos los Jobs (por defecto muestra los que están en ejecución y en programación). No se puede combinar con --status.
* `--status [COMPLETED|CANCELED|ERROR|DELETED|SCHEDULING|RUNNING]`: Muestra solo los Jobs con el estado indicado. Separados por comas o repetidos, p. ej. `--status running,scheduling`.
* `-l, --label TEXT`: Muestra solo los Jobs con la etiqueta `key=value` indicada. Repítelo para requerir varias etiquetas, p. ej. `--label env=prod --label team=ml`.
* `--name TEXT`: Solo muestra Jobs con el nombre indicado (atajo para `--label name=NAME`).
* `--limit INTEGER`: Número máximo de Jobs a mostrar. Establezca 0 para mostrar todos (sin límite). [predeterminado: 100]
* `--namespace TEXT`: El espacio de nombres donde se ejecutará el trabajo. Por defecto, se utiliza el espacio de nombres del usuario actual.
* `--token TEXT`: un User Access Token generado desde https://huggingface.co/settings/tokens.
* `--help`: Muestra este mensaje y sale.

Ejemplos $ 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

Más información Utilice `hf <command> --help` para obtener más información sobre un comando. Lea la documentación en https://huggingface.co/docs/huggingface_hub/en/guides/cli

### `hf jobs logs`

Obtén los registros de un Job.

Por defecto, imprime los registros disponibles actualmente y sale (no bloqueante). Use --follow/-f para transmitir los registros en tiempo real hasta que el trabajo se complete. Use --tail/-n para limitar el número de líneas devueltas (en el servidor cuando se admite).

Nota: el seguimiento finaliza cuando termina el flujo de registros, independientemente de si el Job tuvo éxito o falló. Ejecuta `hf jobs inspect <job_id>` para comprobar el estado final.

**Uso**:

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

**Argumentos**:

* `JOB_ID`: ID del trabajo (o 'namespace/job_id')  [obligatorio]

**Opciones**:

* `-f, --follow`: Sigue la salida de registros (transmite hasta que el trabajo se complete). Sin esta bandera, solo se imprimen los registros disponibles en ese momento.
* `-n, --tail INTEGER`: Número de líneas que se mostrarán desde el final de los registros. Cuando se combina con --follow, comienza a transmitir desde las últimas N líneas.
* `--namespace TEXT`: El espacio de nombres donde se ejecutará el trabajo. Por defecto, se utiliza el espacio de nombres del usuario actual.
* `--token TEXT`: un User Access Token generado desde https://huggingface.co/settings/tokens.
* `--help`: Muestra este mensaje y sale.

Ejemplos $ hf jobs logs $ hf jobs logs -f $ hf jobs logs --tail 20 $ hf jobs logs -f --tail 100

Más información Utilice `hf <command> --help` para obtener más información sobre un comando. Lea la documentación en https://huggingface.co/docs/huggingface_hub/en/guides/cli

### `hf jobs rerun`

Ejecuta un nuevo Job con la especificación de un Job existente.

**Uso**:

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

**Argumentos**:

* `JOB_ID`: ID del trabajo (o 'namespace/job_id')  [obligatorio]

**Opciones**:

* `-d, --detach`: Ejecuta el Job en segundo plano e imprime el ID del Job.
* `--namespace TEXT`: El espacio de nombres donde se ejecutará el trabajo. Por defecto, se utiliza el espacio de nombres del usuario actual.
* `--token TEXT`: un User Access Token generado desde https://huggingface.co/settings/tokens.
* `--help`: Muestra este mensaje y sale.

Ejemplos $ hf jobs rerun $ hf jobs rerun --detach

Más información Utilice `hf <command> --help` para obtener más información sobre un comando. Lea la documentación en https://huggingface.co/docs/huggingface_hub/en/guides/cli

### `hf jobs run`

Ejecutar un trabajo.

**Uso**:

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

**Argumentos**:

* `IMAGE`: La imagen de Docker que se va a utilizar. [obligatorio]
* `COMMAND...`: El comando a ejecutar. [obligatorio]

**Opciones**:

* `-e, --env TEXT`: Establece variables de entorno. Por ejemplo, --env ENV=value
* `-s, --secrets TEXT`: Establece variables de entorno secretas. Prefiere `--secrets SECRET` para leer el valor desde tu entorno (p. ej. `--secrets HF_TOKEN` para pasar tu token de Hugging Face); `--secrets SECRET=value` deja el valor en el historial de tu shell.
* `--name TEXT`: Nombre del Job. Se almacena como la etiqueta `name`. Los nombres no tienen que ser únicos. El valor predeterminado es el nombre de la imagen o del script más un hash corto de la configuración de lanzamiento resuelta.
* `-l, --label TEXT`: Establece etiquetas. Por ejemplo, --label KEY=VALUE o --label LABEL
* `-v, --volume TEXT`: Monta uno o más volúmenes. Formato: hf://[TYPE/]SOURCE:/MOUNT_PATH[:ro|:rw] o LOCAL_DIR:/MOUNT_PATH[:ro|:rw]. TYPE es uno de: models, datasets, spaces, buckets. Si se omite TYPE, el valor predeterminado es models. models, datasets y spaces siempre se montan solo de lectura. buckets se montan con lectura y escritura de forma predeterminada. Una fuente de directorio local se sincroniza primero con un bucket y se monta solo de lectura de forma predeterminada. Por ejemplo, -v hf://datasets/org/ds:/data o -v hf://buckets/org/b:/mnt:ro o -v ./inputs:/inputs
* `--env-file TEXT`: Lee un archivo de variables de entorno. Usa `-` para leerlas desde stdin.
* `--secrets-file TEXT`: Lee un archivo de variables de entorno secretas. Usa `-` para leerlas desde 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]`: Flavor para el hardware. Ejecuta 'hf jobs hardware' para listar los flavors disponibles. El valor predeterminado es `cpu-basic`.
* `--timeout TEXT`: Duración máxima: int con s (segundos, predeterminado), m (minutos), h (horas) o d (días).
* `--attempts INTEGER RANGE`: Intentos máximos, incluida la primera ejecución. El valor predeterminado es 1. [x>=1]
* `-d, --detach`: Ejecuta el Job en segundo plano e imprime el ID del Job.
* `--dry-run`: Imprime la configuración del Job resuelta sin enviar el Job.
* `--expose INTEGER`: Expone un puerto del contenedor a través del proxy de trabajos. Repita la bandera para varios puertos (p. ej. `--expose 8000 --expose 8001`). Cada puerto expuesto es accesible en el dominio público de trabajos; el acceso requiere un token de HF con permiso de lectura en el espacio de nombres del trabajo.
* `--expose-public INTEGER`: Expone un puerto del contenedor a través del proxy de trabajos sin autenticación. Repita la bandera para varios puertos. No es necesario pasar también el puerto con `--expose`.
* `--ssh`: Hace que el contenedor del trabajo sea accesible mediante SSH. Conéctese con `hf jobs ssh <job_id>`. Requiere una clave pública SSH registrada en https://huggingface.co/settings/keys.
* `--network-group TEXT`: Unirse a un grupo de red. Los trabajos en el mismo namespace y grupo de recursos que comparten un grupo se colocan juntos y se comunican entre sí en todos los puertos. Dentro de cada miembro, `$HF_NETWORK_GROUP_HOSTNAME` se resuelve a todos los miembros. Alfanuméricos en minúsculas y guiones, máximo 46 caracteres.
* `--network-alias TEXT`: Reclama un alias en el grupo de red. Los miembros acceden a los trabajos que lo reclaman en `${HF_NETWORK_GROUP_PREFIX}<alias>`. Repite la bandera para varios alias. Alfanuméricos en minúsculas y guiones, máximo 34 caracteres, único dentro del trabajo. Requiere `--network-group`.
* `--resource-group-id TEXT`: El ID del grupo de recursos en el que se creará el Job. Se utiliza para controlar el acceso a los recursos dentro de una organización y para las funciones de atribución de costos y límites de gasto.
* `--namespace TEXT`: El espacio de nombres donde se ejecutará el trabajo. Por defecto, se utiliza el espacio de nombres del usuario actual.
* `--token TEXT`: un User Access Token generado desde https://huggingface.co/settings/tokens.
* `--format [agent|auto|human|json|quiet]`: Formato de salida. El valor predeterminado es 'auto', que elige 'agent' o 'human' en función de la terminal.
* `--json`: salida en JSON. Equivalente a '--format json'.
* `-q, --quiet`: Salida silenciosa (un ID por línea). Equivalente a '--format quiet'.
* `--help`: Muestra este mensaje y sale.

Ejemplos $ 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

Más información Utilice `hf <command> --help` para obtener más información sobre un comando. Lea la documentación en https://huggingface.co/docs/huggingface_hub/en/guides/cli

### `hf jobs scheduled`

Crea y gestiona Jobs programados en el Hub.

**Uso**:

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

**Opciones**:

* `--help`: Muestra este mensaje y sale.

**Comandos**:

* `delete`: Elimina un Job programado.
* `inspect`: Muestra información detallada sobre uno o más Jobs programados
* `labels`: Actualiza las etiquetas de un Job programado.
* `list`: Lista los Jobs programados. [alias: ls, ps]
* `reschedule`: Cambia cuándo se ejecuta un Job programado.
* `resume`: Reanuda (despausa) un Job programado.
* `run`: Programar un Job.
* `suspend`: Suspender (pausar) un Job programado.
* `trigger`: Dispara la ejecución inmediata de un Job programado (no modifica la programación).
* `uv`: Programar scripts de UV en la infraestructura de HF.

#### `hf jobs scheduled delete`

Eliminar un Job programado.

**Uso**:

```console
$ hf jobs scheduled delete [OPTIONS] SCHEDULED_JOB_ID
```

**Argumentos**:

* `SCHEDULED_JOB_ID`: ID del trabajo programado (o 'namespace/scheduled_job_id') [obligatorio]

**Opciones**:

* `--namespace TEXT`: El espacio de nombres donde se ejecutará el trabajo. Por defecto, se utiliza el espacio de nombres del usuario actual.
* `--token TEXT`: un User Access Token generado desde https://huggingface.co/settings/tokens.
* `--help`: Muestra este mensaje y sale.

Ejemplos hf jobs scheduled delete

Más información Utilice `hf <command> --help` para obtener más información sobre un comando. Lea la documentación en https://huggingface.co/docs/huggingface_hub/en/guides/cli

#### `hf jobs scheduled inspect`

Mostrar información detallada sobre uno o más Jobs programados

**Uso**:

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

**Argumentos**:

* `SCHEDULED_JOB_IDS...`: IDs de trabajos programados para inspeccionar (o 'namespace/scheduled_job_id') [obligatorio]

**Opciones**:

* `--namespace TEXT`: El espacio de nombres donde se ejecutará el trabajo. Por defecto, se utiliza el espacio de nombres del usuario actual.
* `--token TEXT`: un User Access Token generado desde https://huggingface.co/settings/tokens.
* `--help`: Muestra este mensaje y sale.

Ejemplos $ hf jobs scheduled inspect

Más información Utilice `hf <command> --help` para obtener más información sobre un comando. Lea la documentación en https://huggingface.co/docs/huggingface_hub/en/guides/cli

#### `hf jobs scheduled labels`

Actualice las etiquetas de un Job programado. Si se pasa --label, se reemplazan todas las etiquetas existentes; si solo se pasa --name, se conservan.

**Uso**:

```console
$ hf jobs scheduled labels [OPTIONS] SCHEDULED_JOB_ID
```

**Argumentos**:

* `SCHEDULED_JOB_ID`: ID del trabajo programado (o 'namespace/scheduled_job_id') [obligatorio]

**Opciones**:

* `--name TEXT`: Nombre del Job. Se almacena como la etiqueta `name`. Los nombres no tienen que ser únicos. El valor predeterminado es el nombre de la imagen o del script más un hash corto de la configuración de lanzamiento resuelta.
* `-l, --label TEXT`: Establece etiquetas. Por ejemplo, --label KEY=VALUE o --label LABEL
* `--clear`: Elimina todas las etiquetas de la tarea programada.
* `--namespace TEXT`: El espacio de nombres donde se ejecutará el trabajo. Por defecto, se utiliza el espacio de nombres del usuario actual.
* `--token TEXT`: un User Access Token generado desde https://huggingface.co/settings/tokens.
* `--help`: Muestra este mensaje y sale.

Ejemplos $ hf jobs scheduled labels  --name daily-script $ hf jobs scheduled labels  --label env=prod --label team=ml $ hf jobs scheduled labels  --clear

Más información Utilice `hf <command> --help` para obtener más información sobre un comando. Lea la documentación en https://huggingface.co/docs/huggingface_hub/en/guides/cli

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

Listar trabajos programados.

Use `--status` para filtrar por estado (`active` o `suspended`) y `--label` para filtrar por etiquetas `key=value`. Un Job programado debe coincidir con todos los filtros para ser listado.

**Uso**:

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

**Opciones**:

* `-a, --all`: Muestra todos los Jobs programados (por defecto se ocultan los suspendidos). No se puede combinar con --status.
* `--status [active|suspended]`: Muestra solo los Jobs programados con el estado indicado. Separados por comas o repetidos, p. ej. `--status suspended`.
* `-l, --label TEXT`: Muestra solo los Jobs programados con la etiqueta `key=value` indicada. Repítelo para requerir varias etiquetas, p. ej. `--label env=prod --label team=ml`.
* `--name TEXT`: Solo muestra Jobs programados con el nombre indicado (atajo para `--label name=NAME`).
* `--namespace TEXT`: El espacio de nombres donde se ejecutará el trabajo. Por defecto, se utiliza el espacio de nombres del usuario actual.
* `--token TEXT`: un User Access Token generado desde https://huggingface.co/settings/tokens.
* `--help`: Muestra este mensaje y sale.

Ejemplos $ 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

Más información Utilice `hf <command> --help` para obtener más información sobre un comando. Lea la documentación en https://huggingface.co/docs/huggingface_hub/en/guides/cli

#### `hf jobs scheduled reschedule`

Cambiar cuándo se ejecuta un Job programado.

**Uso**:

```console
$ hf jobs scheduled reschedule [OPTIONS] SCHEDULED_JOB_ID SCHEDULE
```

**Argumentos**:

* `SCHEDULED_JOB_ID`: ID del trabajo programado (o 'namespace/scheduled_job_id') [obligatorio]
* `SCHEDULE`: uno de @annually, @yearly, @monthly, @weekly, @daily, @hourly, o una expresión de programación CRON. [obligatorio]

**Opciones**:

* `--namespace TEXT`: El espacio de nombres donde se ejecutará el trabajo. Por defecto, se utiliza el espacio de nombres del usuario actual.
* `--token TEXT`: un User Access Token generado desde https://huggingface.co/settings/tokens.
* `--help`: Muestra este mensaje y sale.

Ejemplos $ hf jobs scheduled reschedule  "0 9 * * 1"

Más información Utilice `hf <command> --help` para obtener más información sobre un comando. Lea la documentación en https://huggingface.co/docs/huggingface_hub/en/guides/cli

#### `hf jobs scheduled resume`

Resume (reanudar) un Job programado.

**Uso**:

```console
$ hf jobs scheduled resume [OPTIONS] SCHEDULED_JOB_ID
```

**Argumentos**:

* `SCHEDULED_JOB_ID`: ID del trabajo programado (o 'namespace/scheduled_job_id') [obligatorio]

**Opciones**:

* `--namespace TEXT`: El espacio de nombres donde se ejecutará el trabajo. Por defecto, se utiliza el espacio de nombres del usuario actual.
* `--token TEXT`: un User Access Token generado desde https://huggingface.co/settings/tokens.
* `--help`: Muestra este mensaje y sale.

Ejemplos hf jobs scheduled resume

Más información Utilice `hf <command> --help` para obtener más información sobre un comando. Lea la documentación en https://huggingface.co/docs/huggingface_hub/en/guides/cli

#### `hf jobs scheduled run`

Programar un trabajo.

**Uso**:

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

**Argumentos**:

* `SCHEDULE`: uno de @annually, @yearly, @monthly, @weekly, @daily, @hourly, o una expresión de programación CRON. [obligatorio]
* `IMAGE`: La imagen de Docker que se va a utilizar. [obligatorio]
* `COMMAND...`: El comando a ejecutar. [obligatorio]

**Opciones**:

* `--suspend / --no-suspend`: Suspender (pausar) el Job programado
* `--concurrency / --no-concurrency`: Permite que se ejecuten varias instancias de este Job de forma concurrente
* `-e, --env TEXT`: Establece variables de entorno. Por ejemplo, --env ENV=value
* `-s, --secrets TEXT`: Establece variables de entorno secretas. Prefiere `--secrets SECRET` para leer el valor desde tu entorno (p. ej. `--secrets HF_TOKEN` para pasar tu token de Hugging Face); `--secrets SECRET=value` deja el valor en el historial de tu shell.
* `--name TEXT`: Nombre del Job. Se almacena como la etiqueta `name`. Los nombres no tienen que ser únicos. El valor predeterminado es el nombre de la imagen o del script más un hash corto de la configuración de lanzamiento resuelta.
* `-l, --label TEXT`: Establece etiquetas. Por ejemplo, --label KEY=VALUE o --label LABEL
* `-v, --volume TEXT`: Monta uno o más volúmenes. Formato: hf://[TYPE/]SOURCE:/MOUNT_PATH[:ro|:rw] o LOCAL_DIR:/MOUNT_PATH[:ro|:rw]. TYPE es uno de: models, datasets, spaces, buckets. Si se omite TYPE, el valor predeterminado es models. models, datasets y spaces siempre se montan solo de lectura. buckets se montan con lectura y escritura de forma predeterminada. Una fuente de directorio local se sincroniza primero con un bucket y se monta solo de lectura de forma predeterminada. Por ejemplo, -v hf://datasets/org/ds:/data o -v hf://buckets/org/b:/mnt:ro o -v ./inputs:/inputs
* `--env-file TEXT`: Lee un archivo de variables de entorno. Usa `-` para leerlas desde stdin.
* `--secrets-file TEXT`: Lee un archivo de variables de entorno secretas. Usa `-` para leerlas desde 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]`: Flavor para el hardware. Ejecuta 'hf jobs hardware' para listar los flavors disponibles. El valor predeterminado es `cpu-basic`.
* `--timeout TEXT`: Duración máxima: int con s (segundos, predeterminado), m (minutos), h (horas) o d (días).
* `--attempts INTEGER RANGE`: Intentos máximos, incluida la primera ejecución. El valor predeterminado es 1. [x>=1]
* `--dry-run`: Imprime la configuración del Job resuelta sin enviar el Job.
* `--expose INTEGER`: Expone un puerto del contenedor a través del proxy de trabajos. Repita la bandera para varios puertos (p. ej. `--expose 8000 --expose 8001`). Cada puerto expuesto es accesible en el dominio público de trabajos; el acceso requiere un token de HF con permiso de lectura en el espacio de nombres del trabajo.
* `--expose-public INTEGER`: Expone un puerto del contenedor a través del proxy de trabajos sin autenticación. Repita la bandera para varios puertos. No es necesario pasar también el puerto con `--expose`.
* `--resource-group-id TEXT`: El ID del grupo de recursos en el que se creará el Job. Se utiliza para controlar el acceso a los recursos dentro de una organización y para las funciones de atribución de costos y límites de gasto.
* `--namespace TEXT`: El espacio de nombres donde se ejecutará el trabajo. Por defecto, se utiliza el espacio de nombres del usuario actual.
* `--token TEXT`: un User Access Token generado desde https://huggingface.co/settings/tokens.
* `--format [agent|auto|human|json|quiet]`: Formato de salida. El valor predeterminado es 'auto', que elige 'agent' o 'human' en función de la terminal.
* `--json`: salida en JSON. Equivalente a '--format json'.
* `-q, --quiet`: Salida silenciosa (un ID por línea). Equivalente a '--format quiet'.
* `--help`: Muestra este mensaje y sale.

Ejemplos $ hf jobs scheduled run "0 0 * * *" --name daily-script python:3.12 python script.py

Más información Utilice `hf <command> --help` para obtener más información sobre un comando. Lea la documentación en https://huggingface.co/docs/huggingface_hub/en/guides/cli

#### `hf jobs scheduled suspend`

Suspend (pausa) un Job programado.

**Uso**:

```console
$ hf jobs scheduled suspend [OPTIONS] SCHEDULED_JOB_ID
```

**Argumentos**:

* `SCHEDULED_JOB_ID`: ID del trabajo programado (o 'namespace/scheduled_job_id') [obligatorio]

**Opciones**:

* `--namespace TEXT`: El espacio de nombres donde se ejecutará el trabajo. Por defecto, se utiliza el espacio de nombres del usuario actual.
* `--token TEXT`: un User Access Token generado desde https://huggingface.co/settings/tokens.
* `--help`: Muestra este mensaje y sale.

Ejemplos hf jobs scheduled suspend

Más información Utilice `hf <command> --help` para obtener más información sobre un comando. Lea la documentación en https://huggingface.co/docs/huggingface_hub/en/guides/cli

#### `hf jobs scheduled trigger`

Disparar un Job programado para que se ejecute de inmediato (no modifica la programación).

**Uso**:

```console
$ hf jobs scheduled trigger [OPTIONS] SCHEDULED_JOB_ID
```

**Argumentos**:

* `SCHEDULED_JOB_ID`: ID del trabajo programado (o 'namespace/scheduled_job_id') [obligatorio]

**Opciones**:

* `--namespace TEXT`: El espacio de nombres donde se ejecutará el trabajo. Por defecto, se utiliza el espacio de nombres del usuario actual.
* `--token TEXT`: un User Access Token generado desde https://huggingface.co/settings/tokens.
* `--help`: Muestra este mensaje y sale.

Ejemplos $ hf jobs scheduled trigger

Más información Utilice `hf <command> --help` para obtener más información sobre un comando. Lea la documentación en https://huggingface.co/docs/huggingface_hub/en/guides/cli

#### `hf jobs scheduled uv`

Programa los scripts de UV en la infraestructura de HF.

**Uso**:

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

**Opciones**:

* `--help`: Muestra este mensaje y sale.

**Comandos**:

* `run`: Ejecuta un script de UV (archivo local o URL) en la infraestructura de HF

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

Ejecutar un script de UV (archivo local o URL) en la infraestructura de HF

**Uso**:

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

**Argumentos**:

* `SCHEDULE`: uno de @annually, @yearly, @monthly, @weekly, @daily, @hourly, o una expresión de programación CRON. [obligatorio]
* `SCRIPT`: script de UV para ejecutar (archivo local o URL)  [obligatorio]
* `[SCRIPT_ARGS]...`: Argumentos para el script

**Opciones**:

* `--suspend / --no-suspend`: Suspender (pausar) el Job programado
* `--concurrency / --no-concurrency`: Permite que se ejecuten varias instancias de este Job de forma concurrente
* `--image TEXT`: Use una imagen de Docker personalizada con `uv` instalado.
* `--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]`: Flavor para el hardware. Ejecuta 'hf jobs hardware' para listar los flavors disponibles. El valor predeterminado es `cpu-basic`.
* `-e, --env TEXT`: Establece variables de entorno. Por ejemplo, --env ENV=value
* `-s, --secrets TEXT`: Establece variables de entorno secretas. Prefiere `--secrets SECRET` para leer el valor desde tu entorno (p. ej. `--secrets HF_TOKEN` para pasar tu token de Hugging Face); `--secrets SECRET=value` deja el valor en el historial de tu shell.
* `--name TEXT`: Nombre del Job. Se almacena como la etiqueta `name`. Los nombres no tienen que ser únicos. El valor predeterminado es el nombre de la imagen o del script más un hash corto de la configuración de lanzamiento resuelta.
* `-l, --label TEXT`: Establece etiquetas. Por ejemplo, --label KEY=VALUE o --label LABEL
* `-v, --volume TEXT`: Monta uno o más volúmenes. Formato: hf://[TYPE/]SOURCE:/MOUNT_PATH[:ro|:rw] o LOCAL_DIR:/MOUNT_PATH[:ro|:rw]. TYPE es uno de: models, datasets, spaces, buckets. Si se omite TYPE, el valor predeterminado es models. models, datasets y spaces siempre se montan solo de lectura. buckets se montan con lectura y escritura de forma predeterminada. Una fuente de directorio local se sincroniza primero con un bucket y se monta solo de lectura de forma predeterminada. Por ejemplo, -v hf://datasets/org/ds:/data o -v hf://buckets/org/b:/mnt:ro o -v ./inputs:/inputs
* `--env-file TEXT`: Lee un archivo de variables de entorno. Usa `-` para leerlas desde stdin.
* `--secrets-file TEXT`: Lee un archivo de variables de entorno secretas. Usa `-` para leerlas desde stdin.
* `--timeout TEXT`: Duración máxima: int con s (segundos, predeterminado), m (minutos), h (horas) o d (días).
* `--attempts INTEGER RANGE`: Intentos máximos, incluida la primera ejecución. El valor predeterminado es 1. [x>=1]
* `--dry-run`: Imprime la configuración del Job resuelta sin enviar el Job.
* `--expose INTEGER`: Expone un puerto del contenedor a través del proxy de trabajos. Repita la bandera para varios puertos (p. ej. `--expose 8000 --expose 8001`). Cada puerto expuesto es accesible en el dominio público de trabajos; el acceso requiere un token de HF con permiso de lectura en el espacio de nombres del trabajo.
* `--expose-public INTEGER`: Expone un puerto del contenedor a través del proxy de trabajos sin autenticación. Repita la bandera para varios puertos. No es necesario pasar también el puerto con `--expose`.
* `--resource-group-id TEXT`: El ID del grupo de recursos en el que se creará el Job. Se utiliza para controlar el acceso a los recursos dentro de una organización y para las funciones de atribución de costos y límites de gasto.
* `--namespace TEXT`: El espacio de nombres donde se ejecutará el trabajo. Por defecto, se utiliza el espacio de nombres del usuario actual.
* `--token TEXT`: un User Access Token generado desde https://huggingface.co/settings/tokens.
* `--with TEXT`: Ejecutar con los paquetes indicados instalados
* `-p, --python TEXT`: El intérprete de Python que se usará para el entorno de ejecución
* `--format [agent|auto|human|json|quiet]`: Formato de salida. El valor predeterminado es 'auto', que elige 'agent' o 'human' en función de la terminal.
* `--json`: salida en JSON. Equivalente a '--format json'.
* `-q, --quiet`: Salida silenciosa (un ID por línea). Equivalente a '--format quiet'.
* `--help`: Muestra este mensaje y sale.

Ejemplos $ hf jobs scheduled uv run "0 0 * * *" --name daily-script script.py $ hf jobs scheduled uv run "0 0 * * *" script.py --with pandas

Más información Utilice `hf <command> --help` para obtener más información sobre un comando. Lea la documentación en https://huggingface.co/docs/huggingface_hub/en/guides/cli

### `hf jobs ssh`

Conéctese mediante SSH a un Job en ejecución.

Si el Job aún no está en ejecución, espera hasta que alcance el estado RUNNING antes de conectar. Requiere que el Job se haya iniciado con SSH habilitado (`hf jobs run --ssh ...`) y que tu clave pública SSH esté registrada en https://huggingface.co/settings/keys.

**Uso**:

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

**Argumentos**:

* `JOB_ID`: ID del trabajo (o 'namespace/job_id')  [obligatorio]

**Opciones**:

* `-i, --identity-file PATH`: Ruta al archivo de identidad SSH (se reenvía a `ssh -i`).
* `--dry-run`: Imprime el comando SSH en lugar de ejecutarlo.
* `--namespace TEXT`: El espacio de nombres donde se ejecutará el trabajo. Por defecto, se utiliza el espacio de nombres del usuario actual.
* `--token TEXT`: un User Access Token generado desde https://huggingface.co/settings/tokens.
* `--help`: Muestra este mensaje y sale.

Ejemplos $ hf jobs ssh $ hf jobs ssh  --dry-run $ hf jobs ssh  -i ~/.ssh/id_ed25519

Más información Utilice `hf <command> --help` para obtener más información sobre un comando. Lea la documentación en https://huggingface.co/docs/huggingface_hub/en/guides/cli

### `hf jobs stats`

Obtén las estadísticas y métricas de uso de recursos de los Jobs.

Por defecto, imprime una instantánea de las estadísticas actuales y sale (no bloqueante). Use --follow/-f para mostrar estadísticas en vivo hasta que los Jobs se completen.

**Uso**:

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

**Argumentos**:

* `[JOB_IDS]...`: IDs de trabajo (o 'namespace/job_id')

**Opciones**:

* `-f, --follow`: Sigue la salida de estadísticas (vista en vivo hasta que los Jobs se completen). Sin esta bandera, se imprime una instantánea única.
* `--namespace TEXT`: El espacio de nombres donde se ejecutará el trabajo. Por defecto, se utiliza el espacio de nombres del usuario actual.
* `--token TEXT`: un User Access Token generado desde https://huggingface.co/settings/tokens.
* `--help`: Muestra este mensaje y sale.

Ejemplos $ hf jobs stats $ hf jobs stats $ hf jobs stats -f

Más información Utilice `hf <command> --help` para obtener más información sobre un comando. Lea la documentación en https://huggingface.co/docs/huggingface_hub/en/guides/cli

### `hf jobs uv`

Ejecuta scripts de UV (Python con dependencias integradas) en la infraestructura de HF.

**Uso**:

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

**Opciones**:

* `--help`: Muestra este mensaje y sale.

**Comandos**:

* `run`: Ejecuta un script de UV (archivo local o URL) en la infraestructura de HF

#### `hf jobs uv run`

Ejecutar un script de UV (archivo local o URL) en la infraestructura de HF

**Uso**:

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

**Argumentos**:

* `SCRIPT`: script de UV para ejecutar (archivo local o URL)  [obligatorio]
* `[SCRIPT_ARGS]...`: Argumentos para el script

**Opciones**:

* `--image TEXT`: Use una imagen de Docker personalizada con `uv` instalado.
* `--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]`: Flavor para el hardware. Ejecuta 'hf jobs hardware' para listar los flavors disponibles. El valor predeterminado es `cpu-basic`.
* `-e, --env TEXT`: Establece variables de entorno. Por ejemplo, --env ENV=value
* `-s, --secrets TEXT`: Establece variables de entorno secretas. Prefiere `--secrets SECRET` para leer el valor desde tu entorno (p. ej. `--secrets HF_TOKEN` para pasar tu token de Hugging Face); `--secrets SECRET=value` deja el valor en el historial de tu shell.
* `--name TEXT`: Nombre del Job. Se almacena como la etiqueta `name`. Los nombres no tienen que ser únicos. El valor predeterminado es el nombre de la imagen o del script más un hash corto de la configuración de lanzamiento resuelta.
* `-l, --label TEXT`: Establece etiquetas. Por ejemplo, --label KEY=VALUE o --label LABEL
* `-v, --volume TEXT`: Monta uno o más volúmenes. Formato: hf://[TYPE/]SOURCE:/MOUNT_PATH[:ro|:rw] o LOCAL_DIR:/MOUNT_PATH[:ro|:rw]. TYPE es uno de: models, datasets, spaces, buckets. Si se omite TYPE, el valor predeterminado es models. models, datasets y spaces siempre se montan solo de lectura. buckets se montan con lectura y escritura de forma predeterminada. Una fuente de directorio local se sincroniza primero con un bucket y se monta solo de lectura de forma predeterminada. Por ejemplo, -v hf://datasets/org/ds:/data o -v hf://buckets/org/b:/mnt:ro o -v ./inputs:/inputs
* `--env-file TEXT`: Lee un archivo de variables de entorno. Usa `-` para leerlas desde stdin.
* `--secrets-file TEXT`: Lee un archivo de variables de entorno secretas. Usa `-` para leerlas desde stdin.
* `--timeout TEXT`: Duración máxima: int con s (segundos, predeterminado), m (minutos), h (horas) o d (días).
* `--attempts INTEGER RANGE`: Intentos máximos, incluida la primera ejecución. El valor predeterminado es 1. [x>=1]
* `-d, --detach`: Ejecuta el Job en segundo plano e imprime el ID del Job.
* `--dry-run`: Imprime la configuración del Job resuelta sin enviar el Job.
* `--expose INTEGER`: Expone un puerto del contenedor a través del proxy de trabajos. Repita la bandera para varios puertos (p. ej. `--expose 8000 --expose 8001`). Cada puerto expuesto es accesible en el dominio público de trabajos; el acceso requiere un token de HF con permiso de lectura en el espacio de nombres del trabajo.
* `--expose-public INTEGER`: Expone un puerto del contenedor a través del proxy de trabajos sin autenticación. Repita la bandera para varios puertos. No es necesario pasar también el puerto con `--expose`.
* `--ssh`: Hace que el contenedor del trabajo sea accesible mediante SSH. Conéctese con `hf jobs ssh <job_id>`. Requiere una clave pública SSH registrada en https://huggingface.co/settings/keys.
* `--network-group TEXT`: Unirse a un grupo de red. Los trabajos en el mismo namespace y grupo de recursos que comparten un grupo se colocan juntos y se comunican entre sí en todos los puertos. Dentro de cada miembro, `$HF_NETWORK_GROUP_HOSTNAME` se resuelve a todos los miembros. Alfanuméricos en minúsculas y guiones, máximo 46 caracteres.
* `--network-alias TEXT`: Reclama un alias en el grupo de red. Los miembros acceden a los trabajos que lo reclaman en `${HF_NETWORK_GROUP_PREFIX}<alias>`. Repite la bandera para varios alias. Alfanuméricos en minúsculas y guiones, máximo 34 caracteres, único dentro del trabajo. Requiere `--network-group`.
* `--resource-group-id TEXT`: El ID del grupo de recursos en el que se creará el Job. Se utiliza para controlar el acceso a los recursos dentro de una organización y para las funciones de atribución de costos y límites de gasto.
* `--namespace TEXT`: El espacio de nombres donde se ejecutará el trabajo. Por defecto, se utiliza el espacio de nombres del usuario actual.
* `--token TEXT`: un User Access Token generado desde https://huggingface.co/settings/tokens.
* `--with TEXT`: Ejecutar con los paquetes indicados instalados
* `-p, --python TEXT`: El intérprete de Python que se usará para el entorno de ejecución
* `--format [agent|auto|human|json|quiet]`: Formato de salida. El valor predeterminado es 'auto', que elige 'agent' o 'human' en función de la terminal.
* `--json`: salida en JSON. Equivalente a '--format json'.
* `-q, --quiet`: Salida silenciosa (un ID por línea). Equivalente a '--format quiet'.
* `--help`: Muestra este mensaje y sale.

Ejemplos $ 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

Más información Utilice `hf <command> --help` para obtener más información sobre un comando. Lea la documentación en https://huggingface.co/docs/huggingface_hub/en/guides/cli

### `hf jobs wait`

Esperar a que uno o más Jobs alcancen un estado terminal.

Bloquea hasta que todos los Jobs hayan finalizado y luego sale con código 0 si todos los Jobs se completaron con éxito, o con un código de salida no cero si algún Job fue cancelado, produjo un error o fue eliminado.

Todos los Jobs deben pertenecer al mismo namespace.

**Uso**:

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

**Argumentos**:

* `JOB_IDS...`: IDs de trabajos para esperar (o 'namespace/job_id'). [obligatorio]

**Opciones**:

* `--timeout TEXT`: Tiempo máximo de espera: int con s (segundos, predeterminado), m (minutos), h (horas) o d (días).
* `--namespace TEXT`: El espacio de nombres donde se ejecutará el trabajo. Por defecto, se utiliza el espacio de nombres del usuario actual.
* `--token TEXT`: un User Access Token generado desde https://huggingface.co/settings/tokens.
* `--help`: Muestra este mensaje y sale.

Ejemplos $ hf jobs wait $ hf jobs wait $ hf jobs ls -q | xargs hf jobs wait

Más información Utilice `hf <command> --help` para obtener más información sobre un comando. Lea la documentación en https://huggingface.co/docs/huggingface_hub/en/guides/cli

## `hf lfs-enable-largefiles`

Configura tu repositorio para habilitar la carga de archivos > 5GB.

Este comando configura git-lfs para usar el agente de transferencia multipart personalizada, lo que permite la carga eficiente de archivos grandes en fragmentos.

**Uso**:

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

**Argumentos**:

* `PATH`: Ruta local al repositorio que desea configurar. [obligatorio]

**Opciones**:

* `--help`: Muestra este mensaje y sale.

## `hf lfs-multipart-upload`

Agente de transferencia personalizado de git-lfs interno para cargas multipartes.

Esta función implementa el protocolo de transferencia personalizado para las cargas multipartes de git-lfs. Gestiona las cargas por fragmentos de archivos grandes en Hugging Face Hub.

**Uso**:

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

**Opciones**:

* `--help`: Muestra este mensaje y sale.

## `hf models`

Interactúa con los modelos en el Hub.

**Uso**:

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

**Opciones**:

* `--help`: Muestra este mensaje y sale.

**Comandos**:

* `card`: Obtiene la tarjeta del modelo (README) de un modelo en el Hub.
* `info`: Obtiene información sobre un modelo en el Hub.
* `list`: Lista modelos en el Hub o archivos en un repositorio de modelos. [alias: ls]

### `hf models card`

Obtén la tarjeta del modelo (README) de un modelo en el Hub.

**Uso**:

```console
$ hf models card [OPTIONS] MODEL_ID
```

**Argumentos**:

* `MODEL_ID`: El ID del modelo (p. ej. `username/repo-name`). [obligatorio]

**Opciones**:

* `--metadata`: Solo muestra los metadatos de la tarjeta.
* `--text`: Solo muestra el cuerpo del texto (sin metadatos).
* `--token TEXT`: un User Access Token generado desde https://huggingface.co/settings/tokens.
* `--help`: Muestra este mensaje y sale.

Ejemplos $ 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

Más información Utilice `hf <command> --help` para obtener más información sobre un comando. Lea la documentación en https://huggingface.co/docs/huggingface_hub/en/guides/cli

### `hf models info`

Obtén información sobre un modelo en el Hub.

**Uso**:

```console
$ hf models info [OPTIONS] MODEL_ID
```

**Argumentos**:

* `MODEL_ID`: El ID del modelo (p. ej. `username/repo-name`). [obligatorio]

**Opciones**:

* `--revision TEXT`: id de la revisión de Git, que puede ser un nombre de rama, una etiqueta o un hash de commit.
* `--expand TEXT`: Propiedades separadas por comas que se devolverán. Cuando se usa, solo se devuelven las propiedades enumeradas (y id). Ejemplo: '--expand=downloads,likes,tags'. Válido: 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`: un User Access Token generado desde https://huggingface.co/settings/tokens.
* `--help`: Muestra este mensaje y sale.

Ejemplos $ hf models info meta-llama/Llama-3.2-1B-Instruct $ hf models info Qwen/Qwen3.5-9B --expand downloads,likes,tags

Más información Utilice `hf <command> --help` para obtener más información sobre un comando. Lea la documentación en https://huggingface.co/docs/huggingface_hub/en/guides/cli

### `hf models list`

Listar modelos en el Hub, o archivos en un repositorio de modelos. [alias: ls]

Cuando se llama sin argumentos, lista los modelos en el Hub. Cuando se llama con un ID de modelo, lista los archivos en ese repositorio de modelo.

**Uso**:

```console
$ hf models list [OPTIONS] [REPO_ID]
```

**Argumentos**:

* `[REPO_ID]`: ID del modelo (p. ej. `username/repo-name`) del que se listarán los archivos. Si se omite, se listan los modelos.

**Opciones**:

* `--search TEXT`: Consulta de búsqueda.
* `--author TEXT`: Filtrar por autor u organización.
* `--filter TEXT`: Filtrar por etiquetas (p. ej., 'text-classification'). Se puede usar varias veces.
* `--pipeline-tag TEXT`: Filtrar por etiqueta de pipeline (tarea canónica), p. ej. 'summarization'.
* `--gated / --no-gated`: Filtrar por estado de acceso restringido. '--gated' para solo modelos con acceso restringido, '--no-gated' para solo modelos sin acceso restringido.
* `--apps TEXT`: Filtrar por la o las aplicaciones que pueden ejecutar el modelo, p. ej. 'ollama' o 'vllm'.
* `--num-parameters TEXT`: Filtrar por número de parámetros, p. ej. '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]`: Filtrar por proveedor(es) de inferencia que sirven el modelo, p. ej. 'fireworks-ai'.
* `--warm`: Solo lista los modelos que actualmente están servidos por al menos un proveedor de inferencia.
* `--sort [created_at|downloads|last_modified|likes|trending_score]`: Ordena los resultados.
* `--limit INTEGER`: Limita el número de resultados. [predeterminado: 30]
* `--expand TEXT`: Propiedades separadas por comas que se devolverán. Cuando se usa, solo se devuelven las propiedades enumeradas (y id). Ejemplo: '--expand=downloads,likes,tags'. Válido: 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`: Muestra los tamaños en un formato legible por humanos (solo para listar archivos).
* `--tree`: Lista los archivos en formato de árbol (solo para listar archivos).
* `-R, --recursive`: Lista los archivos de forma recursiva (solo para listar archivos).
* `--revision TEXT`: id de la revisión de Git, que puede ser un nombre de rama, una etiqueta o un hash de commit.
* `--token TEXT`: un User Access Token generado desde https://huggingface.co/settings/tokens.
* `--help`: Muestra este mensaje y sale.

Ejemplos $ 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

Más información Utilice `hf <command> --help` para obtener más información sobre un comando. Lea la documentación en https://huggingface.co/docs/huggingface_hub/en/guides/cli

## `hf papers`

Interact con los artículos en el Hub.

**Uso**:

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

**Opciones**:

* `--help`: Muestra este mensaje y sale.

**Comandos**:

* `info`: Obtiene información sobre un paper en el Hub.
* `list`: Lista los papeles diarios en el Hub. [alias: ls]
* `read`: Lee un artículo en formato markdown.
* `search`: Buscar papers en el Hub.

### `hf papers info`

Obtén información sobre un artículo en el Hub.

**Uso**:

```console
$ hf papers info [OPTIONS] PAPER_ID
```

**Argumentos**:

* `PAPER_ID`: El ID del artículo de arXiv (p. ej. '2502.08025'). [obligatorio]

**Opciones**:

* `--token TEXT`: un User Access Token generado desde https://huggingface.co/settings/tokens.
* `--help`: Muestra este mensaje y sale.

Ejemplos $ hf papers info 2601.15621

Más información Utilice `hf <command> --help` para obtener más información sobre un comando. Lea la documentación en https://huggingface.co/docs/huggingface_hub/en/guides/cli

### `hf papers list`

Lista los papeles diarios en el Hub. [alias: ls]

**Uso**:

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

**Opciones**:

* `--date TEXT`: Fecha en formato ISO (YYYY-MM-DD) o 'today'.
* `--week TEXT`: semana ISO para filtrar, p. ej. '2025-W09'.
* `--month TEXT`: Mes para filtrar en formato ISO (AAAA-MM), p. ej. '2025-02'.
* `--submitter TEXT`: Filtrar por el nombre de usuario del remitente.
* `--sort [publishedAt|trending]`: Ordena los resultados.
* `--limit INTEGER`: Limita el número de resultados. [predeterminado: 50]
* `--token TEXT`: un User Access Token generado desde https://huggingface.co/settings/tokens.
* `--help`: Muestra este mensaje y sale.

Ejemplos $ 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

Más información Utilice `hf <command> --help` para obtener más información sobre un comando. Lea la documentación en https://huggingface.co/docs/huggingface_hub/en/guides/cli

### `hf papers read`

Lee un artículo en formato markdown.

**Uso**:

```console
$ hf papers read [OPTIONS] PAPER_ID
```

**Argumentos**:

* `PAPER_ID`: El ID del artículo de arXiv (p. ej. '2502.08025'). [obligatorio]

**Opciones**:

* `--token TEXT`: un User Access Token generado desde https://huggingface.co/settings/tokens.
* `--help`: Muestra este mensaje y sale.

Ejemplos $ hf papers read 2601.15621

Más información Utilice `hf <command> --help` para obtener más información sobre un comando. Lea la documentación en https://huggingface.co/docs/huggingface_hub/en/guides/cli

### `hf papers search`

Busca papers en el Hub.

**Uso**:

```console
$ hf papers search [OPTIONS] QUERY
```

**Argumentos**:

* `QUERY`: Cadena de texto de la consulta de búsqueda. [obligatorio]

**Opciones**:

* `--limit INTEGER`: Limita el número de resultados. [predeterminado: 20]
* `--token TEXT`: un User Access Token generado desde https://huggingface.co/settings/tokens.
* `--help`: Muestra este mensaje y sale.

Ejemplos $ hf papers search "vision language" $ hf papers search "attention mechanism" --limit 10 $ hf papers search "diffusion" --format json

Más información Utilice `hf <command> --help` para obtener más información sobre un comando. Lea la documentación en https://huggingface.co/docs/huggingface_hub/en/guides/cli

## `hf repos`

Gestiona repositorios en el Hub.

**Uso**:

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

**Opciones**:

* `--help`: Muestra este mensaje y sale.

**Comandos**:

* `branch`: Gestiona las ramas de un repositorio en el Hub.
* `cp`: Copia archivos entre rutas locales, repositorios y cubos.
* `create`: Crea un nuevo repositorio en el Hub.
* `delete`: Elimina un repositorio del Hub.
* `delete-files`: Elimina archivos de un repositorio en el Hub.
* `duplicate`: Duplica un repositorio en el Hub (modelo, conjunto de datos o Space).
* `list`: Lista todos los repositorios (modelos, conjuntos de datos, espacios, cubos) con información de almacenamiento. [alias: ls]
* `move`: Mover un repositorio de un espacio de nombres a otro.
* `settings`: Actualiza la configuración de un repositorio.
* `tag`: Gestionar las etiquetas de un repositorio en el Hub.

### `hf repos branch`

Gestiona las ramas de un repositorio en el Hub.

**Uso**:

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

**Opciones**:

* `--help`: Muestra este mensaje y sale.

**Comandos**:

* `create`: Crea una nueva rama para un repositorio en el Hub.
* `delete`: Elimina una rama de un repositorio en el Hub.

#### `hf repos branch create`

Crea una nueva rama para un repositorio en el Hub.

**Uso**:

```console
$ hf repos branch create [OPTIONS] REPO_ID BRANCH
```

**Argumentos**:

* `REPO_ID`: El ID del repositorio (p. ej. `username/repo-name` o `spaces/username/repo-name`). [obligatorio]
* `BRANCH`: El nombre de la rama a crear. [obligatorio]

**Opciones**:

* `--revision TEXT`: id de la revisión de Git, que puede ser un nombre de rama, una etiqueta o un hash de commit.
* `--token TEXT`: un User Access Token generado desde https://huggingface.co/settings/tokens.
* `--type, --repo-type [model|dataset|space|kernel]`: El tipo de repositorio (model, dataset, space o kernel). [predeterminado: model]
* `--exist-ok / --no-exist-ok`: Si se establece en True, no se lanzará un error si la rama ya existe. [predeterminado: no-exist-ok]
* `--help`: Muestra este mensaje y sale.

Ejemplos $ hf repos branch create my-model dev $ hf repos branch create my-model dev --revision abc123

Más información Utilice `hf <command> --help` para obtener más información sobre un comando. Lea la documentación en https://huggingface.co/docs/huggingface_hub/en/guides/cli

#### `hf repos branch delete`

Eliminar una rama de un repositorio en el Hub.

**Uso**:

```console
$ hf repos branch delete [OPTIONS] REPO_ID BRANCH
```

**Argumentos**:

* `REPO_ID`: El ID del repositorio (p. ej. `username/repo-name` o `spaces/username/repo-name`). [obligatorio]
* `BRANCH`: El nombre de la rama a eliminar. [obligatorio]

**Opciones**:

* `--token TEXT`: un User Access Token generado desde https://huggingface.co/settings/tokens.
* `--type, --repo-type [model|dataset|space|kernel]`: El tipo de repositorio (model, dataset, space o kernel). [predeterminado: model]
* `--help`: Muestra este mensaje y sale.

Ejemplos $ hf repos branch delete my-model dev

Más información Utilice `hf <command> --help` para obtener más información sobre un comando. Lea la documentación en https://huggingface.co/docs/huggingface_hub/en/guides/cli

### `hf repos cp`

Copiar archivos entre rutas locales, repositorios y cubos.

Gestiona las cargas (local/stdin -> repo/bucket), las descargas (repo/bucket -> local/stdout) y las copias remotas (repo/bucket -> repo/bucket). No se admiten las copias de bucket a repo ni las copias locales. Para directorios, use `hf upload`/`hf download` (repos) o `hf buckets sync` (buckets). Las copias remotas solo funcionan dentro de la misma región de almacenamiento (https://huggingface.co/docs/hub/storage-regions).

**Uso**:

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

**Argumentos**:

* `SRC`: Origen: archivo local, URI hf:// (repositorio o bucket) o - para stdin. [obligatorio]
* `[DST]`: Destino: ruta local, URI hf:// (repositorio o bucket) o - para stdout.

**Opciones**:

* `--token TEXT`: un User Access Token generado desde https://huggingface.co/settings/tokens.
* `--help`: Muestra este mensaje y sale.

Ejemplos $ 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/

Más información Utilice `hf <command> --help` para obtener más información sobre un comando. Lea la documentación en https://huggingface.co/docs/huggingface_hub/en/guides/cli

### `hf repos create`

Crea un nuevo repositorio en el Hub.

**Uso**:

```console
$ hf repos create [OPTIONS] REPO_ID
```

**Argumentos**:

* `REPO_ID`: El ID del repositorio (p. ej. `username/repo-name` o `spaces/username/repo-name`). [obligatorio]

**Opciones**:

* `--type, --repo-type [model|dataset|space|kernel]`: El tipo de repositorio (model, dataset, space o kernel). [predeterminado: model]
* `--sdk, --space-sdk TEXT`: tipo de SDK de Hugging Face Spaces. Obligatorio cuando --type se establece en 'space'.
* `--template TEXT`: Crea un Space a partir de una plantilla oficial. Pasa un id de repositorio de plantilla (p. ej. 'SpacesExamples/jupyterlab') o su nombre corto (p. ej. 'JupyterLab'). Lista las plantillas disponibles con `hf spaces templates`. Solo Spaces.
* `--private / --no-private`: Si se debe crear un repositorio privado si el repositorio no existe en el Hub. Se ignora si el repositorio ya existe.
* `--public`: Si se debe hacer público el repositorio. Se ignora si el repositorio ya existe.
* `--protected`: Si se debe proteger el Space (solo Spaces). Se ignora si el repositorio ya existe.
* `--token TEXT`: un User Access Token generado desde https://huggingface.co/settings/tokens.
* `--exist-ok / --no-exist-ok`: No genera un error si el repositorio ya existe. [predeterminado: no-exist-ok]
* `--resource-group-id TEXT`: Grupo de recursos en el que se creará el repositorio. Los grupos de recursos solo están disponibles para organizaciones de Enterprise Hub.
* `--region [us|eu]`: Región de la nube en la que se creará el repositorio. Puede ser 'us' o 'eu'. Requiere un plan Team o superior.
* `--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]`: Sabor de hardware del Space (p. ej., 'cpu-basic', 't4-medium', 'l4x4'). Solo para Spaces.
* `--sleep-time INTEGER`: Segundos de inactividad antes de que el Space se ponga en suspensión. Use -1 para desactivarlo. Solo para Spaces.
* `-s, --secrets TEXT`: Establece variables de entorno secretas. Prefiere `--secrets SECRET` para leer el valor desde tu entorno (p. ej. `--secrets HF_TOKEN` para pasar tu token de Hugging Face); `--secrets SECRET=value` deja el valor en el historial de tu shell.
* `--secrets-file TEXT`: Lee un archivo de variables de entorno secretas. Usa `-` para leerlas desde stdin.
* `-e, --env TEXT`: Establece variables de entorno. Por ejemplo, --env ENV=value
* `--env-file TEXT`: Lee un archivo de variables de entorno. Usa `-` para leerlas desde stdin.
* `-v, --volume TEXT`: Monta uno o más volúmenes. Formato: hf://[TYPE/]SOURCE:/MOUNT_PATH[:ro]. TYPE es uno de: models, datasets, spaces, buckets. Si se omite TYPE, el valor predeterminado es models. models, datasets y spaces siempre se montan solo de lectura. buckets se montan con lectura y escritura de forma predeterminada. Por ejemplo, -v hf://org/m:/data o -v hf://datasets/org/ds:/data o -v hf://buckets/org/b:/mnt:ro
* `--help`: Muestra este mensaje y sale.

Ejemplos $ 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

Más información Utilice `hf <command> --help` para obtener más información sobre un comando. Lea la documentación en https://huggingface.co/docs/huggingface_hub/en/guides/cli

### `hf repos delete`

Eliminar un repositorio del Hub. Esta es una operación irreversible.

**Uso**:

```console
$ hf repos delete [OPTIONS] REPO_ID
```

**Argumentos**:

* `REPO_ID`: El ID del repositorio (p. ej. `username/repo-name` o `spaces/username/repo-name`). [obligatorio]

**Opciones**:

* `--type, --repo-type [model|dataset|space|kernel]`: El tipo de repositorio (model, dataset, space o kernel). [predeterminado: model]
* `--token TEXT`: un User Access Token generado desde https://huggingface.co/settings/tokens.
* `--missing-ok / --no-missing-ok`: Si se establece en True, no se generará un error si el repositorio no existe. [predeterminado: no-missing-ok]
* `-y, --yes`: Responde automáticamente Sí al prompt.
* `--help`: Muestra este mensaje y sale.

Ejemplos $ hf repos delete my-model

Más información Utilice `hf <command> --help` para obtener más información sobre un comando. Lea la documentación en https://huggingface.co/docs/huggingface_hub/en/guides/cli

### `hf repos delete-files`

Eliminar archivos de un repositorio en el Hub.

**Uso**:

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

**Argumentos**:

* `REPO_ID`: El ID del repositorio (p. ej. `username/repo-name` o `spaces/username/repo-name`). [obligatorio]
* `PATTERNS...`: Patrones globales para coincidir con los archivos a eliminar. Basado en fnmatch, '*' coincide con archivos de forma recursiva. [obligatorio]

**Opciones**:

* `--type, --repo-type [model|dataset|space|kernel]`: El tipo de repositorio (model, dataset, space o kernel). [predeterminado: model]
* `--revision TEXT`: id de la revisión de Git, que puede ser un nombre de rama, una etiqueta o un hash de commit.
* `--commit-message TEXT`: El resumen / título / primera línea del commit generado.
* `--commit-description TEXT`: La descripción del commit generado.
* `--create-pr / --no-create-pr`: Si se debe crear una nueva Pull Request para estos cambios. [predeterminado: no-create-pr]
* `--token TEXT`: un User Access Token generado desde https://huggingface.co/settings/tokens.
* `--help`: Muestra este mensaje y sale.

Ejemplos $ hf repos delete-files my-model file.txt $ hf repos delete-files my-model "*.json" $ hf repos delete-files my-model folder/

Más información Utilice `hf <command> --help` para obtener más información sobre un comando. Lea la documentación en https://huggingface.co/docs/huggingface_hub/en/guides/cli

### `hf repos duplicate`

Duplicar un repositorio en el Hub (modelo, conjunto de datos o Space).

**Uso**:

```console
$ hf repos duplicate [OPTIONS] FROM_ID [TO_ID]
```

**Argumentos**:

* `FROM_ID`: El ID del repositorio (p. ej. `username/repo-name` o `spaces/username/repo-name`). [obligatorio]
* `[TO_ID]`: ID del repositorio de destino (p. ej., `myorg/my-copy`). Por defecto, se usa tu espacio de nombres con el mismo nombre de repositorio.

**Opciones**:

* `--type, --repo-type [model|dataset|space|kernel]`: El tipo de repositorio (model, dataset, space o kernel). [predeterminado: model]
* `--private / --no-private`: Si se debe crear un repositorio privado si el repositorio no existe en el Hub. Se ignora si el repositorio ya existe.
* `--public`: Si se debe hacer público el repositorio. Se ignora si el repositorio ya existe.
* `--protected`: Si se debe proteger el Space (solo Spaces). Se ignora si el repositorio ya existe.
* `--token TEXT`: un User Access Token generado desde https://huggingface.co/settings/tokens.
* `--exist-ok / --no-exist-ok`: No genera un error si el repositorio ya existe. [predeterminado: no-exist-ok]
* `--resource-group-id TEXT`: Grupo de recursos en el que se creará el nuevo repositorio. Los grupos de recursos solo están disponibles para organizaciones de 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]`: Sabor de hardware del Space (p. ej., 'cpu-basic', 't4-medium', 'l4x4'). Solo para Spaces.
* `--sleep-time INTEGER`: Segundos de inactividad antes de que el Space se ponga en suspensión. Use -1 para desactivarlo. Solo para Spaces.
* `-s, --secrets TEXT`: Establece variables de entorno secretas. Prefiere `--secrets SECRET` para leer el valor desde tu entorno (p. ej. `--secrets HF_TOKEN` para pasar tu token de Hugging Face); `--secrets SECRET=value` deja el valor en el historial de tu shell.
* `--secrets-file TEXT`: Lee un archivo de variables de entorno secretas. Usa `-` para leerlas desde stdin.
* `-e, --env TEXT`: Establece variables de entorno. Por ejemplo, --env ENV=value
* `--env-file TEXT`: Lee un archivo de variables de entorno. Usa `-` para leerlas desde stdin.
* `-v, --volume TEXT`: Monta uno o más volúmenes. Formato: hf://[TYPE/]SOURCE:/MOUNT_PATH[:ro]. TYPE es uno de: models, datasets, spaces, buckets. Si se omite TYPE, el valor predeterminado es models. models, datasets y spaces siempre se montan solo de lectura. buckets se montan con lectura y escritura de forma predeterminada. Por ejemplo, -v hf://org/m:/data o -v hf://datasets/org/ds:/data o -v hf://buckets/org/b:/mnt:ro
* `--help`: Muestra este mensaje y sale.

Ejemplos $ 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

Más información Utilice `hf <command> --help` para obtener más información sobre un comando. Lea la documentación en https://huggingface.co/docs/huggingface_hub/en/guides/cli

### `hf repos list`

Listar todos los repositorios (modelos, conjuntos de datos, espacios, cubos) con información de almacenamiento. [alias: ls]

**Uso**:

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

**Opciones**:

* `--namespace TEXT`: Nombre de la organización. Si no se proporciona, lista los repositorios del usuario autenticado.
* `--type, --repo-type [model|dataset|space|bucket]`: Filtra por tipo de repositorio (model, dataset, space o bucket).
* `--search TEXT`: Consulta de búsqueda.
* `--limit INTEGER`: Limita el número de resultados. [predeterminado: 30]
* `--explore`: Explora tus repositorios como una ciudad 3D interactiva.
* `--token TEXT`: un User Access Token generado desde https://huggingface.co/settings/tokens.
* `--help`: Muestra este mensaje y sale.

Ejemplos $ hf repos ls $ hf repos ls --explore $ hf repos ls --namespace my-org --search bert

Más información Utilice `hf <command> --help` para obtener más información sobre un comando. Lea la documentación en https://huggingface.co/docs/huggingface_hub/en/guides/cli

### `hf repos move`

Mover un repositorio de un espacio de nombres a otro.

**Uso**:

```console
$ hf repos move [OPTIONS] FROM_ID TO_ID
```

**Argumentos**:

* `FROM_ID`: El ID del repositorio (p. ej. `username/repo-name` o `spaces/username/repo-name`). [obligatorio]
* `TO_ID`: El ID del repositorio (p. ej. `username/repo-name` o `spaces/username/repo-name`). [obligatorio]

**Opciones**:

* `--token TEXT`: un User Access Token generado desde https://huggingface.co/settings/tokens.
* `--type, --repo-type [model|dataset|space|kernel]`: El tipo de repositorio (model, dataset, space o kernel). [predeterminado: model]
* `--help`: Muestra este mensaje y sale.

Ejemplos $ hf repos move old-namespace/my-model new-namespace/my-model

Más información Utilice `hf <command> --help` para obtener más información sobre un comando. Lea la documentación en https://huggingface.co/docs/huggingface_hub/en/guides/cli

### `hf repos settings`

Actualice la configuración de un repositorio.

**Uso**:

```console
$ hf repos settings [OPTIONS] REPO_ID
```

**Argumentos**:

* `REPO_ID`: El ID del repositorio (p. ej. `username/repo-name` o `spaces/username/repo-name`). [obligatorio]

**Opciones**:

* `--gated [auto|manual|false]`: El estado de acceso restringido del repositorio.
* `--private / --no-private`: Si se debe crear un repositorio privado si el repositorio no existe en el Hub. Se ignora si el repositorio ya existe.
* `--public`: Si se debe hacer público el repositorio. Se ignora si el repositorio ya existe.
* `--protected`: Si se debe proteger el Space (solo Spaces). Se ignora si el repositorio ya existe.
* `--token TEXT`: un User Access Token generado desde https://huggingface.co/settings/tokens.
* `--type, --repo-type [model|dataset|space|kernel]`: El tipo de repositorio (model, dataset, space o kernel). [predeterminado: model]
* `--help`: Muestra este mensaje y sale.

Ejemplos $ hf repos settings my-model --private $ hf repos settings my-model --gated auto $ hf repos settings my-space --repo-type space --protected

Más información Utilice `hf <command> --help` para obtener más información sobre un comando. Lea la documentación en https://huggingface.co/docs/huggingface_hub/en/guides/cli

### `hf repos tag`

Gestiona las etiquetas de un repositorio en el Hub.

**Uso**:

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

**Opciones**:

* `--help`: Muestra este mensaje y sale.

**Comandos**:

* `create`: Crea una etiqueta para un repositorio.
* `delete`: Elimina una etiqueta de un repositorio.
* `list`: Lista las etiquetas de un repositorio. [alias: ls]

#### `hf repos tag create`

Crea una etiqueta para un repositorio.

**Uso**:

```console
$ hf repos tag create [OPTIONS] REPO_ID TAG
```

**Argumentos**:

* `REPO_ID`: El ID del repositorio (p. ej. `username/repo-name` o `spaces/username/repo-name`). [obligatorio]
* `TAG`: El nombre de la etiqueta a crear. [obligatorio]

**Opciones**:

* `-m, --message TEXT`: La descripción de la etiqueta a crear.
* `--revision TEXT`: id de la revisión de Git, que puede ser un nombre de rama, una etiqueta o un hash de commit.
* `--token TEXT`: un User Access Token generado desde https://huggingface.co/settings/tokens.
* `--type, --repo-type [model|dataset|space|kernel]`: El tipo de repositorio (model, dataset, space o kernel). [predeterminado: model]
* `--help`: Muestra este mensaje y sale.

Ejemplos $ hf repos tag create my-model v1.0 $ hf repos tag create my-model v1.0 -m "First release"

Más información Utilice `hf <command> --help` para obtener más información sobre un comando. Lea la documentación en https://huggingface.co/docs/huggingface_hub/en/guides/cli

#### `hf repos tag delete`

Eliminar una etiqueta de un repositorio.

**Uso**:

```console
$ hf repos tag delete [OPTIONS] REPO_ID TAG
```

**Argumentos**:

* `REPO_ID`: El ID del repositorio (p. ej. `username/repo-name` o `spaces/username/repo-name`). [obligatorio]
* `TAG`: El nombre de la etiqueta a eliminar. [obligatorio]

**Opciones**:

* `-y, --yes`: Responde Sí automáticamente al prompt
* `--token TEXT`: un User Access Token generado desde https://huggingface.co/settings/tokens.
* `--type, --repo-type [model|dataset|space|kernel]`: El tipo de repositorio (model, dataset, space o kernel). [predeterminado: model]
* `--help`: Muestra este mensaje y sale.

Ejemplos $ hf repos tag delete my-model v1.0

Más información Utilice `hf <command> --help` para obtener más información sobre un comando. Lea la documentación en https://huggingface.co/docs/huggingface_hub/en/guides/cli

#### `hf repos tag list`

Listar las etiquetas de un repositorio. [alias: ls]

**Uso**:

```console
$ hf repos tag list [OPTIONS] REPO_ID
```

**Argumentos**:

* `REPO_ID`: El ID del repositorio (p. ej. `username/repo-name` o `spaces/username/repo-name`). [obligatorio]

**Opciones**:

* `--token TEXT`: un User Access Token generado desde https://huggingface.co/settings/tokens.
* `--type, --repo-type [model|dataset|space|kernel]`: El tipo de repositorio (model, dataset, space o kernel). [predeterminado: model]
* `--help`: Muestra este mensaje y sale.

Ejemplos $ hf repos tag list my-model

Más información Utilice `hf <command> --help` para obtener más información sobre un comando. Lea la documentación en https://huggingface.co/docs/huggingface_hub/en/guides/cli

## `hf sandbox`

Ejecuta y gestiona sandboxes experimentales en Hugging Face Jobs.

**Uso**:

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

**Opciones**:

* `--help`: Muestra este mensaje y sale.

**Comandos**:

* `cp`: Copia un archivo entre la máquina local y un sandbox (estilo docker).
* `create`: Crea un sandbox: una VM dedicada por defecto, o una compartida de bajo coste con `--pool`.
* `exec`: Ejecuta un comando en un entorno aislado, transmitiendo la salida.
* `kill`: Termina un sandbox, un host compartido completo o todo (--all).
* `pool`: Pools de VMs de host calientes y creación de sandbox compartidos experimentales para cargas de trabajo dentro del mismo límite de confianza.
* `process`: Lista y detiene los procesos en segundo plano que se ejecutan en un sandbox.
* `spawn`: Inicia un comando de larga duración en segundo plano y devuelve su pid (sin esperar).

### `hf sandbox cp`

Copiar un archivo entre la máquina local y un sandbox (estilo docker).

**Uso**:

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

**Argumentos**:

* `SRC`: Origen: una ruta local o :.  [obligatorio]
* `DST`: Destino: una ruta local o :. [obligatorio]

**Opciones**:

* `--namespace TEXT`: El espacio de nombres donde se ejecutará el trabajo. Por defecto, se utiliza el espacio de nombres del usuario actual.
* `--token TEXT`: un User Access Token generado desde https://huggingface.co/settings/tokens.
* `--help`: Muestra este mensaje y sale.

Ejemplos $ hf sandbox cp data.csv :/data/data.csv $ hf sandbox cp :/app/result.json result.json

Más información Utilice `hf <command> --help` para obtener más información sobre un comando. Lea la documentación en https://huggingface.co/docs/huggingface_hub/en/guides/cli

### `hf sandbox create`

Cree un sandbox: una VM dedicada por defecto, o una compartida de bajo coste con `--pool`.

Env e idle-timeout se aplican al sandbox en ambos modos. Con `--pool`, la imagen y el flavor provienen del pool, por lo que pasarlos aquí es un error; `--secrets` también se rechaza, ya que los sandboxes del pool no tienen un canal de secretos cifrados (use `--env`). Defina primero un pool con `hf sandbox pool create`.

**Uso**:

```console
$ hf sandbox create [OPTIONS] [IMAGE]
```

**Argumentos**:

* `[IMAGE]`: imagen de Docker (requiere /bin/sh).

**Opciones**:

* `--pool TEXT`: Genera un sandbox compartido económico en este pool (desde `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]`: Flavor para el hardware. Ejecuta 'hf jobs hardware' para listar los flavors disponibles. El valor predeterminado es `cpu-basic`.
* `--idle-timeout TEXT`: Termina automáticamente el sandbox después de este tiempo de inactividad (p. ej., '10m'). El valor predeterminado es 10m.
* `-e, --env TEXT`: Establece variables de entorno. Por ejemplo, --env ENV=value
* `-s, --secrets TEXT`: Establece variables de entorno secretas. Prefiere `--secrets SECRET` para leer el valor desde tu entorno (p. ej. `--secrets HF_TOKEN` para pasar tu token de Hugging Face); `--secrets SECRET=value` deja el valor en el historial de tu shell.
* `-l, --label TEXT`: Establece etiquetas. Por ejemplo, --label KEY=VALUE o --label LABEL
* `--env-file TEXT`: Lee un archivo de variables de entorno. Usa `-` para leerlas desde stdin.
* `--secrets-file TEXT`: Lee un archivo de variables de entorno secretas. Usa `-` para leerlas desde stdin.
* `-v, --volume TEXT`: Monta uno o más volúmenes. Formato: hf://[TYPE/]SOURCE:/MOUNT_PATH[:ro]. TYPE es uno de: models, datasets, spaces, buckets. Si se omite TYPE, el valor predeterminado es models. models, datasets y spaces siempre se montan solo de lectura. buckets se montan con lectura y escritura de forma predeterminada. Por ejemplo, -v hf://org/m:/data o -v hf://datasets/org/ds:/data o -v hf://buckets/org/b:/mnt:ro
* `--namespace TEXT`: El espacio de nombres donde se ejecutará el trabajo. Por defecto, se utiliza el espacio de nombres del usuario actual.
* `--forward-hf-token`: Inyecta tu token de HF como HF_TOKEN en el sandbox.
* `--token TEXT`: un User Access Token generado desde https://huggingface.co/settings/tokens.
* `--help`: Muestra este mensaje y sale.

Ejemplos $ 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

Más información Utilice `hf <command> --help` para obtener más información sobre un comando. Lea la documentación en https://huggingface.co/docs/huggingface_hub/en/guides/cli

### `hf sandbox exec`

Ejecuta un comando en un sandbox, transmitiendo la salida. Sale con el código de salida del comando.

Para iniciar un comando de larga duración en segundo plano en lugar de esperar a que termine, use `hf sandbox spawn`.

**Uso**:

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

**Argumentos**:

* `SANDBOX_ID`: El id del sandbox tal como lo imprime `hf sandbox create`. [obligatorio]
* `COMMAND...`: El comando a ejecutar. [obligatorio]

**Opciones**:

* `-w, --workdir TEXT`: Directorio de trabajo.
* `-e, --env TEXT`: Establece variables de entorno. Por ejemplo, --env ENV=value
* `--env-file TEXT`: Lee un archivo de variables de entorno. Usa `-` para leerlas desde stdin.
* `--timeout FLOAT`: Termina el comando después de este número de segundos.
* `--namespace TEXT`: El espacio de nombres donde se ejecutará el trabajo. Por defecto, se utiliza el espacio de nombres del usuario actual.
* `--token TEXT`: un User Access Token generado desde https://huggingface.co/settings/tokens.
* `--help`: Muestra este mensaje y sale.

Ejemplos $ hf sandbox exec  -- python -c "print(42)" $ hf sandbox exec -w /app  -- pytest -x

Más información Utilice `hf <command> --help` para obtener más información sobre un comando. Lea la documentación en https://huggingface.co/docs/huggingface_hub/en/guides/cli

### `hf sandbox kill`

Termina un sandbox, un host compartido completo o todo (--all).

**Uso**:

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

**Argumentos**:

* `[SANDBOX_ID]`: El identificador del sandbox o del host que se va a terminar.

**Opciones**:

* `--all`: Termina todos los sandbox y hosts del namespace.
* `-y, --yes`: Responde Sí automáticamente a las preguntas.
* `--namespace TEXT`: El espacio de nombres donde se ejecutará el trabajo. Por defecto, se utiliza el espacio de nombres del usuario actual.
* `--token TEXT`: un User Access Token generado desde https://huggingface.co/settings/tokens.
* `--help`: Muestra este mensaje y sale.

Ejemplos $ hf sandbox kill $ hf sandbox kill    # kills a whole shared host (all its sandboxes) $ hf sandbox kill --all

Más información Utilice `hf <command> --help` para obtener más información sobre un comando. Lea la documentación en https://huggingface.co/docs/huggingface_hub/en/guides/cli

### `hf sandbox pool`

Mantener en caliente los grupos de máquinas virtuales del host y generar sandboxes compartidos experimentales para las cargas de trabajo dentro del mismo límite de confianza.

**Uso**:

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

**Opciones**:

* `--help`: Muestra este mensaje y sale.

**Comandos**:

* `create`: Calienta un pool: inicia una VM de host ahora, etiquetada para que pueda encontrarse más tarde por su id de pool.
* `delete`: Finaliza todas las VM de host de un pool (y, por lo tanto, todos sus sandboxes). [alias: rm]
* `ls`: Lista los grupos de sandbox en ejecución (agrupados desde sus VMs anfitrionas). [alias: list]

#### `hf sandbox pool create`

Calienta un pool: inicia una VM de host ahora, etiquetada para que pueda encontrarse más tarde por su id de pool.

**Uso**:

```console
$ hf sandbox pool create [OPTIONS] [IMAGE]
```

**Argumentos**:

* `[IMAGE]`: imagen de Docker para los hosts (requiere /bin/sh).

**Opciones**:

* `--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]`: Flavor para el hardware. Ejecuta 'hf jobs hardware' para listar los flavors disponibles. El valor predeterminado es `cpu-basic`.
* `--per-host INTEGER RANGE`: Número de sandbox empaquetados por VM de host (predeterminado 50). [predeterminado: 50; x>=1]
* `--max-hosts INTEGER RANGE`: Límite opcional para el número de VMs de host. [x>=1]
* `--idle-timeout TEXT`: Apaga un host una vez que no haya tenido sandboxes durante este tiempo (p. ej., '10m'). El valor predeterminado es 10m.
* `--namespace TEXT`: El espacio de nombres donde se ejecutará el trabajo. Por defecto, se utiliza el espacio de nombres del usuario actual.
* `--token TEXT`: un User Access Token generado desde https://huggingface.co/settings/tokens.
* `--help`: Muestra este mensaje y sale.

Ejemplos $ hf sandbox pool create $ hf sandbox pool create python:3.12 --flavor cpu-basic $ hf sandbox pool create --per-host 50 --idle-timeout 30m

Más información Utilice `hf <command> --help` para obtener más información sobre un comando. Lea la documentación en https://huggingface.co/docs/huggingface_hub/en/guides/cli

#### `hf sandbox pool delete`

Termina todas las VMs de host de un pool (y, por lo tanto, todos sus sandboxes). [alias: rm]

**Uso**:

```console
$ hf sandbox pool delete [OPTIONS] POOL_ID
```

**Argumentos**:

* `POOL_ID`: id del pool a eliminar. [obligatorio]

**Opciones**:

* `-y, --yes`: Responde Sí automáticamente a las preguntas.
* `--namespace TEXT`: El espacio de nombres donde se ejecutará el trabajo. Por defecto, se utiliza el espacio de nombres del usuario actual.
* `--token TEXT`: un User Access Token generado desde https://huggingface.co/settings/tokens.
* `--help`: Muestra este mensaje y sale.

Ejemplos $ hf sandbox pool delete

Más información Utilice `hf <command> --help` para obtener más información sobre un comando. Lea la documentación en https://huggingface.co/docs/huggingface_hub/en/guides/cli

#### `hf sandbox pool ls`

Listar los grupos de sandbox en ejecución (agrupados desde sus VMs anfitrionas). [alias: list]

**Uso**:

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

**Opciones**:

* `--namespace TEXT`: El espacio de nombres donde se ejecutará el trabajo. Por defecto, se utiliza el espacio de nombres del usuario actual.
* `--token TEXT`: un User Access Token generado desde https://huggingface.co/settings/tokens.
* `--help`: Muestra este mensaje y sale.

Ejemplos $ hf sandbox pool ls

Más información Utilice `hf <command> --help` para obtener más información sobre un comando. Lea la documentación en https://huggingface.co/docs/huggingface_hub/en/guides/cli

### `hf sandbox process`

Listar y detener procesos en segundo plano que se ejecutan en un sandbox.

**Uso**:

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

**Opciones**:

* `--help`: Muestra este mensaje y sale.

**Comandos**:

* `kill`: Detener un proceso en segundo plano que se está ejecutando en un sandbox.
* `ls`: Lista los procesos en segundo plano que se están ejecutando en un sandbox (iniciados con `hf sandbox spawn`). [alias: list]

#### `hf sandbox process kill`

Detener un proceso en segundo plano que se está ejecutando en un sandbox.

**Uso**:

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

**Argumentos**:

* `SANDBOX_ID`: El id del sandbox tal como lo imprime `hf sandbox create`. [obligatorio]
* `PID`: El pid tal como lo imprime `hf sandbox process ls`. [obligatorio]

**Opciones**:

* `--namespace TEXT`: El espacio de nombres donde se ejecutará el trabajo. Por defecto, se utiliza el espacio de nombres del usuario actual.
* `--token TEXT`: un User Access Token generado desde https://huggingface.co/settings/tokens.
* `--help`: Muestra este mensaje y sale.

Ejemplos $ hf sandbox process kill

Más información Utilice `hf <command> --help` para obtener más información sobre un comando. Lea la documentación en https://huggingface.co/docs/huggingface_hub/en/guides/cli

#### `hf sandbox process ls`

Muestra los procesos en segundo plano que se están ejecutando en un sandbox (iniciados con `hf sandbox spawn`). [alias: list]

**Uso**:

```console
$ hf sandbox process ls [OPTIONS] SANDBOX_ID
```

**Argumentos**:

* `SANDBOX_ID`: El id del sandbox tal como lo imprime `hf sandbox create`. [obligatorio]

**Opciones**:

* `--namespace TEXT`: El espacio de nombres donde se ejecutará el trabajo. Por defecto, se utiliza el espacio de nombres del usuario actual.
* `--token TEXT`: un User Access Token generado desde https://huggingface.co/settings/tokens.
* `--help`: Muestra este mensaje y sale.

Ejemplos $ hf sandbox process ls

Más información Utilice `hf <command> --help` para obtener más información sobre un comando. Lea la documentación en https://huggingface.co/docs/huggingface_hub/en/guides/cli

### `hf sandbox spawn`

Inicie un comando de larga duración en segundo plano y devuelva su pid (no espere).

Liste los procesos de un sandbox con `hf sandbox process ls` y detenga uno con `hf sandbox process kill`.

**Uso**:

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

**Argumentos**:

* `SANDBOX_ID`: El id del sandbox tal como lo imprime `hf sandbox create`. [obligatorio]
* `COMMAND...`: El comando para ejecutar en segundo plano. [obligatorio]

**Opciones**:

* `-w, --workdir TEXT`: Directorio de trabajo.
* `-e, --env TEXT`: Establece variables de entorno. Por ejemplo, --env ENV=value
* `--env-file TEXT`: Lee un archivo de variables de entorno. Usa `-` para leerlas desde stdin.
* `--namespace TEXT`: El espacio de nombres donde se ejecutará el trabajo. Por defecto, se utiliza el espacio de nombres del usuario actual.
* `--token TEXT`: un User Access Token generado desde https://huggingface.co/settings/tokens.
* `--help`: Muestra este mensaje y sale.

Ejemplos $ hf sandbox spawn  -- python -m http.server 8000 $ hf sandbox spawn -w /app  -- uvicorn app:app

Más información Utilice `hf <command> --help` para obtener más información sobre un comando. Lea la documentación en https://huggingface.co/docs/huggingface_hub/en/guides/cli

## `hf skills`

Gestiona las habilidades de los asistentes de IA.

**Uso**:

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

**Opciones**:

* `--help`: Muestra este mensaje y sale.

**Comandos**:

* `add`: Instala una habilidad de Hugging Face para un asistente de IA.
* `list`: Lista las habilidades disponibles del mercado de Hugging Face. [alias: ls]
* `preview`: Imprime el archivo `hf-cli` SKILL.md generado en stdout.
* `update`: Actualiza las habilidades del mercado de Hugging Face instaladas.

### `hf skills add`

Instala una habilidad de Hugging Face para un asistente de IA.

La habilidad predeterminada `hf-cli` se genera localmente a partir de la versión del CLI instalada; las demás habilidades se descargan del mercado de Hugging Face. La ubicación predeterminada es el directorio actual (.agents/skills) o el nivel de usuario (~/.agents/skills). La habilidad también se enlaza simbólicamente en el directorio de habilidades de Claude Code (`.claude/skills` o `~/.claude/skills`, respetando `CLAUDE_CONFIG_DIR` si está definido), a menos que se utilice `--dest`.

**Uso**:

```console
$ hf skills add [OPTIONS] [NAME]
```

**Argumentos**:

* `[NAME]`: Nombre de la habilidad del Marketplace.

**Opciones**:

* `-g, --global`: Instala globalmente (a nivel de usuario) en lugar de en el directorio del proyecto actual.
* `--dest PATH`: Instala en un destino personalizado (ruta al directorio de skills).
* `--force`: Sobrescribe las habilidades existentes en el destino.
* `--help`: Muestra este mensaje y sale.

Ejemplos $ hf skills add $ hf skills add huggingface-gradio --dest=~/my-skills $ hf skills add --global $ hf skills add huggingface-gradio --global

Más información Utilice `hf <command> --help` para obtener más información sobre un comando. Lea la documentación en https://huggingface.co/docs/huggingface_hub/en/guides/cli

### `hf skills list`

Listar las habilidades disponibles del mercado de Hugging Face. [alias: ls]

**Uso**:

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

**Opciones**:

* `--token TEXT`: un User Access Token generado desde https://huggingface.co/settings/tokens.
* `--help`: Muestra este mensaje y sale.

Ejemplos $ hf skills list $ hf skills list --format json

Más información Utilice `hf <command> --help` para obtener más información sobre un comando. Lea la documentación en https://huggingface.co/docs/huggingface_hub/en/guides/cli

### `hf skills preview`

Imprime el `hf-cli` SKILL.md generado en stdout.

**Uso**:

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

**Opciones**:

* `--help`: Muestra este mensaje y sale.

### `hf skills update`

Actualice las habilidades del mercado de Hugging Face instaladas.

**Uso**:

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

**Argumentos**:

* `[NAME]`: Nombre opcional de la habilidad instalada que se actualizará.

**Opciones**:

* `-g, --global`: Use los directorios de habilidades globales en lugar del proyecto actual.
* `--dest PATH`: Actualiza las habilidades en un directorio de habilidades personalizado.
* `--help`: Muestra este mensaje y sale.

Ejemplos $ hf skills update $ hf skills update hf-cli $ hf skills update huggingface-gradio --dest=~/my-skills $ hf skills update -g

Más información Utilice `hf <command> --help` para obtener más información sobre un comando. Lea la documentación en https://huggingface.co/docs/huggingface_hub/en/guides/cli

## `hf spaces`

Interactúa con los espacios en el Hub.

**Uso**:

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

**Opciones**:

* `--help`: Muestra este mensaje y sale.

**Comandos**:

* `card`: Obtiene la tarjeta (README) de un Space en el Hub.
* `dev-mode`: Habilita o deshabilita el modo de desarrollo en un Space.
* `hardware`: Lista las opciones de hardware disponibles para Spaces.
* `hot-reload`: Recarga cualquier archivo Python de un Space sin necesidad de una reconstrucción y reinicio completos.
* `info`: Obtiene información sobre un espacio en el Hub.
* `list`: Lista espacios en el Hub o archivos en un repositorio de espacio. [alias: ls]
* `logs`: Obtiene los registros de ejecución o compilación de un Space.
* `pause`: Pausar un Space.
* `restart`: Reiniciar un Space.
* `search`: Busca espacios en el Hub mediante búsqueda semántica.
* `secrets`: Gestiona los secretos de un Space en el Hub.
* `settings`: Actualiza la configuración de un Space.
* `ssh`: Conectarse por SSH al contenedor de Dev Mode de un Space.
* `templates`: Lista las plantillas de Space disponibles.
* `variables`: Gestiona las variables de entorno de un Space en el Hub.
* `volumes`: Gestiona los volúmenes de un Space en el Hub.
* `wait`: Espera a que un Space termine de construirse/iniciarse.
* `zero-gpu`: Gestiona tu uso de ZeroGPU en el Hub.

### `hf spaces card`

Obtén la tarjeta del Space (README) de un Space en el Hub.

**Uso**:

```console
$ hf spaces card [OPTIONS] SPACE_ID
```

**Argumentos**:

* `SPACE_ID`: El ID del espacio (p. ej. `username/repo-name`). [obligatorio]

**Opciones**:

* `--metadata`: Solo muestra los metadatos de la tarjeta.
* `--text`: Solo muestra el cuerpo del texto (sin metadatos).
* `--token TEXT`: un User Access Token generado desde https://huggingface.co/settings/tokens.
* `--help`: Muestra este mensaje y sale.

Ejemplos $ 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

Más información Utilice `hf <command> --help` para obtener más información sobre un comando. Lea la documentación en https://huggingface.co/docs/huggingface_hub/en/guides/cli

### `hf spaces dev-mode`

Activar o desactivar el modo de desarrollo en un Space.

Spaces Dev Mode facilita la depuración de tu aplicación y agiliza la iteración en Spaces al permitirte reiniciar tu aplicación sin detener el contenedor del Space. Habilitar el modo de desarrollo requiere un plan PRO o Team & Enterprise. Deshabilitarlo (`--stop`) siempre está permitido.

Ver documentación: https://huggingface.co/docs/hub/spaces-dev-mode

**Uso**:

```console
$ hf spaces dev-mode [OPTIONS] SPACE_ID
```

**Argumentos**:

* `SPACE_ID`: El ID del espacio (p. ej. `username/repo-name`). [obligatorio]

**Opciones**:

* `--stop / --no-stop`: Detener el modo de desarrollo. [predeterminado: no-stop]
* `--token TEXT`: un User Access Token generado desde https://huggingface.co/settings/tokens.
* `--help`: Muestra este mensaje y sale.

Ejemplos $ hf spaces dev-mode my-user-name/deepsite

Más información Utilice `hf <command> --help` para obtener más información sobre un comando. Lea la documentación en https://huggingface.co/docs/huggingface_hub/en/guides/cli

### `hf spaces hardware`

Muestra las opciones de hardware disponibles para Spaces.

**Uso**:

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

**Opciones**:

* `--token TEXT`: un User Access Token generado desde https://huggingface.co/settings/tokens.
* `--help`: Muestra este mensaje y sale.

Ejemplos $ hf spaces hardware

Más información Utilice `hf <command> --help` para obtener más información sobre un comando. Lea la documentación en https://huggingface.co/docs/huggingface_hub/en/guides/cli

### `hf spaces hot-reload`

Recarga en caliente cualquier archivo Python de un Space sin necesidad de una reconstrucción y reinicio completos.

⚠ Esta función es experimental ⚠

Solo funciona con Gradio SDK (6.1+) Abre un editor interactivo a menos que se especifique --local-file/-f.

Este comando parchea el proceso de Python en vivo mediante https://github.com/breuleux/jurigged (diferenciación basada en AST, actualizaciones de funciones in situ, etc.), integrado con el soporte nativo de recarga en caliente de Gradio (lo que significa que los cambios en el objeto de la demo de Gradio se reflejan en la interfaz de usuario)

El comando crea un commit remoto. Si estás trabajando desde un clon local, ejecuta `git pull --autostash` a continuación para recuperar el commit y mantener tu estado local de git sincronizado.

**Uso**:

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

**Argumentos**:

* `SPACE_ID`: El ID del espacio (p. ej. `username/repo-name`). [obligatorio]
* `[FILENAME]`: Ruta al archivo Python en el repositorio del Space. Se puede omitir cuando se especifica --local-file y la ruta en el repositorio coincide.

**Opciones**:

* `-f, --local-file PATH`: Ruta del archivo local. Modo de editor interactivo si no se especifica
* `--skip-checks / --no-skip-checks`: Omitir las comprobaciones de compatibilidad con la recarga en caliente. [predeterminado: no-skip-checks]
* `--skip-summary / --no-skip-summary`: Omitir la visualización del resumen después de que se active la recarga en caliente [predeterminado: no-skip-summary]
* `--token TEXT`: un User Access Token generado desde https://huggingface.co/settings/tokens.
* `--help`: Muestra este mensaje y sale.

Ejemplos $ hf spaces hot-reload username/repo-name app.py     # Abre un editor interactivo para el archivo app.py remoto $ hf spaces hot-reload username/repo-name -f app.py  # Toma la versión local de ./app.py y parchea app.py de forma remota $ hf spaces hot-reload username/repo-name app.py -f src/app.py # Toma la versión local de ./src/app.py

Más información Utilice `hf <command> --help` para obtener más información sobre un comando. Lea la documentación en https://huggingface.co/docs/huggingface_hub/en/guides/cli

### `hf spaces info`

Obtén información sobre un espacio en el Hub.

**Uso**:

```console
$ hf spaces info [OPTIONS] SPACE_ID
```

**Argumentos**:

* `SPACE_ID`: El ID del espacio (p. ej. `username/repo-name`). [obligatorio]

**Opciones**:

* `--revision TEXT`: id de la revisión de Git, que puede ser un nombre de rama, una etiqueta o un hash de commit.
* `--expand TEXT`: Propiedades separadas por comas que se devolverán. Cuando se usa, solo se devuelven las propiedades enumeradas (y id). Ejemplo: '--expand=likes,tags'. Válido: author, cardData, createdAt, datasets, disabled, lastModified, likes, models, private, region, resourceGroup, runtime, sdk, sha, siblings, subdomain, tags, trendingScore, usedStorage, visibility.
* `--token TEXT`: un User Access Token generado desde https://huggingface.co/settings/tokens.
* `--help`: Muestra este mensaje y sale.

Ejemplos $ hf spaces info enzostvs/deepsite $ hf spaces info gradio/theme_builder --expand sdk,runtime,likes

Más información Utilice `hf <command> --help` para obtener más información sobre un comando. Lea la documentación en https://huggingface.co/docs/huggingface_hub/en/guides/cli

### `hf spaces list`

Listar espacios en el Hub o archivos en un repositorio de espacio. [alias: ls]

Cuando se llama sin argumentos, lista los espacios en el Hub. Cuando se llama con un ID de espacio, lista los archivos en ese repositorio de espacio.

**Uso**:

```console
$ hf spaces list [OPTIONS] [REPO_ID]
```

**Argumentos**:

* `[REPO_ID]`: ID del Space (p. ej. `username/repo-name`) del que se listarán los archivos. Si se omite, lista los spaces.

**Opciones**:

* `--search TEXT`: Consulta de búsqueda.
* `--author TEXT`: Filtrar por autor u organización.
* `--filter TEXT`: Filtrar por etiquetas (p. ej., 'text-classification'). Se puede usar varias veces.
* `--sort [created_at|last_modified|likes|trending_score]`: Ordena los resultados.
* `--limit INTEGER`: Limita el número de resultados. [predeterminado: 30]
* `--expand TEXT`: Propiedades separadas por comas que se devolverán. Cuando se usa, solo se devuelven las propiedades enumeradas (y id). Ejemplo: '--expand=likes,tags'. Válido: author, cardData, createdAt, datasets, disabled, lastModified, likes, models, private, region, resourceGroup, runtime, sdk, sha, siblings, subdomain, tags, trendingScore, usedStorage, visibility.
* `-h, --human-readable`: Muestra los tamaños en un formato legible por humanos (solo para listar archivos).
* `--tree`: Lista los archivos en formato de árbol (solo para listar archivos).
* `-R, --recursive`: Lista los archivos de forma recursiva (solo para listar archivos).
* `--revision TEXT`: id de la revisión de Git, que puede ser un nombre de rama, una etiqueta o un hash de commit.
* `--token TEXT`: un User Access Token generado desde https://huggingface.co/settings/tokens.
* `--help`: Muestra este mensaje y sale.

Ejemplos $ 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

Más información Utilice `hf <command> --help` para obtener más información sobre un comando. Lea la documentación en https://huggingface.co/docs/huggingface_hub/en/guides/cli

### `hf spaces logs`

Obtén los registros de ejecución o compilación de un Space.

Por defecto, imprime los registros de ejecución disponibles y sale (no bloqueante, como `docker logs`). Use --follow/-f para transmitir en tiempo real hasta que el servidor cierre la transmisión. Use --build para ver los registros de compilación del contenedor en su lugar (útil cuando un Space se queda atascado en BUILD_ERROR).

**Uso**:

```console
$ hf spaces logs [OPTIONS] SPACE_ID
```

**Argumentos**:

* `SPACE_ID`: El ID del espacio (p. ej. `username/repo-name`). [obligatorio]

**Opciones**:

* `--build`: Obtiene los registros de compilación del contenedor en lugar de los registros de ejecución. Útil cuando un Space se queda atascado en BUILD_ERROR.
* `-f, --follow`: Sigue la salida de registros (transmite hasta que el servidor cierre el flujo). Sin esta bandera, solo se imprimen los registros disponibles en ese momento.
* `-n, --tail INTEGER`: Número de líneas que se mostrarán desde el final de los registros.
* `--token TEXT`: un User Access Token generado desde https://huggingface.co/settings/tokens.
* `--help`: Muestra este mensaje y sale.

Ejemplos $ 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

Más información Utilice `hf <command> --help` para obtener más información sobre un comando. Lea la documentación en https://huggingface.co/docs/huggingface_hub/en/guides/cli

### `hf spaces pause`

Pausar un Space.

**Uso**:

```console
$ hf spaces pause [OPTIONS] SPACE_ID
```

**Argumentos**:

* `SPACE_ID`: El ID del espacio (p. ej. `username/repo-name`). [obligatorio]

**Opciones**:

* `--token TEXT`: un User Access Token generado desde https://huggingface.co/settings/tokens.
* `--help`: Muestra este mensaje y sale.

Ejemplos $ hf spaces pause username/my-space

Más información Utilice `hf <command> --help` para obtener más información sobre un comando. Lea la documentación en https://huggingface.co/docs/huggingface_hub/en/guides/cli

### `hf spaces restart`

Reiniciar un Space.

**Uso**:

```console
$ hf spaces restart [OPTIONS] SPACE_ID
```

**Argumentos**:

* `SPACE_ID`: El ID del espacio (p. ej. `username/repo-name`). [obligatorio]

**Opciones**:

* `--factory-reboot`: Reconstruye el Space desde cero sin usar la caché de compilación.
* `--token TEXT`: un User Access Token generado desde https://huggingface.co/settings/tokens.
* `--help`: Muestra este mensaje y sale.

Ejemplos $ hf spaces restart username/my-space $ hf spaces restart username/my-space --factory-reboot

Más información Utilice `hf <command> --help` para obtener más información sobre un comando. Lea la documentación en https://huggingface.co/docs/huggingface_hub/en/guides/cli

### `hf spaces search`

Busque espacios en el Hub mediante búsqueda semántica.

**Uso**:

```console
$ hf spaces search [OPTIONS] QUERY
```

**Argumentos**:

* `QUERY`: Consulta de búsqueda. [obligatorio]

**Opciones**:

* `--filter TEXT`: Filtrar por etiquetas (p. ej., 'text-classification'). Se puede usar varias veces.
* `--sdk TEXT`: Filtrar por SDK (p. ej., gradio, docker, static).
* `--include-non-running / --no-include-non-running`: Incluye espacios no activos en los resultados. [predeterminado: no-include-non-running]
* `--description / --no-description`: Muestra descripciones generadas por IA. [predeterminado: no-description]
* `--limit INTEGER`: Limita el número de resultados. [predeterminado: 10]
* `--token TEXT`: un User Access Token generado desde https://huggingface.co/settings/tokens.
* `--help`: Muestra este mensaje y sale.

Ejemplos $ 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

Más información Utilice `hf <command> --help` para obtener más información sobre un comando. Lea la documentación en https://huggingface.co/docs/huggingface_hub/en/guides/cli

### `hf spaces secrets`

Gestionar secretos para un Space en el Hub.

**Uso**:

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

**Opciones**:

* `--help`: Muestra este mensaje y sale.

**Comandos**:

* `add`: Agrega o actualiza secretos para un Space.
* `delete`: Elimina un secreto de un Space.
* `list`: Lista los secretos de un Space. [alias: ls]

#### `hf spaces secrets add`

Agregue o actualice secretos para un Space.

**Uso**:

```console
$ hf spaces secrets add [OPTIONS] SPACE_ID
```

**Argumentos**:

* `SPACE_ID`: El ID del espacio (p. ej. `username/repo-name`). [obligatorio]

**Opciones**:

* `-s, --secrets TEXT`: Establece variables de entorno secretas. Prefiere `--secrets SECRET` para leer el valor desde tu entorno (p. ej. `--secrets HF_TOKEN` para pasar tu token de Hugging Face); `--secrets SECRET=value` deja el valor en el historial de tu shell.
* `--secrets-file TEXT`: Lee un archivo de variables de entorno secretas. Usa `-` para leerlas desde stdin.
* `--token TEXT`: un User Access Token generado desde https://huggingface.co/settings/tokens.
* `--help`: Muestra este mensaje y sale.

Ejemplos $ 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

Más información Utilice `hf <command> --help` para obtener más información sobre un comando. Lea la documentación en https://huggingface.co/docs/huggingface_hub/en/guides/cli

#### `hf spaces secrets delete`

Eliminar un secreto de un Space.

**Uso**:

```console
$ hf spaces secrets delete [OPTIONS] SPACE_ID KEY
```

**Argumentos**:

* `SPACE_ID`: El ID del espacio (p. ej. `username/repo-name`). [obligatorio]
* `KEY`: Nombre del secreto que se va a eliminar. [obligatorio]

**Opciones**:

* `-y, --yes`: Responde automáticamente Sí al prompt.
* `--token TEXT`: un User Access Token generado desde https://huggingface.co/settings/tokens.
* `--help`: Muestra este mensaje y sale.

Ejemplos $ hf spaces secrets delete username/my-space HF_TOKEN $ hf spaces secrets delete username/my-space HF_TOKEN --yes

Más información Utilice `hf <command> --help` para obtener más información sobre un comando. Lea la documentación en https://huggingface.co/docs/huggingface_hub/en/guides/cli

#### `hf spaces secrets list`

Listar secretos de un Space. Los valores de los secretos son solo de escritura y no se devuelven. [alias: ls]

**Uso**:

```console
$ hf spaces secrets list [OPTIONS] SPACE_ID
```

**Argumentos**:

* `SPACE_ID`: El ID del espacio (p. ej. `username/repo-name`). [obligatorio]

**Opciones**:

* `--token TEXT`: un User Access Token generado desde https://huggingface.co/settings/tokens.
* `--help`: Muestra este mensaje y sale.

Ejemplos $ hf spaces secrets ls username/my-space

Más información Utilice `hf <command> --help` para obtener más información sobre un comando. Lea la documentación en https://huggingface.co/docs/huggingface_hub/en/guides/cli

### `hf spaces settings`

Actualice la configuración de un Space.

**Uso**:

```console
$ hf spaces settings [OPTIONS] SPACE_ID
```

**Argumentos**:

* `SPACE_ID`: El ID del espacio (p. ej. `username/repo-name`). [obligatorio]

**Opciones**:

* `--sleep-time INTEGER`: Tiempo de inactividad en segundos después del cual el Space se pone en suspensión. Use -1 para que nunca se suspenda. Solo disponible en hardware actualizado.
* `--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]`: Tipo de hardware del espacio (p. ej., 'cpu-basic', 't4-medium', 'l4x4'). Ejecuta 'hf spaces hardware' para ver las opciones disponibles.
* `--token TEXT`: un User Access Token generado desde https://huggingface.co/settings/tokens.
* `--help`: Muestra este mensaje y sale.

Ejemplos $ hf spaces settings username/my-space --sleep-time 300 $ hf spaces settings username/my-space --hardware t4-medium

Más información Utilice `hf <command> --help` para obtener más información sobre un comando. Lea la documentación en https://huggingface.co/docs/huggingface_hub/en/guides/cli

### `hf spaces ssh`

Conéctese por SSH al contenedor de Dev Mode de un Space.

Requiere que el modo Dev esté en ejecución en el Space y que tu clave pública SSH esté registrada en https://huggingface.co/settings/keys.

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

**Uso**:

```console
$ hf spaces ssh [OPTIONS] SPACE_ID
```

**Argumentos**:

* `SPACE_ID`: El ID del espacio (p. ej. `username/repo-name`). [obligatorio]

**Opciones**:

* `-i, --identity-file PATH`: Ruta al archivo de identidad SSH (se reenvía a `ssh -i`).
* `--dry-run`: Imprime el comando SSH en lugar de ejecutarlo.
* `--auto`: Habilita el modo Dev sin solicitar confirmación si no está habilitado.
* `--token TEXT`: un User Access Token generado desde https://huggingface.co/settings/tokens.
* `--help`: Muestra este mensaje y sale.

Ejemplos $ 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

Más información Utilice `hf <command> --help` para obtener más información sobre un comando. Lea la documentación en https://huggingface.co/docs/huggingface_hub/en/guides/cli

### `hf spaces templates`

Listar las plantillas de Space disponibles.

El `repo_id` (o `name`) de una plantilla se puede pasar a `hf repos create --template ...` para crear un nuevo Space a partir de esa plantilla.

**Uso**:

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

**Opciones**:

* `--token TEXT`: un User Access Token generado desde https://huggingface.co/settings/tokens.
* `--help`: Muestra este mensaje y sale.

Ejemplos $ hf spaces templates

Más información Utilice `hf <command> --help` para obtener más información sobre un comando. Lea la documentación en https://huggingface.co/docs/huggingface_hub/en/guides/cli

### `hf spaces variables`

Gestionar variables de entorno para un Space en el Hub.

**Uso**:

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

**Opciones**:

* `--help`: Muestra este mensaje y sale.

**Comandos**:

* `add`: Agrega o actualiza variables de entorno para un Space.
* `delete`: Elimina una variable de entorno de un Space.
* `list`: Lista las variables de entorno de un Space. [alias: ls]

#### `hf spaces variables add`

Agregue o actualice variables de entorno para un Space.

**Uso**:

```console
$ hf spaces variables add [OPTIONS] SPACE_ID
```

**Argumentos**:

* `SPACE_ID`: El ID del espacio (p. ej. `username/repo-name`). [obligatorio]

**Opciones**:

* `-e, --env TEXT`: Establece variables de entorno. Por ejemplo, --env ENV=value
* `--env-file TEXT`: Lee un archivo de variables de entorno. Usa `-` para leerlas desde stdin.
* `--token TEXT`: un User Access Token generado desde https://huggingface.co/settings/tokens.
* `--help`: Muestra este mensaje y sale.

Ejemplos $ 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

Más información Utilice `hf <command> --help` para obtener más información sobre un comando. Lea la documentación en https://huggingface.co/docs/huggingface_hub/en/guides/cli

#### `hf spaces variables delete`

Eliminar una variable de entorno de un Space.

**Uso**:

```console
$ hf spaces variables delete [OPTIONS] SPACE_ID KEY
```

**Argumentos**:

* `SPACE_ID`: El ID del espacio (p. ej. `username/repo-name`). [obligatorio]
* `KEY`: Nombre de la variable a eliminar. [obligatorio]

**Opciones**:

* `-y, --yes`: Responde automáticamente Sí al prompt.
* `--token TEXT`: un User Access Token generado desde https://huggingface.co/settings/tokens.
* `--help`: Muestra este mensaje y sale.

Ejemplos $ hf spaces variables delete username/my-space DEBUG $ hf spaces variables delete username/my-space DEBUG --yes

Más información Utilice `hf <command> --help` para obtener más información sobre un comando. Lea la documentación en https://huggingface.co/docs/huggingface_hub/en/guides/cli

#### `hf spaces variables list`

Listar las variables de entorno de un Space. [alias: ls]

**Uso**:

```console
$ hf spaces variables list [OPTIONS] SPACE_ID
```

**Argumentos**:

* `SPACE_ID`: El ID del espacio (p. ej. `username/repo-name`). [obligatorio]

**Opciones**:

* `--token TEXT`: un User Access Token generado desde https://huggingface.co/settings/tokens.
* `--help`: Muestra este mensaje y sale.

Ejemplos $ hf spaces variables ls username/my-space

Más información Utilice `hf <command> --help` para obtener más información sobre un comando. Lea la documentación en https://huggingface.co/docs/huggingface_hub/en/guides/cli

### `hf spaces volumes`

Gestiona los volúmenes de un Space en el Hub.

**Uso**:

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

**Opciones**:

* `--help`: Muestra este mensaje y sale.

**Comandos**:

* `delete`: Elimina todos los volúmenes de un Space.
* `list`: Lista los volúmenes montados en un Space. [alias: ls]
* `set`: Establece (reemplaza) los volúmenes de un Space.

#### `hf spaces volumes delete`

Eliminar todos los volúmenes de un Space.

**Uso**:

```console
$ hf spaces volumes delete [OPTIONS] SPACE_ID
```

**Argumentos**:

* `SPACE_ID`: El ID del espacio (p. ej. `username/repo-name`). [obligatorio]

**Opciones**:

* `-y, --yes`: Responde automáticamente Sí al prompt.
* `--token TEXT`: un User Access Token generado desde https://huggingface.co/settings/tokens.
* `--help`: Muestra este mensaje y sale.

Ejemplos $ hf spaces volumes delete username/my-space $ hf spaces volumes delete username/my-space --yes

Más información Utilice `hf <command> --help` para obtener más información sobre un comando. Lea la documentación en https://huggingface.co/docs/huggingface_hub/en/guides/cli

#### `hf spaces volumes list`

Listar los volúmenes montados en un Space. [alias: ls]

**Uso**:

```console
$ hf spaces volumes list [OPTIONS] SPACE_ID
```

**Argumentos**:

* `SPACE_ID`: El ID del espacio (p. ej. `username/repo-name`). [obligatorio]

**Opciones**:

* `--token TEXT`: un User Access Token generado desde https://huggingface.co/settings/tokens.
* `--help`: Muestra este mensaje y sale.

Ejemplos $ hf spaces volumes ls username/my-space

Más información Utilice `hf <command> --help` para obtener más información sobre un comando. Lea la documentación en https://huggingface.co/docs/huggingface_hub/en/guides/cli

#### `hf spaces volumes set`

Set (reemplazar) volúmenes para un Space.

**Uso**:

```console
$ hf spaces volumes set [OPTIONS] SPACE_ID
```

**Argumentos**:

* `SPACE_ID`: El ID del espacio (p. ej. `username/repo-name`). [obligatorio]

**Opciones**:

* `-v, --volume TEXT`: Monta uno o más volúmenes. Formato: hf://[TYPE/]SOURCE:/MOUNT_PATH[:ro]. TYPE es uno de: models, datasets, spaces, buckets. Si se omite TYPE, el valor predeterminado es models. models, datasets y spaces siempre se montan solo de lectura. buckets se montan con lectura y escritura de forma predeterminada. Por ejemplo, -v hf://org/m:/data o -v hf://datasets/org/ds:/data o -v hf://buckets/org/b:/mnt:ro
* `--token TEXT`: un User Access Token generado desde https://huggingface.co/settings/tokens.
* `--help`: Muestra este mensaje y sale.

Ejemplos $ 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

Más información Utilice `hf <command> --help` para obtener más información sobre un comando. Lea la documentación en https://huggingface.co/docs/huggingface_hub/en/guides/cli

### `hf spaces wait`

Espera a que un Space termine de construirse/iniciarse.

Bloquea hasta que el Space abandona una etapa intermedia (BUILDING, APP_STARTING, etc.) y alcanza una etapa estable. Sale con código 0 si el Space está en RUNNING, o con un código de salida no cero en caso contrario (p. ej., BUILD_ERROR, RUNTIME_ERROR).

**Uso**:

```console
$ hf spaces wait [OPTIONS] SPACE_ID
```

**Argumentos**:

* `SPACE_ID`: El ID del espacio (p. ej. `username/repo-name`). [obligatorio]

**Opciones**:

* `--timeout TEXT`: Tiempo máximo de espera: int con s (segundos, predeterminado), m (minutos), h (horas) o d (días).
* `--token TEXT`: un User Access Token generado desde https://huggingface.co/settings/tokens.
* `--help`: Muestra este mensaje y sale.

Ejemplos $ hf spaces wait username/my-space $ hf spaces wait username/my-space --timeout 5m

Más información Utilice `hf <command> --help` para obtener más información sobre un comando. Lea la documentación en https://huggingface.co/docs/huggingface_hub/en/guides/cli

### `hf spaces zero-gpu`

Gestiona tu uso de ZeroGPU en el Hub.

**Uso**:

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

**Opciones**:

* `--help`: Muestra este mensaje y sale.

**Comandos**:

* `quota`: Muestra tu cuota de ZeroGPU (tiempo de GPU restante y fecha de restablecimiento).

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

Muestra tu cuota de ZeroGPU (tiempo de GPU restante y fecha de restablecimiento).

Los valores están en segundos de GPU. Con `--quiet`, solo se imprimen los segundos de GPU restantes.

**Uso**:

```console
$ hf spaces zero-gpu quota [OPTIONS]
```

**Opciones**:

* `--token TEXT`: un User Access Token generado desde https://huggingface.co/settings/tokens.
* `--help`: Muestra este mensaje y sale.

Ejemplos $ hf spaces zero-gpu quota $ hf spaces zero-gpu quota --format json

Más información Utilice `hf <command> --help` para obtener más información sobre un comando. Lea la documentación en https://huggingface.co/docs/huggingface_hub/en/guides/cli

## `hf sync`

Sincronizar archivos entre un directorio local y un bucket.

**Uso**:

```console
$ hf sync [OPTIONS] [SOURCE] [DEST]
```

**Argumentos**:

* `[SOURCE]`: Ruta de origen: directorio local o hf://buckets/namespace/bucket_name(/prefix)
* `[DEST]`: Ruta de destino: directorio local o hf://buckets/namespace/bucket_name(/prefix)

**Opciones**:

* `--delete / --no-delete`: Elimina los archivos de destino que no están presentes en el origen. [predeterminado: no-delete]
* `--ignore-times`: Omitir archivos solo en función del tamaño, ignorando las fechas de modificación.
* `--ignore-sizes`: Omitir archivos solo en función de las horas de modificación, ignorando los tamaños.
* `--plan TEXT`: Guarda el plan de sincronización en un archivo JSONL para su revisión en lugar de ejecutarlo.
* `--apply TEXT`: Aplica un archivo de plan guardado previamente.
* `--dry-run`: Imprime el plan de sincronización en stdout como JSONL sin ejecutarlo.
* `--include TEXT`: Incluye archivos que coincidan con el patrón (se pueden especificar varios).
* `--exclude TEXT`: Excluye archivos que coincidan con el patrón (se puede especificar varios).
* `--filter-from TEXT`: Lee los patrones de inclusión/exclusión desde un archivo.
* `--existing`: Omitir la creación de nuevos archivos en el receptor (solo actualizar archivos existentes).
* `--ignore-existing`: Omitir la actualización de archivos que ya existen en el receptor (solo crear archivos nuevos).
* `-v, --verbose`: Muestra registros detallados con razonamiento.
* `--token TEXT`: un User Access Token generado desde https://huggingface.co/settings/tokens.
* `--help`: Muestra este mensaje y sale.

## `hf update`

Actualice la CLI `hf` a la última versión.

**Uso**:

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

**Opciones**:

* `--help`: Muestra este mensaje y sale.

## `hf upload`

Sube un archivo o una carpeta al Hub.

Las carpetas con muchos archivos se dividen en varios commits. Si la carga de una carpeta se interrumpe, vuelve a ejecutar el mismo comando para reanudarla.

**Uso**:

```console
$ hf upload [OPTIONS] REPO_ID [LOCAL_PATH] [PATH_IN_REPO]
```

**Argumentos**:

* `REPO_ID`: El ID del repositorio (p. ej. `username/repo-name` o `spaces/username/repo-name`). [obligatorio]
* `[LOCAL_PATH]`: Ruta local al archivo o carpeta que se va a subir. Se admiten patrones comodín. El valor predeterminado es el directorio actual.
* `[PATH_IN_REPO]`: Ruta del archivo o carpeta en el repositorio. Por defecto, es la ruta relativa del archivo o carpeta.

**Opciones**:

* `--type, --repo-type [model|dataset|space|kernel]`: El tipo de repositorio (model, dataset, space o kernel). [predeterminado: (model)]
* `--revision TEXT`: id de la revisión de Git, que puede ser un nombre de rama, una etiqueta o un hash de commit.
* `--private / --no-private`: Si se debe crear un repositorio privado si el repositorio no existe en el Hub. Se ignora si el repositorio ya existe.
* `--include TEXT`: Patrones globales para coincidir con los archivos a subir.
* `--exclude TEXT`: Patrones globales para excluir de los archivos a subir.
* `--delete TEXT`: Patrones glob para archivos que se eliminarán del repositorio al realizar el commit.
* `--commit-message TEXT`: El resumen / título / primera línea del commit generado.
* `--commit-description TEXT`: La descripción del commit generado.
* `--create-pr / --no-create-pr`: Si se sube el contenido como una nueva Pull Request. [predeterminado: no-create-pr]
* `--every FLOAT`: Si se establece, se programa un trabajo en segundo plano para crear commits cada `every` minutos.
* `--token TEXT`: un User Access Token generado desde https://huggingface.co/settings/tokens.
* `--help`: Muestra este mensaje y sale.

Ejemplos $ 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

Más información Utilice `hf <command> --help` para obtener más información sobre un comando. Lea la documentación en https://huggingface.co/docs/huggingface_hub/en/guides/cli

## `hf version`

Imprime información sobre la versión de hf.

**Uso**:

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

**Opciones**:

* `--help`: Muestra este mensaje y sale.

## `hf webhooks`

Gestiona los webhooks en el Hub.

**Uso**:

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

**Opciones**:

* `--help`: Muestra este mensaje y sale.

**Comandos**:

* `create`: Crea un nuevo webhook.
* `delete`: Elimina un webhook de forma permanente.
* `disable`: Desactiva un webhook activo.
* `enable`: Habilita un webhook deshabilitado.
* `info`: Muestra todos los detalles de un solo webhook.
* `list`: Lista todos los webhooks del usuario actual. [alias: ls]
* `update`: Actualiza un webhook existente.

### `hf webhooks create`

Crea un nuevo webhook.

Proporcione --url (para hacer ping a un servidor remoto) o --job-id (para activar un Job), pero no ambos. Los secretos del Job de origen no se copian al webhook: páselos de nuevo con --secrets / --secrets-file.

**Uso**:

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

**Opciones**:

* `--watch TEXT`: Elemento a observar, en el formato 'type:name' (p. ej., 'model:bert-base-uncased'). Repetible.  [obligatorio]
* `--url TEXT`: URL a la que se enviarán las cargas de webhook. Es mutuamente excluyente con --job-id.
* `--job-id TEXT`: ID de un Job para activar (desde job.id) en lugar de hacer ping a una URL. Es mutuamente excluyente con --url.
* `--domain [repo|discussion]`: Dominio a vigilar: 'repo' o 'discussion'. Repetible. El valor predeterminado es todos los dominios.
* `--secret TEXT`: Secreto opcional utilizado para firmar las cargas de webhook.
* `-s, --secrets TEXT`: Establece variables de entorno secretas. Prefiere `--secrets SECRET` para leer el valor desde tu entorno (p. ej. `--secrets HF_TOKEN` para pasar tu token de Hugging Face); `--secrets SECRET=value` deja el valor en el historial de tu shell.
* `--secrets-file TEXT`: Lee un archivo de variables de entorno secretas. Usa `-` para leerlas desde stdin.
* `--token TEXT`: un User Access Token generado desde https://huggingface.co/settings/tokens.
* `--help`: Muestra este mensaje y sale.

Ejemplos $ 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

Más información Utilice `hf <command> --help` para obtener más información sobre un comando. Lea la documentación en https://huggingface.co/docs/huggingface_hub/en/guides/cli

### `hf webhooks delete`

Eliminar un webhook de forma permanente.

**Uso**:

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

**Argumentos**:

* `WEBHOOK_ID`: El ID del webhook que se va a eliminar. [obligatorio]

**Opciones**:

* `-y, --yes`: Omite la solicitud de confirmación.
* `--token TEXT`: un User Access Token generado desde https://huggingface.co/settings/tokens.
* `--help`: Muestra este mensaje y sale.

Ejemplos $ hf webhooks delete abc123 $ hf webhooks delete abc123 --yes

Más información Utilice `hf <command> --help` para obtener más información sobre un comando. Lea la documentación en https://huggingface.co/docs/huggingface_hub/en/guides/cli

### `hf webhooks disable`

Desactivar un webhook activo.

**Uso**:

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

**Argumentos**:

* `WEBHOOK_ID`: El ID del webhook que se va a desactivar. [obligatorio]

**Opciones**:

* `--token TEXT`: un User Access Token generado desde https://huggingface.co/settings/tokens.
* `--help`: Muestra este mensaje y sale.

Ejemplos $ hf webhooks disable abc123

Más información Utilice `hf <command> --help` para obtener más información sobre un comando. Lea la documentación en https://huggingface.co/docs/huggingface_hub/en/guides/cli

### `hf webhooks enable`

Habilitar un webhook deshabilitado.

**Uso**:

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

**Argumentos**:

* `WEBHOOK_ID`: El ID del webhook que se habilitará. [obligatorio]

**Opciones**:

* `--token TEXT`: un User Access Token generado desde https://huggingface.co/settings/tokens.
* `--help`: Muestra este mensaje y sale.

Ejemplos $ hf webhooks enable abc123

Más información Utilice `hf <command> --help` para obtener más información sobre un comando. Lea la documentación en https://huggingface.co/docs/huggingface_hub/en/guides/cli

### `hf webhooks info`

Mostrar todos los detalles de un solo webhook.

**Uso**:

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

**Argumentos**:

* `WEBHOOK_ID`: El ID del webhook. [obligatorio]

**Opciones**:

* `--token TEXT`: un User Access Token generado desde https://huggingface.co/settings/tokens.
* `--help`: Muestra este mensaje y sale.

Ejemplos $ hf webhooks info abc123

Más información Utilice `hf <command> --help` para obtener más información sobre un comando. Lea la documentación en https://huggingface.co/docs/huggingface_hub/en/guides/cli

### `hf webhooks list`

Listar todos los webhooks del usuario actual. [alias: ls]

**Uso**:

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

**Opciones**:

* `--token TEXT`: un User Access Token generado desde https://huggingface.co/settings/tokens.
* `--help`: Muestra este mensaje y sale.

Ejemplos $ hf webhooks ls $ hf webhooks ls --format json $ hf webhooks ls --format quiet

Más información Utilice `hf <command> --help` para obtener más información sobre un comando. Lea la documentación en https://huggingface.co/docs/huggingface_hub/en/guides/cli

### `hf webhooks update`

Actualizar un webhook existente.

Proporcione la lista completa de elementos observados, los dominios y el destino, incluidos los valores que no han cambiado. Proporcione --url o --job-id.

Los secretos de trabajo pasados con --secrets reemplazan los valores almacenados con el mismo nombre; los demás se conservan.

**Uso**:

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

**Argumentos**:

* `WEBHOOK_ID`: El ID del webhook que se va a actualizar. [obligatorio]

**Opciones**:

* `--watch TEXT`: Lista completa de elementos a vigilar, en el formato type:name. Repetible. [obligatorio]
* `--domain [repo|discussion]`: Lista completa de dominios a vigilar: repo o discussion. Repetible. [obligatorio]
* `--url TEXT`: Nueva URL a la que enviar las cargas de webhook.
* `--job-id TEXT`: ID del Job de origen que se va a activar (puede ser el actual). Obligatorio con --secrets / --secrets-file.
* `--secret TEXT`: Nuevo secreto utilizado para firmar las cargas de webhook.
* `-s, --secrets TEXT`: Establece variables de entorno secretas. Prefiere `--secrets SECRET` para leer el valor desde tu entorno (p. ej. `--secrets HF_TOKEN` para pasar tu token de Hugging Face); `--secrets SECRET=value` deja el valor en el historial de tu shell.
* `--secrets-file TEXT`: Lee un archivo de variables de entorno secretas. Usa `-` para leerlas desde stdin.
* `--token TEXT`: un User Access Token generado desde https://huggingface.co/settings/tokens.
* `--help`: Muestra este mensaje y sale.

Ejemplos $ hf webhooks update abc123 --url https://new-url.com/hook --watch model:gpt2 --domain repo $ hf webhooks update abc123 --url https://example.com/hook --watch user:julien-c --domain repo --secret newsecret $ hf webhooks update abc123 --job-id 687f911eaea852de79c4a50a --watch user:julien-c --domain repo --secrets HF_TOKEN

Más información Utilice `hf <command> --help` para obtener más información sobre un comando. Lea la documentación en https://huggingface.co/docs/huggingface_hub/en/guides/cli