hf

CLI de Hugging Face Hub

Uso:

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

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

$ hf auth list [OPTIONS]

Opciones:

• --help: Muestra este mensaje y sale.

Ejemplos $ hf auth list

Más información Usa hf <command> --help para obtener más información sobre un comando. Lee 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:

$ 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 Usa hf <command> --help para obtener más información sobre un comando. Lee 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:

$ 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 Usa hf <command> --help para obtener más información sobre un comando. Lee la documentación en https://huggingface.co/docs/huggingface_hub/en/guides/cli

hf auth switch

Cambiar entre tokens de acceso.

Uso:

$ 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 Usa hf <command> --help para obtener más información sobre un comando. Lee 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:

$ 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 Usa hf <command> --help para obtener más información sobre un comando. Lee 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:

$ hf auth whoami [OPTIONS]

Opciones:

• --help: Muestra este mensaje y sale.

Ejemplos $ hf auth whoami $ hf auth whoami —format json

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

hf buckets

Comandos para interactuar con cubos.

Uso:

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

$ 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 Usa hf <command> --help para obtener más información sobre un comando. Lee la documentación en https://huggingface.co/docs/huggingface_hub/en/guides/cli

hf buckets create

Crea un nuevo bucket.

Uso:

$ 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 Usa hf <command> --help para obtener más información sobre un comando. Lee 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:

$ 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 Usa hf <command> --help para obtener más información sobre un comando. Lee la documentación en https://huggingface.co/docs/huggingface_hub/en/guides/cli

hf buckets info

Obtén información sobre un bucket.

Uso:

$ 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 Usa hf <command> --help para obtener más información sobre un comando. Lee 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:

$ 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 Usa hf <command> --help para obtener más información sobre un comando. Lee la documentación en https://huggingface.co/docs/huggingface_hub/en/guides/cli

hf buckets move

Mover (renombrar) un bucket a un nuevo nombre o espacio de nombres.

Uso:

$ 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 Usa hf <command> --help para obtener más información sobre un comando. Lee 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:

$ 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 Usa hf <command> --help para obtener más información sobre un comando. Lee la documentación en https://huggingface.co/docs/huggingface_hub/en/guides/cli

hf buckets settings

Actualizar la configuración del bucket (visibilidad).

Uso:

$ 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 Usa hf <command> --help para obtener más información sobre un comando. Lee 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:

$ 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 Usa hf <command> --help para obtener más información sobre un comando. Lee la documentación en https://huggingface.co/docs/huggingface_hub/en/guides/cli

hf cache

Gestionar el directorio de caché local.

Uso:

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

$ 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 Usa hf <command> --help para obtener más información sobre un comando. Lee 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:

$ 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 Usa hf <command> --help para obtener más información sobre un comando. Lee la documentación en https://huggingface.co/docs/huggingface_hub/en/guides/cli

hf cache rm

Eliminar repositorios, revisiones o archivos en caché.

Uso:

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

Más información Usa hf <command> --help para obtener más información sobre un comando. Lee 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:

$ 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 Usa hf <command> --help para obtener más información sobre un comando. Lee la documentación en https://huggingface.co/docs/huggingface_hub/en/guides/cli

hf collections

Interactúa con las colecciones en el Hub.

Uso:

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

$ 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 Usa hf <command> --help para obtener más información sobre un comando. Lee 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:

$ 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 Usa hf <command> --help para obtener más información sobre un comando. Lee la documentación en https://huggingface.co/docs/huggingface_hub/en/guides/cli

hf collections delete

Eliminar una colección del Hub.

Uso:

$ 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 Usa hf <command> --help para obtener más información sobre un comando. Lee 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:

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

$ 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 Usa hf <command> --help para obtener más información sobre un comando. Lee la documentación en https://huggingface.co/docs/huggingface_hub/en/guides/cli

hf collections list

Listar colecciones en el Hub. [alias: ls]

Uso:

$ 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 Usa hf <command> --help para obtener más información sobre un comando. Lee 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:

$ 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 Usa hf <command> --help para obtener más información sobre un comando. Lee 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:

$ 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 Usa hf <command> --help para obtener más información sobre un comando. Lee 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:

$ 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/ # copies contents only

Más información Usa hf <command> --help para obtener más información sobre un comando. Lee 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:

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

$ 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 Usa hf <command> --help para obtener más información sobre un comando. Lee 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:

$ 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 Usa hf <command> --help para obtener más información sobre un comando. Lee 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:

$ 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 # list available leaderboards

Más información Usa hf <command> --help para obtener más información sobre un comando. Lee 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:

$ 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 Usa hf <command> --help para obtener más información sobre un comando. Lee 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:

$ 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 Usa hf <command> --help para obtener más información sobre un comando. Lee 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:

$ 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 Usa hf <command> --help para obtener más información sobre un comando. Lee la documentación en https://huggingface.co/docs/huggingface_hub/en/guides/cli

discusiones de hf

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

Uso:

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

$ 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 Usa hf <command> --help para obtener más información sobre un comando. Lee 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:

$ 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 ‘’ 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 Usa hf <command> --help para obtener más información sobre un comando. Lee 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:

$ 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 ‘’ 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 Usa hf <command> --help para obtener más información sobre un comando. Lee 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:

$ 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 Usa hf <command> --help para obtener más información sobre un comando. Lee 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:

$ 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 ‘’ 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: ” —attach ./after.png

Más información Usa hf <command> --help para obtener más información sobre un comando. Lee 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:

$ 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 Usa hf <command> --help para obtener más información sobre un comando. Lee 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:

$ 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 Usa hf <command> --help para obtener más información sobre un comando. Lee 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:

$ 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 Usa hf <command> --help para obtener más información sobre un comando. Lee 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:

$ 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 Usa hf <command> --help para obtener más información sobre un comando. Lee la documentación en https://huggingface.co/docs/huggingface_hub/en/guides/cli

hf discussions reabrir

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

Uso:

$ 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 Usa hf <command> --help para obtener más información sobre un comando. Lee la documentación en https://huggingface.co/docs/huggingface_hub/en/guides/cli

hf download

Descarga archivos desde el Hub.

Uso:

$ 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 Usa hf <command> --help para obtener más información sobre un comando. Lee la documentación en https://huggingface.co/docs/huggingface_hub/en/guides/cli

hf endpoints

Gestionar los Hugging Face Inference Endpoints.

Uso:

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

$ 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. Pase —repo para desplegar la receta predeterminada de un modelo, opcionalmente restringida con —accelerator y —gguf-file, o pase —recipe para desplegar una receta exacta listada por hf endpoints catalog ls.

Uso:

$ 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 en ‘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 Usa hf <command> --help para obtener más información sobre un comando. Lee 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:

$ 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 Usa hf <command> --help para obtener más información sobre un comando. Lee 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:

$ 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 Usa hf <command> --help para obtener más información sobre un comando. Lee 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:

$ 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 con (p. ej. ‘vllm’). Por defecto, 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 Usa hf <command> --help para obtener más información sobre un comando. Lee 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:

$ 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 Usa hf <command> --help para obtener más información sobre un comando. Lee 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 acelerador restante para una réplica. Use --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:

$ 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 Usa hf <command> --help para obtener más información sobre un comando. Lee 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:

$ 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 Usa hf <command> --help para obtener más información sobre un comando. Lee 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:

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

$ 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 Usa hf <command> --help para obtener más información sobre un comando. Lee la documentación en https://huggingface.co/docs/huggingface_hub/en/guides/cli

hf endpoints resume

Resumir un punto de inferencia.

Uso:

$ 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 Usa hf <command> --help para obtener más información sobre un comando. Lee 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:

$ 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 Usa hf <command> --help para obtener más información sobre un comando. Lee la documentación en https://huggingface.co/docs/huggingface_hub/en/guides/cli

hf endpoints update

Actualizar un punto de acceso existente.

Uso:

$ 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 ‘hf endpoints describe NAME’ primero para verla.
• --engine [custom|hf-serve|llamacpp|sglang|tei|tgi|tgi-neuron|vllm|vllm-neuron]: Imagen del motor administrado para ejecutar —custom-image con (p. ej. ‘vllm’). Por defecto, 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 Usa hf <command> --help para obtener más información sobre un comando. Lee la documentación en https://huggingface.co/docs/huggingface_hub/en/guides/cli

hf env

Imprime información sobre el entorno.

Uso:

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

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

$ 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 Usa hf <command> --help para obtener más información sobre un comando. Lee 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:

$ 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 Usa hf <command> --help para obtener más información sobre un comando. Lee 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:

$ hf extensions list [OPTIONS]

Opciones:

• --help: Muestra este mensaje y sale.

Ejemplos $ hf extensions list

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

hf extensions remove

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

Uso:

$ 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 Usa hf <command> --help para obtener más información sobre un comando. Lee 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:

$ hf extensions search [OPTIONS]

Opciones:

• --help: Muestra este mensaje y sale.

Ejemplos $ hf extensions search

Más información Usa hf <command> --help para obtener más información sobre un comando. Lee 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:

$ 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 Usa hf <command> --help para obtener más información sobre un comando. Lee la documentación en https://huggingface.co/docs/huggingface_hub/en/guides/cli

hf jobs

Ejecuta y gestiona Jobs en el Hub.

Uso:

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

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

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

hf jobs expone

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

Uso:

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

Más información Usa hf <command> --help para obtener más información sobre un comando. Lee 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:

$ hf jobs hardware [OPTIONS]

Opciones:

• --help: Muestra este mensaje y sale.

Ejemplos $ hf jobs hardware

Más información Usa hf <command> --help para obtener más información sobre un comando. Lee 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:

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

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

hf jobs labels

Actualiza las etiquetas de un Job. Si se pasa —label, se reemplazan todas las etiquetas existentes; si solo se pasa —name, se conservan.

Uso:

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

Más información Usa hf <command> --help para obtener más información sobre un comando. Lee 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 para los valores posibles) y --label para filtrar por etiquetas key=value. Un Job debe coincidir con todos los filtros para ser listado.

Uso:

$ 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 Usa hf <command> --help para obtener más información sobre un comando. Lee 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:

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

Más información Usa hf <command> --help para obtener más información sobre un comando. Lee 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:

$ 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 <job_id> $ hf jobs rerun —detach <job_id>

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

hf jobs run

Ejecutar un trabajo.

Uso:

$ 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 jobs. Repita la bandera para varios puertos (p. ej. --expose 8000 --expose 8001). Cada puerto expuesto es accesible en el dominio público de jobs; el acceso requiere un token de HF con permiso de lectura en el namespace del job.
• --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 Usa hf <command> --help para obtener más información sobre un comando. Lee 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:

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

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

Más información Usa hf <command> --help para obtener más información sobre un comando. Lee 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:

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

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

hf jobs scheduled labels

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

Uso:

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

Más información Usa hf <command> --help para obtener más información sobre un comando. Lee 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:

$ 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 Usa hf <command> --help para obtener más información sobre un comando. Lee 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:

$ 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 <id> “0 9 * * 1”

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

hf jobs scheduled resume

Reanudar (despausar) un Job programado.

Uso:

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

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

hf jobs scheduled run

Programar un trabajo.

Uso:

$ 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 jobs. Repita la bandera para varios puertos (p. ej. --expose 8000 --expose 8001). Cada puerto expuesto es accesible en el dominio público de jobs; el acceso requiere un token de HF con permiso de lectura en el namespace del job.
• --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 Usa hf <command> --help para obtener más información sobre un comando. Lee la documentación en https://huggingface.co/docs/huggingface_hub/en/guides/cli

hf jobs scheduled suspend

Suspender (pausar) un Job programado.

Uso:

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

Más información Usa hf <command> --help para obtener más información sobre un comando. Lee 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:

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

Más información Usa hf <command> --help para obtener más información sobre un comando. Lee 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:

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

$ 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 jobs. Repita la bandera para varios puertos (p. ej. --expose 8000 --expose 8001). Cada puerto expuesto es accesible en el dominio público de jobs; el acceso requiere un token de HF con permiso de lectura en el namespace del job.
• --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 Usa hf <command> --help para obtener más información sobre un comando. Lee 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:

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

Más información Usa hf <command> --help para obtener más información sobre un comando. Lee 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:

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

Más información Usa hf <command> --help para obtener más información sobre un comando. Lee 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:

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

$ 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 jobs. Repita la bandera para varios puertos (p. ej. --expose 8000 --expose 8001). Cada puerto expuesto es accesible en el dominio público de jobs; el acceso requiere un token de HF con permiso de lectura en el namespace del job.
• --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 Usa hf <command> --help para obtener más información sobre un comando. Lee 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:

$ 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 <job_id> $ hf jobs wait <job_id_1> <job_id_2> $ hf jobs ls -q | xargs hf jobs wait

Más información Usa hf <command> --help para obtener más información sobre un comando. Lee 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:

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

$ hf lfs-multipart-upload [OPTIONS]

Opciones:

• --help: Muestra este mensaje y sale.

hf models

Interactúa con los modelos en el Hub.

Uso:

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

$ 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 Usa hf <command> --help para obtener más información sobre un comando. Lee 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:

$ 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 Usa hf <command> --help para obtener más información sobre un comando. Lee 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 del Hub. Cuando se llama con un ID de modelo, lista los archivos en ese repositorio de modelo.

Uso:

$ 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’ solo para modelos con acceso restringido, ‘—no-gated’ solo para 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 Usa hf <command> --help para obtener más información sobre un comando. Lee la documentación en https://huggingface.co/docs/huggingface_hub/en/guides/cli

hf papers

Interact con los artículos en el Hub.

Uso:

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

$ 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 Usa hf <command> --help para obtener más información sobre un comando. Lee 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:

$ 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 Usa hf <command> --help para obtener más información sobre un comando. Lee la documentación en https://huggingface.co/docs/huggingface_hub/en/guides/cli

hf papers read

Lee un artículo en formato markdown.

Uso:

$ 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 Usa hf <command> --help para obtener más información sobre un comando. Lee la documentación en https://huggingface.co/docs/huggingface_hub/en/guides/cli

hf papers search

Busca papers en el Hub.

Uso:

$ 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 Usa hf <command> --help para obtener más información sobre un comando. Lee la documentación en https://huggingface.co/docs/huggingface_hub/en/guides/cli

hf repos

Gestiona repositorios en el Hub.

Uso:

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

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

$ 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 Usa hf <command> --help para obtener más información sobre un comando. Lee 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:

$ 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 Usa hf <command> --help para obtener más información sobre un comando. Lee 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:

$ 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 Usa hf <command> --help para obtener más información sobre un comando. Lee la documentación en https://huggingface.co/docs/huggingface_hub/en/guides/cli

hf repos create

Crea un nuevo repositorio en el Hub.

Uso:

$ 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 está establecido 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 Usa hf <command> --help para obtener más información sobre un comando. Lee 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:

$ 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 $c hf repos delete my-model

Más información Usa hf <command> --help para obtener más información sobre un comando. Lee 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:

$ 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 Usa hf <command> --help para obtener más información sobre un comando. Lee 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:

$ 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 Usa hf <command> --help para obtener más información sobre un comando. Lee 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:

$ 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 Usa hf <command> --help para obtener más información sobre un comando. Lee 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:

$ 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 Usa hf <command> --help para obtener más información sobre un comando. Lee la documentación en https://huggingface.co/docs/huggingface_hub/en/guides/cli

hf repos settings

Actualice la configuración de un repositorio.

Uso:

$ 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 Usa hf <command> --help para obtener más información sobre un comando. Lee 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:

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

$ 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 Usa hf <command> --help para obtener más información sobre un comando. Lee la documentación en https://huggingface.co/docs/huggingface_hub/en/guides/cli

hf repos tag delete

Eliminar una etiqueta de un repositorio.

Uso:

$ 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 Usa hf <command> --help para obtener más información sobre un comando. Lee 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:

$ 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 Usa hf <command> --help para obtener más información sobre un comando. Lee 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:

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

$ hf sandbox cp [OPTIONS] SRC DST

Argumentos:

• SRC: Origen: una ruta local o <sandbox_id>:<path>. [obligatorio]
• DST: Destino: una ruta local o <sandbox_id>:<path>. [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 <sandbox_id>:/data/data.csv $ hf sandbox cp <sandbox_id>:/app/result.json result.json

Más información Usa hf <command> --help para obtener más información sobre un comando. Lee 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 (usa --env). Define primero un pool con hf sandbox pool create.

Uso:

$ 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 Usa hf <command> --help para obtener más información sobre un comando. Lee 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:

$ 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 <sandbox_id> — python -c “print(42)” $ hf sandbox exec -w /app <sandbox_id> — pytest -x

Más información Usa hf <command> --help para obtener más información sobre un comando. Lee 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:

$ 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 <sandbox_id> $ hf sandbox kill <host_id> # elimina un host compartido completo (todos sus sandboxes) $ hf sandbox kill —all

Más información Usa hf <command> --help para obtener más información sobre un comando. Lee 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:

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

$ 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 Usa hf <command> --help para obtener más información sobre un comando. Lee 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:

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

Más información Usa hf <command> --help para obtener más información sobre un comando. Lee 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:

$ 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 Usa hf <command> --help para obtener más información sobre un comando. Lee 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:

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

$ 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 <sandbox_id> <pid>

Más información Usa hf <command> --help para obtener más información sobre un comando. Lee 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:

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

Más información Usa hf <command> --help para obtener más información sobre un comando. Lee 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:

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

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

hf skills

Gestiona las habilidades de los asistentes de IA.

Uso:

$ 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 use --dest.

Uso:

$ 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 Usa hf <command> --help para obtener más información sobre un comando. Lee 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:

$ 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 Usa hf <command> --help para obtener más información sobre un comando. Lee 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:

$ hf skills preview [OPTIONS]

Opciones:

• --help: Muestra este mensaje y sale.

hf skills update

Actualice las habilidades del mercado de Hugging Face instaladas.

Uso:

$ 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 Usa hf <command> --help para obtener más información sobre un comando. Lee la documentación en https://huggingface.co/docs/huggingface_hub/en/guides/cli

hf spaces

Interactúa con los espacios en el Hub.

Uso:

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

$ 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 Usa hf <command> --help para obtener más información sobre un comando. Lee 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:

$ 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 Usa hf <command> --help para obtener más información sobre un comando. Lee la documentación en https://huggingface.co/docs/huggingface_hub/en/guides/cli

hardware de hf spaces

Muestra las opciones de hardware disponibles para Spaces.

Uso:

$ 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 Usa hf <command> --help para obtener más información sobre un comando. Lee 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 después para recuperar el commit y mantener tu estado local de git sincronizado.

Uso:

$ 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 # Open an interactive editor to the remote app.py file $ hf spaces hot-reload username/repo-name -f app.py # Take local version from ./app.py and patch app.py remotely $ hf spaces hot-reload username/repo-name app.py -f src/app.py # Take local version from ./src/app.py

Más información Usa hf <command> --help para obtener más información sobre un comando. Lee 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:

$ 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.
• --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 Usa hf <command> --help para obtener más información sobre un comando. Lee 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:

$ 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.
• -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 Usa hf <command> --help para obtener más información sobre un comando. Lee 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:

$ 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 Usa hf <command> --help para obtener más información sobre un comando. Lee la documentación en https://huggingface.co/docs/huggingface_hub/en/guides/cli

hf spaces pause

Pausar un Space.

Uso:

$ 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 Usa hf <command> --help para obtener más información sobre un comando. Lee la documentación en https://huggingface.co/docs/huggingface_hub/en/guides/cli

hf spaces restart

Reiniciar un Space.

Uso:

$ 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 Usa hf <command> --help para obtener más información sobre un comando. Lee 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:

$ 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 Usa hf <command> --help para obtener más información sobre un comando. Lee 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:

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

$ 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 Usa hf <command> --help para obtener más información sobre un comando. Lee la documentación en https://huggingface.co/docs/huggingface_hub/en/guides/cli

hf spaces secrets delete

Eliminar un secreto de un Space.

Uso:

$ 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 Usa hf <command> --help para obtener más información sobre un comando. Lee 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:

$ 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 Usa hf <command> --help para obtener más información sobre un comando. Lee la documentación en https://huggingface.co/docs/huggingface_hub/en/guides/cli

hf spaces settings

Actualice la configuración de un Space.

Uso:

$ 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 Usa hf <command> --help para obtener más información sobre un comando. Lee 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:

$ 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 Usa hf <command> --help para obtener más información sobre un comando. Lee la documentación en https://huggingface.co/docs/huggingface_hub/en/guides/cli

plantillas de hf spaces

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:

$ 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 Usa hf <command> --help para obtener más información sobre un comando. Lee 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:

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

$ 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 Usa hf <command> --help para obtener más información sobre un comando. Lee 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:

$ 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 Usa hf <command> --help para obtener más información sobre un comando. Lee 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:

$ 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 Usa hf <command> --help para obtener más información sobre un comando. Lee 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:

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

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