Disponibilidade de material de apoio

Este texto do catálogo contém as orientações inline abaixo, mas não inclui os seguintes caminhos de suporte. Eles são pré-requisitos externos, não arquivos incluídos:

• <support-root>/references/hf_model_papers_auth.sh
• <support-root>/references/find_models_by_paper.sh
• <support-root>/references/hf_model_card_frontmatter.sh
• <support-root>/references/baseline_hf_api.sh
• <support-root>/references/baseline_hf_api.py
• <support-root>/references/baseline_hf_api.tsx
• <support-root>/references/hf_enrich_models.sh

Solicite o material de apoio original ou uma instalação existente antes de usar uma etapa que dependa desses caminhos; este catálogo não identifica uma fonte de download verificada para eles. Resolva cada caminho em relação a essa instalação, inspecione seu conteúdo e verifique quaisquer licenças e pré-requisitos de execução aplicáveis. Não execute um comando nem afirme que um procedimento referenciado foi seguido até que seu arquivo necessário exista. Não fabrique os scripts ausentes nem trate um arquivo não relacionado com o mesmo nome como equivalente. Etapas independentes totalmente documentadas aqui podem prosseguir dentro do escopo autorizado do usuário; relate qualquer etapa dependente como indisponível.

Construtor de Ferramentas da API Hugging Face

Seu propósito agora é criar scripts e utilitários de linha de comando reutilizáveis para usar a API Hugging Face, permitindo encadeamento, piping e processamento intermediário onde for útil. Você pode acessar a API diretamente, bem como usar a ferramenta de linha de comando hf. Cartões de modelos e conjuntos de dados podem ser acessados diretamente de repositórios.

Quando Usar

• Você precisa de scripts CLI reutilizáveis em torno da API Hugging Face ou da ferramenta de linha de comando hf.
• Você deseja utilitários amigáveis ao shell que suportem encadeamento, piping e processamento intermediário.
• Você está automatizando tarefas repetidas no Hub e precisa de uma interface compoível em vez de chamadas de API ad hoc.

Regras de Script

Certifique-se de seguir estas regras:

• Scripts devem aceitar um argumento de linha de comando --help para descrever suas entradas e saídas.
• Scripts não destrutivos devem ser testados antes de serem entregues ao Usuário.
• Scripts shell são preferidos, mas use Python ou TSX se a complexidade ou a necessidade do usuário exigir.
• IMPORTANTE: Use a variável de ambiente HF_TOKEN como um cabeçalho de Autorização. Por exemplo: curl -H "Authorization: Bearer ${HF_TOKEN}" https://huggingface.co/api/. Isso fornece limites de taxa mais altos e autorização apropriada para acesso a dados.
• Investigue a forma dos resultados da API antes de se comprometer com um design final; faça uso de piping e encadeamento onde a composibilidade seria uma vantagem - prefira soluções simples sempre que possível.
• Compartilhe exemplos de uso assim que concluídos.

Certifique-se de confirmar as preferências do Usuário quando houver perguntas ou esclarecimentos necessários.

Exemplos de Scripts

Os caminhos abaixo são relativos a este diretório de habilidade.

Exemplos de referência:

• references/hf_model_papers_auth.sh — usa HF_TOKEN automaticamente e encadeia tendências → metadados do modelo → análise do cartão do modelo com fallbacks; demonstra uso da API em várias etapas mais higiene de autenticação para conteúdo restrito/privado.
• references/find_models_by_paper.sh — uso opcional de HF_TOKEN via --token, pesquisa autenticada consistente e um caminho de repetição quando pesquisas com prefixo arXiv são muito restritas; mostra estratégia de consulta resiliente e ajuda clara voltada para o usuário.
• references/hf_model_card_frontmatter.sh — usa a CLI hf para baixar cartões de modelo, extrai frontmatter YAML e emite resumos NDJSON (licença, tag de pipeline, tags, flag de prompt restrito) para filtragem fácil.

Exemplos de linha de base (ultra-simples, lógica mínima, saída JSON bruta com cabeçalho HF_TOKEN):

• references/baseline_hf_api.sh — bash
• references/baseline_hf_api.py — python
• references/baseline_hf_api.tsx — typescript executável

Utilitário compoível (stdin → NDJSON):

• references/hf_enrich_models.sh — lê IDs de modelo do stdin, busca metadados por ID, emite um objeto JSON por linha para pipelines de streaming.

Composibilidade através de piping (saída JSON amigável ao shell):

• <support-root>/references/baseline_hf_api.sh 25 | jq -r '.[].id' | references/hf_enrich_models.sh | jq -s 'sort_by(.downloads) | reverse | .[:10]'
• <support-root>/references/baseline_hf_api.sh 50 | jq '[.[] | {id, downloads}] | sort_by(.downloads) | reverse | .[:10]'
• printf '%s\n' openai/gpt-oss-120b meta-llama/Meta-Llama-3.1-8B | references/hf_model_card_frontmatter.sh | jq -s 'map({id, license, has_extra_gated_prompt})'

Endpoints de Alto Nível

…