Hugging Face CLI para Agentes de IA

O CLI hf é uma ótima maneira de conectar seus agentes ao Hugging Face Hub e ao ecossistema. Pesquise modelos, gerencie datasets e buckets, inicie Spaces e execute jobs a partir de qualquer agente de codificação.

Este é um guia rápido sobre agentes que usam a CLI. Para informações mais detalhadas, consulte a própria Referência da CLI.

Instale o CLI

Verifique se o CLI hf está instalado e atualizado. Consulte o guia de instalação do CLI para as instruções de configuração.

O instalador standalone recomendado também instala o CLI Skill globalmente, incluindo a localização do Claude Code, para que os agentes o reconheçam sem etapas adicionais. Passe --exclude-skill (ou -ExcludeSkill no Windows) para ignorá-lo.

Adicione a Skill de CLI

Skills fornecem ao seu agente o contexto necessário para usar ferramentas de forma eficaz. O instalador independente adiciona a Skill de CLI para você — instale-a manualmente se você usou pip ou Homebrew, a pulou ou deseja tê-la em um único projeto. Saiba mais sobre Skills em agentskills.io.

# install globally (available in all projects, works with Claude Code, Codex, Cursor,
# OpenCode, and any agent that loads skills from ~/.agents/skills)
hf skills add --global

# or install for the current project only
hf skills add

A Skill é gerada a partir da versão do CLI instalada localmente, portanto ela fica desatualizada quando você faz um upgrade. hf update atualiza uma Skill instalada globalmente — sem recriar uma que você removeu — e hf skills update -g a atualiza de forma independente. hf avisa uma vez por dia se a Skill estiver ausente ou desatualizada; para silenciar essa notificação, use HF_HUB_DISABLE_UPDATE_CHECK=1.

Alternativamente, você pode instalar por meio do sistema de plugins do Claude Code:

claude
/plugin marketplace add huggingface/skills
/plugin install hf-cli@huggingface-skills

Recursos

• Referência da CLI - Documentação completa de comandos
• Configurações de tokens - Gerencie seus tokens
• Documentação de Jobs - Guia de jobs de computação