hf CLI: una CLI de Hugging Face más rápida y amigable con Jobs

Visión general

Hugging Face renombró oficialmente la CLI de huggingface-cli a hf. El objetivo es mejorar la ergonomía y la claridad reorganizando los comandos en una estructura impulsada por recursos. El nuevo patrón es hf , con comandos raíz como hf upload y hf download que se espera sean de los más usados. La CLI está diseñada para ser predecible y fácil de descubrir, preparando el terreno para características futuras mientras se mantiene la compatibilidad con la CLI heredada para facilitar la transición. Uno de los impulsos clave es simplificar el acceso a las funciones a medida que se agregan nuevas capacidades (subida, descarga, gestión de caché, gestión de repos, etc.). Una adición notable es el comando dedicado para Hugging Face Jobs. Jobs te permite ejecutar scripts o imágenes Docker en la Infraestructura de Hugging Face utilizando la potencia de hardware que elijas. La facturación de Jobs es por uso, y el acceso está limitado a usuarios Pro y a organizaciones Team o Enterprise. El CLI toma mucho del estilo de comandos de Docker para resultar familiar a los desarrolladores. Para empezar a experimentar, deberás instalar la última versión de huggingface_hub, reiniciar tu terminal y probar comandos básicos como hf version y hf —help. Si ya usaste huggingface-cli, la mayoría de los comandos te parecerán familiares, pero la nueva organización hace que la autenticación y otras tareas comunes sean más coherentes. Para ver cómo está organizado el nuevo CLI, puedes pensar en términos de grupos de recursos como hf auth, hf cache, hf repo, etc., con la salvedad de que hf upload y hf download se muestran en la raíz para un acceso rápido.

Funcionalidades clave

hf reemplaza a huggingface-cli con una interfaz más rápida y ergonómica.
Los comandos siguen el patrón predecible: hf .
Comandos raíz para las acciones más usadas, incluyendo hf upload y hf download.
Grupos de comandos como hf auth, hf cache, hf repo organizan la funcionalidad por recurso.
El CLI heredado permanece activo y totalmente funcional para facilitar la migración, con una advertencia que señala a los equivalentes hf.
Un comando dedicado hf jobs permite ejecutar scripts o imágenes Docker en la Infra de Hugging Face.
Jobs está disponible solo para usuarios Pro y organizaciones Team o Enterprise; hay tarificación por uso.
El diseño del CLI se inspira en Docker para favorecer la familiaridad y el aprendizaje.
La autenticación se ha reorganizado: todos los comandos de autenticación se agrupan bajo hf auth, incluyendo hf auth list para listar perfiles locales.
Después de la instalación, reinicia tu terminal y verifica con comandos como hf version y hf —help.

Nota: si estabas usando el CLI heredado, verás avisos que te guían hacia los equivalentes de hf.

Casos de uso comunes

Autenticar con múltiples perfiles locales usando hf auth y hf auth list.
Gestionar cachés locales y referencias de repositorios mediante hf cache y hf repo.
Subir o descargar artefactos rápidamente usando hf upload y hf download en la raíz.
Explorar la nueva estructura del CLI con hf —help y profundizar en cualquier grupo con —help.
Lanzar y gestionar Jobs en la Infraestructura de Hugging Face usando hf jobs (según el plan).
Realizar la transición gradual desde huggingface-cli, aceptando avisos y adoptando gradualmente la nueva sintaxis de hf.

Instalación y configuración

Para empezar, instala la versión más reciente de huggingface_hub y recarga tu sesión de terminal. La ubicación exacta del comando de instalación no se proporciona en el extracto, pero se enfatiza actualizar huggingface_hub y reiniciar el terminal antes de probar.

# comando de instalación exacto no proporcionado en el extracto

Después de la instalación, prueba la configuración:

hf version
hf --help

También puedes verificar el estado de autenticación y perfiles:

hf auth list

Si quieres explorar Jobs:

hf jobs --help

Quick start (ejemplo mínimo)

Instala la versión más reciente de huggingface_hub y reinicia el terminal.
Verifica la instalación:

Ejecuta hf version para confirmar que el CLI está disponible.
Ejecuta hf —help para ver la estructura de comandos por recurso.

Lista perfiles locales con hf auth list.
Usa los comandos raíz para tareas comunes, como subir o descargar:

hf upload (comando raíz)

Si estás en un plan Pro/Team/Enterprise, explora Jobs con hf jobs —help para entender cómo lanzar scripts o imágenes Docker en la infraestructura de HF. Nota: los comandos exactos de instalación no están en el extracto; sigue la indicación de actualizar huggingface_hub y reiniciar el terminal para empezar.

Pros y contras

Pros:
CLI más limpio y predecible con la estructura hf .
Comandos raíz para tareas comunes simplifican flujos de trabajo.
Servicio de Jobs dedicado ofrece ejecución en la nube con facturación por uso.
El CLI heredado permanece disponible para minimizar interrupciones durante la migración.
Diseño inspirado en Docker facilita el aprendizaje.
Contras:
Las nuevas funciones requieren actualizar a la versión más reciente de hugggingface_hub y pueden generar avisos de migración.
El acceso a Jobs está limitado a planes Pro y superiores, con tarificación por uso.
Los usuarios muy acostumbrados al diseño antiguo podrían necesitar tiempo para adaptarse a la nueva estructura.

Alternativas (comparación breve)

| Aspecto | huggingface-cli (legado) | hf (nuevo) |---|---|---| | Patrón de comandos | comandos específicos por función | hf ; estructura más uniforme |Acciones raíz | no enfatizadas | hf upload y hf download expuestos en la raíz |Autenticación | comandos de autenticación variados | autenticación agrupada bajo hf auth, hf auth list para perfiles locales |Ruta de migración | activo con avisos | CLI heredado permanece disponible durante la transición |Jobs | no destacado | hf jobs para ejecutar scripts/imágenes en la infraestructura HF |

Pricing o Licencia

Jobs de Hugging Face están disponibles solo para usuarios Pro y organizaciones Team o Enterprise. La tarificación de Jobs es pay-as-you-go, es decir, se paga solo por los segundos de uso.