Dile hola a hf: una CLI de Hugging Face más rápida y amigable

TL;DR

La Hugging Face CLI se ha renombrado de huggingface-cli a hf para mejorar la ergonomía y la consistencia. Blog Hugging Face
Los comandos ahora están organizados como hf , con hf upload y hf download disponibles en la raíz para usos habituales. Blog Hugging Face
La CLI heredada huggingface-cli permanece activa y completamente funcional; los usuarios verán una advertencia que dirige al nuevo CLI. Blog Hugging Face
Un nuevo comando dedicado, hf jobs, introduce Hugging Face Jobs (pago por uso) para ejecutar scripts o imágenes Docker en la infraestructura de Hugging Face, disponible para ciertos planes. Blog Hugging Face
Para empezar, instala la última versión de huggingface_hub, recarga tu terminal y verifica con hf version y hf —help. Blog Hugging Face

Contexto y antecedentes

El equipo de Hugging Face anunció una mejora de calidad de vida: renombrar la CLI de huggingface-cli a hf. Este cambio aborda lo tedioso de escribir el nombre antiguo y una estructura de comandos que se volvió confusa con características añadidas como upload, download, gestión de caché y repos. Se optó por un patrón de CLI conocido: hf , con el objetivo de una experiencia más ergonómica y fácil de descubrir, preparada para futuras características. Para probar la nueva CLI, los usuarios deben instalar la última versión de huggingface_hub y recargar la sesión del terminal. hf version y hf —help ayudan a explorar la nueva sintaxis. Los comandos están agrupados por recurso (hf auth, hf cache, hf repo, etc.), y hf upload y hf download se exponen en la raíz como los más usados. Para profundizar en cualquier grupo de comandos, basta con añadir —help. Si ya usabas huggingface-cli, la mayoría de los comandos te resultarán familiares; el mayor cambio se produce en la autenticación: todos los comandos de autenticación ahora están agrupados bajo hf auth (para cambiar entre diferentes perfiles locales) y hf auth list para listar perfiles locales. El huggingface-cli heredado permanece activo con funcionamiento total, y habrá una advertencia que dirija al equivalente en el nuevo CLI. Blog Hugging Face También se presentó un nuevo comando dedicado: hf jobs. Hugging Face Jobs permite ejecutar cualquier script o imagen Docker en la infraestructura de Hugging Face utilizando la flavor de hardware de tu elección. La facturación es pay-as-you-go, y Jobs está disponible solo para usuarios Pro y organizaciones Team o Enterprise, requiriendo actualizar el plan para comenzar. Para más detalles, consulta la guía de Jobs enlazada en el anuncio. Blog Hugging Face

¿Qué hay de nuevo?

Renombrado y reestructura: huggingface-cli pasa a llamarse hf, y la estructura de comandos es hf , con hf upload y hf download expuestos en la raíz para facilitar los flujos de trabajo. Blog Hugging Face
Agrupación por recurso: la arquitectura agrupa comandos bajo recursos como hf auth, hf cache y hf repo, mejorando la descubribilidad. Blog Hugging Face
Cambios de autenticación: todos los comandos de autenticación se consolidan en hf auth, incluyendo un mecanismo para cambiar entre perfiles locales y hf auth list para listar perfiles. El CLI heredado permanece disponible con avisos de migración. Blog Hugging Face
Nueva orden hf jobs: introduce Hugging Face Jobs para ejecutar scripts o imágenes Docker en la infraestructura de Hugging Face, con facturación pay-as-you-go; disponible solo para Pro y Team/Enterprise, requiriendo actualización de plan. Blog Hugging Face
Compatibilidad y transición: la mayoría de los comandos de huggingface-cli deberían sentirse familiares; la migración puede hacerse gradualmente. Blog Hugging Face

Tabla – comparación rápida de patrones antiguos vs nuevos

| Aspecto | CLI Antiguo | NUEVO CLI |---|---|---| | Patrón de comando | huggingface-cli | hf (hf upload/download en la raíz) |

Por qué importa (impacto para desarrolladores/empresas)

Para los desarrolladores, la reformulación de la CLI reduce fricción al aprender y usar las herramientas de Hugging Face. El patrón hf facilita predecir nombres de comandos y descubrir capacidades mediante —help. Exponer las acciones más usadas en la raíz acelera los flujos de trabajo. Para las empresas y equipos, mejoras en la autenticación simplifican la gestión de múltiples perfiles locales, y la introducción de Hugging Face Jobs ofrece una opción escalable y de pago por uso para ejecutar código en la infraestructura de Hugging Face, sujeto a la elegibilidad del plan. La transición cuidadosa, manteniendo el CLI heredado con avisos, ayuda a las organizaciones a migrar a su propio ritmo mientras validan el nuevo CLI en flujos de producción. Blog Hugging Face

Detalles técnicos o Implementación

Cómo empezar: instala la última versión de huggingface_hub, recarga tu terminal y verifica la instalación con hf version y explora con hf —help. Estos pasos establecen el entorno del nuevo CLI y revelan los grupos de comandos por recurso. Blog Hugging Face
Descubrimiento de comandos: los comandos están agrupados por recurso (p. ej., hf auth, hf cache, hf repo). Las acciones más utilizadas aparecen en la raíz como hf upload y hf download. Para profundizar, añade —help al comando objetivo. Blog Hugging Face
Cambios de autenticación: todos los comandos de autenticación están bajo hf auth, incluyendo un cambio entre perfiles locales y hf auth list para listar perfiles. El CLI heredado permanece disponible con avisos de migración. Blog Hugging Face
Hugging Face Jobs: nuevo comando hf jobs permite ejecutar scripts o imágenes Docker en la infraestructura de Hugging Face con la flavor de hardware elegida. La facturación es pay-as-you-go, y Jobs está disponible solo para usuarios Pro y organizaciones Team/Enterprise; se requiere actualizar el plan. Blog Hugging Face

Puntos clave

hf reemplaza huggingface-cli con un modelo de comandos más claro y coherente. Blog Hugging Face
La CLI agrupa comandos por recurso y mantiene las acciones esenciales en la raíz para un acceso rápido. Blog Hugging Face
Huggingface-cli legacy sigue usable, con avisos que guían a hf. Blog Hugging Face
Hugging Face Jobs se introduce como servicio pago por uso para Pro y más, ampliando lo que se puede ejecutar en la infraestructura de Hugging Face. Blog Hugging Face
Para empezar, instala el último huggingface_hub y verifica con hf version y hf —help. Blog Hugging Face

Preguntas frecuentes (FAQ)

P: ¿Cómo empiezo a usar hf? R: Instala la última versión de huggingface_hub, recarga tu terminal y ejecuta hf version para confirmar la instalación; luego explora con hf —help. Blog Hugging Face
P: ¿Qué pasó con huggingface-cli? R: El CLI fue renombrado a hf y el CLI legado permanece activo con avisos de migración. Blog Hugging Face
P: ¿Dónde están ahora los comandos de autenticación? R: Todos los comandos de autenticación están bajo hf auth, incluyendo un conmutador para cambiar entre perfiles locales y hf auth list para listar perfiles. Blog Hugging Face
P: ¿Qué es Hugging Face Jobs y quién puede usarlo? R: Hugging Face Jobs es un servicio para ejecutar scripts o imágenes Docker en la infraestructura de Hugging Face, con facturación pay-as-you-go, disponible para usuarios Pro y organizaciones Team/Enterprise; se requiere actualización de plan. Blog Hugging Face
P: ¿Necesito un plan pago para hf jobs? R: Sí; Hugging Face Jobs está disponible solo para usuarios Pro y organizaciones Team/Enterprise; es necesaria una actualización de plan para empezar. Blog Hugging Face