hf-cli

Quando Usar

• Use quando o fluxo de trabalho anterior corresponder ao objetivo declarado do usuário.
• Use quando a tarefa exigir os procedimentos documentados nesta habilidade.

Instalar: curl -LsSf https://hf.co/cli/install.sh | bash -s. <!-- security-allowlist: curl-pipe-bash -->

A ferramenta CLI do Hugging Face Hub hf está disponível. IMPORTANTE: O comando hf substitui o comando obsoleto huggingface-cli.

Use hf --help para ver as funções disponíveis. Observe que os comandos de autenticação agora estão todos sob hf auth, por exemplo, hf auth whoami.

Gerado com huggingface_hub v1.32.0. Execute hf skills add --force para regenerar.

Comandos

• hf cp SRC — Copia arquivos entre caminhos locais, repositórios e buckets. [--format [auto|human|agent|json|quiet]]
• hf download REPO_ID — Baixa arquivos do Hub. [--type [model|dataset|space|kernel] --revision TEXT --include TEXT --exclude TEXT --cache-dir TEXT --local-dir TEXT --force-download --dry-run --max-workers INTEGER --format [auto|human|agent|json|quiet]]
• hf env — Exibe informações sobre o ambiente. [--format [auto|human|agent|json|quiet]]
• hf sync — Sincroniza arquivos entre um diretório local e um bucket. [--delete --ignore-times --ignore-sizes --plan TEXT --apply TEXT --dry-run --include TEXT --exclude TEXT --filter-from TEXT --existing --ignore-existing --verbose --format [auto|human|agent|json|quiet]]
• hf update — Atualiza a CLI hf para a versão mais recente. [--format [auto|human|agent|json|quiet]]
• hf upload REPO_ID — Envia um arquivo ou pasta para o Hub. Recomendado para envios de commit único. [--type [model|dataset|space|kernel] --revision TEXT --private --include TEXT --exclude TEXT --delete TEXT --commit-message TEXT --commit-description TEXT --create-pr --every FLOAT --format [auto|human|agent|json|quiet]]
• hf upload-large-folder REPO_ID LOCAL_PATH — [Obsoleto] Envia uma pasta grande para o Hub. Use hf upload em vez disso. [--type [model|dataset|space|kernel] --revision TEXT --private --include TEXT --exclude TEXT --num-workers INTEGER --no-report --no-bars --format [auto|human|agent|json|quiet]]
• hf version — Exibe informações sobre a versão do hf. [--format [auto|human|agent|json|quiet]]

hf auth — Gerencia a autenticação (login, logout, etc.).

• hf auth list — Lista todos os tokens de acesso armazenados. [--format [auto|human|agent|json|quiet]]
• hf auth login — Faz login a partir do seu navegador, ou usando um token de huggingface.co/settings/tokens. [--add-to-git-credential --force --format [auto|human|agent|json|quiet]]
• hf auth logout — Faz logout de um token específico. [--token-name TEXT --format [auto|human|agent|json|quiet]]
• hf auth switch — Alterna entre tokens de acesso. [--token-name TEXT --add-to-git-credential --format [auto|human|agent|json|quiet]]
• hf auth token — Exibe o token de acesso atual no stdout. [--format [auto|human|agent|json|quiet]]
• hf auth whoami — Descobre com qual conta do huggingface.co você está logado. [--format [auto|human|agent|json|quiet]]

hf buckets — Comandos para interagir com buckets.

• hf buckets cp SRC — Copia arquivos entre caminhos locais, repositórios e buckets. [--format [auto|human|agent|json|quiet]]
• hf buckets create BUCKET_ID — Cria um novo bucket. [--private --region [us|eu] --exist-ok --format [auto|human|agent|json|quiet]]
• hf buckets delete BUCKET_ID — Exclui um bucket. [--yes --missing-ok --format [auto|human|agent|json|quiet]]
• hf buckets info BUCKET_ID — Obtém informações sobre um bucket. [--format [auto|human|agent|json|quiet]]
• hf buckets list — Lista buckets ou arquivos em um bucket. [--human-readable --tree --recursive --search TEXT --format [auto|human|agent|json|quiet]]
• hf buckets move FROM_ID TO_ID — Move (renomeia) um bucket para um novo nome ou namespace. [--format [auto|human|agent|json|quiet]]
• hf buckets remove ARGUMENT — Remove arquivos de um bucket. [--recursive --yes --dry-run --include TEXT --exclude TEXT --format [auto|human|agent|json|quiet]]
• hf buckets settings BUCKET_ID — Atualiza as configurações do bucket (visibilidade). [--private --public --format [auto|human|agent|json|quiet]]
• hf buckets sync — Sincroniza arquivos entre um diretório local e um bucket. [--delete --ignore-times --ignore-sizes --plan TEXT --apply TEXT --dry-run --include TEXT --exclude TEXT --filter-from TEXT --existing --ignore-existing --verbose --format [auto|human|agent|json|quiet]]

hf cache — Gerencia o diretório de cache local.

…