Repolode
huggingface

huggingface/huggingface_hub

CLI oficial (hf) e cliente Python para baixar, enviar e gerenciar repositórios no Hugging Face Hub.

Estrelas
3,990
Forks
1,285
Issues abertas
185
Último commit
há 15 horas

O que é?

huggingface_hub é a biblioteca Python oficial e a ferramenta de linha de comando do Hugging Face Hub, uma plataforma para hospedar modelos de machine learning, datasets e Spaces. Com ela, você pode baixar e enviar arquivos, criar e gerenciar repositórios, pesquisar no Hub, executar inferência em modelos implantados e iniciar jobs na infraestrutura da Hugging Face, tudo usando código Python ou o terminal.

O pacote oferece duas interfaces: a CLI hf para uso no shell, que pode ser instalada por um script independente ou via pip, e uma API Python com funções como hf_hub_download, snapshot_download, upload_file e upload_folder. Os arquivos baixados ficam armazenados em uma pasta de cache local, evitando que sejam baixados novamente em acessos posteriores.

A CLI também foi projetada para funcionar com agentes de programação e pode instalar uma skill de referência de comandos gerada para agentes como Claude Code, Codex e Cursor.

Recursos principais

  • 01Baixe arquivos individuais ou repositórios inteiros para um cache local.
  • 02Envie arquivos ou pastas para modelos, datasets e Spaces.
  • 03Crie e gerencie repositórios no Hub usando Python ou o terminal.
  • 04Pesquise modelos, datasets e Spaces no Hub.
  • 05Execute inferência em modelos implantados e inicie jobs na infraestrutura da Hugging Face.
  • 06Autentique-se com tokens de acesso ao Hub, inclusive em usos não interativos.

Casos de uso

  • Baixar pesos de modelos pré-treinados para um pipeline de treinamento ou inferência.
  • Publicar checkpoints de modelos ou datasets no Hub a partir de um script de treinamento.
  • Sincronizar pastas locais com um bucket de armazenamento do Hub usando o terminal ou um job de CI.
  • Permitir que agentes de programação interajam com repositórios do Hub pela CLI hf.

Início rápido

  1. 1

    Instalar o hf CLI (macOS e Linux)

    curl -LsSf https://hf.co/cli/install.sh | bash
  2. 2

    Iniciar sessão no Hub

    hf auth login
  3. 3

    Baixar um modelo

    hf download Qwen/Qwen3-0.6B

Antes de usar

  • É necessária uma conta e um token do Hugging Face para enviar ou gerenciar repositórios privados.

Tópicos

Perguntas frequentes

O que é huggingface_hub?
CLI oficial (hf) e cliente Python para baixar, enviar e gerenciar repositórios no Hugging Face Hub. huggingface_hub é a biblioteca Python oficial e a ferramenta de linha de comando do Hugging Face Hub, uma plataforma para hospedar modelos de machine learning, datasets e Spaces. Com ela, você pode baixar e enviar arquivos, criar e gerenciar repositórios, pesquisar no Hub, executar inferência em modelos implantados e iniciar jobs na infraestrutura da Hugging Face, tudo usando código Python ou o terminal.
huggingface_hub é gratuito? Qual é a licença?
huggingface_hub é open source sob a licença Apache-2.0. Confira os termos da licença antes de usá-lo em produtos comerciais.
huggingface_hub ainda é mantido?
Manutenção ativa. O último commit de huggingface_hub foi em 19 de out. de 2026.
Para que posso usar huggingface_hub?
Baixar pesos de modelos pré-treinados para um pipeline de treinamento ou inferência. Publicar checkpoints de modelos ou datasets no Hub a partir de um script de treinamento. Sincronizar pastas locais com um bucket de armazenamento do Hub usando o terminal ou um job de CI. Permitir que agentes de programação interajam com repositórios do Hub pela CLI hf.
Como instalar huggingface_hub?
Instalar o hf CLI (macOS e Linux): curl -LsSf https://hf.co/cli/install.sh | bash Iniciar sessão no Hub: hf auth login Baixar um modelo: hf download Qwen/Qwen3-0.6B
Onde consigo huggingface_hub?
O código-fonte e as instruções de instalação estão no GitHub: https://github.com/huggingface/huggingface_hub

Resumo gerado por IA a partir do README do projeto. As estatísticas do GitHub são atualizadas diariamente.

Projetos relacionados