Diga olá ao hf: uma CLI Hugging Face mais rápida e amigável

TL;DR

• A Hugging Face CLI foi renomeada de huggingface-cli para hf para melhorar a ergonomia e a consistência. blog Hugging Face
• Os comandos agora são organizados como hf , com hf upload e hf download disponíveis na raiz para uso comum. blog Hugging Face
• A CLI legada huggingface-cli continua ativa e totalmente funcional; usuários verão um aviso apontando para o novo CLI quando aplicável. blog Hugging Face
• Um novo comando dedicado, hf jobs, apresenta o Hugging Face Jobs (pay-as-you-go) para executar scripts ou imagens Docker na infraestrutura da Hugging Face, disponível para determinados planos. blog Hugging Face
• Para começar, instale a versão mais recente do huggingface_hub, recarregue o terminal e verifique a configuração com hf version e hf —help. blog Hugging Face

Contexto e antecedentes

A equipe da Hugging Face anunciou uma melhoria de qualidade de vida de longo prazo: renomear a CLI de huggingface-cli para hf. Essa mudança reduz o desgaste de digitar o nome antigo e resolve uma estrutura de comandos que ficou confusa com a adição de recursos como upload, download, cache e gerenciamento de repositórios ao longo do tempo. Eles escolheram um padrão de CLI conhecido: hf , buscando uma experiência mais ergonômica e descobrível, preparando o terreno para recursos futuros. Para testar a nova CLI, é necessário instalar a versão mais recente do huggingface_hub e recarregar a sessão do terminal. A partir daí, hf version e hf —help ajudam a explorar a nova sintaxe. Os comandos são agrupados por recurso (hf auth, hf cache, hf repo, etc.), com hf upload e hf download expostos na raiz por serem os mais usados. Para aprofundar em qualquer grupo de comandos, basta adicionar —help. Se você já utilizava o huggingface-cli, a maioria dos comandos deve parecer familiar, sendo que a maior mudança envolve a autenticação: todos os comandos de autenticação passaram a ficar agrupados sob hf auth (incluindo a troca entre perfis locais) e hf auth list (para listar perfis locais). O huggingface-cli legado permanece ativo com funcionamento total, e haverá um aviso apontando para o equivalente no novo CLI. blog Hugging Face Também foi lançado um comando dedicado: hf jobs. Hugging Face Jobs permite executar qualquer script ou imagem Docker na infraestrutura da Hugging Face com a opção de escolher a “hardware flavor” desejada. A cobrança é do tipo pay-as-you-go, ou seja, você paga apenas pelos segundos usados. O serviço Hugging Face Jobs é novo e disponível apenas para usuários Pro e organizações Team ou Enterprise, exigindo atualização de plano para começar. Para mais detalhes, leia o guia de Jobs vinculado na publicação. blog Hugging Face

O que há de novo

• Renomeação e reestruturação: huggingface-cli vira hf, e a estrutura de comandos passa a hf , com hf upload e hf download na raiz para uso rápido. blog Hugging Face
• Agrupamento por recurso: a arquitetura apresenta grupos como hf auth, hf cache e hf repo, melhorando a descobertabilidade. blog Hugging Face
• Mudanças de autenticação: todos os comandos de autenticação foram reunidos sob hf auth, incluindo uma chave para alternar entre perfis locais e hf auth list para listar perfis. O CLI legada continua disponível com avisos de migração. blog Hugging Face
• Novo comando: hf jobs. Introduz o serviço Hugging Face Jobs para executar scripts ou imagens Docker na infraestrutura da Hugging Face, com cobrança pay-as-you-go, disponível para Pro e equipes/Enterprise; é necessária atualização de plano. blog Hugging Face
• Compatibilidade e transição: a maioria dos comandos do huggingface-cli deve parecer familiar; a migração pode ocorrer gradualmente. blog Hugging Face

Tabela – comparação rápida dos padrões antigos e novos

| Aspecto | CLI Antigo | NOVA CLI |---|---|---| | Padrão de comando | huggingface-cli | hf (com hf upload/download na raiz) |

Por que isso importa (impacto para desenvolvedores/empresas)

Para desenvolvedores, a reformulação da CLI reduz atrito ao aprender e usar as ferramentas da Hugging Face. O padrão hf facilita a previsão de nomes de comandos e a descoberta de capacidades por meio de —help. Destacar ações mais usadas na raiz acelera fluxos de trabalho. Para empresas e equipes, as melhorias de autenticação simplificam a gestão de múltiplos perfis locais, e a introdução do Hugging Face Jobs oferece uma opção escalável e paga por uso para executar código na infraestrutura da Hugging Face, sujeita à elegibilidade do plano. A transição cuidadosa, mantendo o huggingface-cli funcional com avisos, ajuda organizações a migrar no próprio ritmo, validando o novo CLI em fluxos de produção. blog Hugging Face

Detalhes técnicos ou Implementação

• Como começar: instale a versão mais recente do huggingface_hub, recarregue o terminal e verifique a instalação com hf version e explore com hf —help. Esses passos estabelecem o ambiente do novo CLI e revelam os grupos de comandos por recurso. blog Hugging Face
• Descoberta de comandos: comandos são agrupados por recurso (por exemplo, hf auth, hf cache, hf repo). Ações mais usadas aparecem na raiz como hf upload e hf download. Para aprofundar, adicione —help ao comando desejado. blog Hugging Face
• Mudanças de autenticação: todos os comandos de autenticação foram reunidos em hf auth, incluindo um mecanismo para alternar entre perfis locais e hf auth list para listar perfis. O CLI legada permanece disponível com avisos de migração. blog Hugging Face
• Hugging Face Jobs: novo comando dedicado, hf jobs, permite executar scripts ou imagens Docker na infraestrutura da Hugging Face usando a flavor de hardware escolhida. A cobrança é pay-as-you-go, e Jobs está disponível apenas para usuários Pro e organizações Team/Enterprise; é necessário atualizar o plano para acessar o recurso. A experiência de Jobs é descrita como inspirada no Docker. blog Hugging Face

Pontos-chave

• hf substitui o huggingface-cli com um padrão de comandos mais claro e consistente. blog Hugging Face
• A CLI agrupa comandos por recurso e mantém ações essenciais na raiz para acesso rápido. blog Hugging Face
• O huggingface-cli legado permanece utilizável, com avisos orientando a migração para o novo hf. blog Hugging Face
• O Hugging Face Jobs é introduzido como serviço pago por uso para Pro e acima, expandindo o que você pode executar na infraestrutura da Hugging Face. blog Hugging Face
• Para começar, instale o último huggingface_hub e verifique com hf version e hf —help. blog Hugging Face

Referências

• https://huggingface.co/blog/hf-cli