hf CLI: Um CLI Hugging Face mais rápido e amigável com Jobs

Visão geral

O Hugging Face renomeou oficialmente o CLI de huggingface-cli para hf. A mudança visa melhorar a ergonomia e a clareza, reorganizando os comandos em uma estrutura guiada por recursos. O novo padrão é hf , com comandos de raiz como hf upload e hf download, previstos como alguns dos mais usados. O CLI foi projetado para ser previsível e fácil de descobrir, preparando o terreno para funcionalidades futuras, mantendo a compatibilidade com o huggingface-cli legando para facilitar a migração. Uma motivação importante é simplificar como as funções são acessadas à medida que novas capacidades são adicionadas (upload, download, cache, gerenciamento de repositórios, etc.). Uma adição notável é o comando dedicado para Hugging Face Jobs. Jobs permite executAR scripts ou imagens Docker na Infraestrutura do Hugging Face usando o hardware de sua escolha. A cobrança de Jobs é baseada no uso, e o acesso é limitado a usuários Pro e organizações Team ou Enterprise. O CLI adota fortemente o estilo de comando do Docker para soar familiar aos desenvolvedores. Para começar a experimentar, você deve instalar a versão mais recente do huggingface_hub, reiniciar o terminal e testar comandos básicos como hf version e hf —help. Se você já utilizou o huggingface-cli, a maioria dos comandos parecerá familiar, mas a nova organização torna a autenticação e outras tarefas comuns mais coerentes. Para ver como o novo CLI está organizado, você pode pensar em termos de grupos de recursos como hf auth, hf cache, hf repo, etc., com a exceção importante de hf upload e hf download que são apresentados na raiz para acesso rápido.

Principais recursos

hf substitui o huggingface-cli por uma interface mais rápida e ergonômica.
Comandos seguem o padrão previsível: hf .
Comandos na raiz para ações mais utilizadas, incluindo hf upload e hf download.
Grupos de comandos como hf auth, hf cache, hf repo organizam a funcionalidade por recurso.
O huggingface-cli legando permanece ativo e totalmente funcional para facilitar a migração, com um aviso apontando para os equivalentes de hf.
Um comando dedicado hf jobs permite executar scripts ou imagens Docker na Infra do Hugging Face.
Jobs é cobrado sob um modelo pay-as-you-go e está disponível para usuários Pro e organizações Team ou Enterprise.
O design do CLI é inspirado no Docker, visando familiaridade e facilidade de aprendizado.
Autenticação reformulada: todos os comandos de autenticação são agrupados sob hf auth, incluindo hf auth list para listar perfis locais.
Após a instalação, reinicie o terminal para que o hf seja reconhecido e verifique com comandos como hf version e hf —help.

Observação: se você utilizou o CLI legado, verá avisos que orientam para os equivalentes de hf.

Casos de uso comuns

Autenticar com vários perfis locais usando hf auth e hf auth list.
Gerenciar caches locais e referências de repositório com hf cache e hf repo.
Enviar ou baixar artefatos rapidamente usando hf upload e hf download na raiz.
Explorar a nova estrutura do CLI com hf —help e aprofundar-se em qualquer recurso com —help.
Iniciar e gerenciar Jobs na Infraestrutura do Hugging Face com hf jobs (condicionado ao plano).
Fazer a transição gradual do huggingface-cli, usando o CLI legado com interrupções mínimas enquanto adota a nova sintaxe de hf.

Instalação & configuração

Para começar, instale a versão mais recente do huggingface_hub e recarregue a sessão do terminal. A linha exata de comando de instalação não é fornecida no trecho, mas a orientação enfatiza atualizar o huggingface_hub e reiniciar o terminal antes de testar.

# comando de instalação exata não fornecido no trecho de fonte

Após a instalação, teste a configuração:

hf version
hf --help

Você também pode verificar o estado da autenticação e perfis:

hf auth list

Se desejar explorar o Jobs:

hf jobs --help

Quick start (exemplo mínimo)

Instale o huggingface_hub mais recente e reinicie o terminal.
Verifique a instalação:

Execute hf version para confirmar o CLI disponível.
Execute hf —help para ver a estrutura de comandos por recurso.

Liste os perfis locais com hf auth list.
Use comandos da raiz para tarefas comuns, como upload ou download:

hf upload (comando raiz)

Se estiver em um plano Pro/Team/Enterprise, explore Jobs com hf jobs —help para entender como iniciar scripts ou imagens Docker na infraestrutura do HF. Observação: os comandos exatos de instalação não são apresentados no trecho fornecido; siga a orientação de atualizar o huggingface_hub e reiniciar o terminal para começar.

Prós e contras

Prós:
CLI mais limpo e previsível com a estrutura hf .
Comandos na raiz facilitam tarefas comuns.
Serviço dedicado de Jobs oferece execução em nuvem com cobrança por uso.
O CLI legando permanece disponível para minimizar interrupções durante a migração.
O design inspirado no Docker facilita o aprendizado.
Contras:
Novas funcionalidades exigem atualização para o huggingface_hub mais recente e podem trazer avisos de migração.
Acesso a Jobs é limitado a planos Pro e superiores, com cobrança por uso.
Para usuários com rotinas muito dependentes do layout antigo, a migração pode exigir adaptação.

Alternativas (comparação breve)

| Aspecto | huggingface-cli (legado) | hf (novo) |---|---|---| | Padrão de comando | comandos específicos por função | hf ; estrutura mais uniforme |Ações na raiz | não enfatizado | hf upload e hf download expostos na raiz |Autenticação | comandos de autenticação podem variar | autenticação reorganizada sob hf auth, hf auth list para perfis locais |Caminho de migração | ativo com avisos | legado permanece disponível durante a transição |Suporte a Jobs | não destacado | hf jobs para execução de scripts/containers na infra do HF |

Pricing ou Licença

Jobs do Hugging Face estão disponíveis apenas para usuários Pro e organizações Team ou Enterprise. A cobrança de Jobs é pay-as-you-go, ou seja, você paga apenas pelos segundos de uso.