hugging-face-cli

Quando Usar

Use esta ferramenta quando precisar do Hugging Face Hub CLI (hf) para baixar, enviar e gerenciar modelos, datasets, spaces, buckets, repositórios, artigos, jobs e mais no Hugging Face Hub. Use quando: estiver lidando com autenticação; gerenciando o cache local; gerenciando Hugging Face Buckets; executando ou agendando jobs no Hugging...

Instale baixando o script instalador primeiro, revisando-o e depois executando-o localmente: tmpdir="$(mktemp -d)" && trap 'rm -rf "$tmpdir"' EXIT && curl -LsSf https://hf.co/cli/install.sh -o "$tmpdir/hf-install.sh" && less "$tmpdir/hf-install.sh" && bash "$tmpdir/hf-install.sh"

A ferramenta Hugging Face Hub CLI 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.21.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] --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 — Imprime 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] --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 — Envia uma pasta grande para o Hub. Recomendado para envios que podem ser retomados. [--type [model|dataset|space] --revision TEXT --private --include TEXT --exclude TEXT --num-workers INTEGER --no-report --no-bars --format [auto|human|agent|json|quiet]]
• hf version — Imprime 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 — Imprime 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]]

…