Migrando para o huggingface_hub v2.0

huggingface_hub v2.0 substitui sua dependência de HTTP por httpx2 e remove as APIs 1.x obsoletas. Os clientes HTTP e as exceções agora vêm de um pacote separado.

Para suportar tanto o huggingface_hub v1.x (a partir da v1.30.0) quanto o v2.x, importe o módulo HTTP de huggingface_hub.utils:

from huggingface_hub.utils import get_session, httpx

try:
    response = get_session().get("https://huggingface.co/api/models/gpt2")
    response.raise_for_status()
except httpx.HTTPError:
    ...

Use este mesmo import ao criar clientes personalizados para set_client_factory() ou set_async_client_factory(). Os clientes e exceções do antigo pacote HTTP são distintos dos em httpx2 e não podem ser usados de forma intercambiável.

httpx2 usa a loja de confiança de certificados do sistema operacional por padrão. Bundles de CA personalizados configurados com SSL_CERT_FILE ou SSL_CERT_DIR ainda são suportados. A configuração de log deve visar httpx2 e httpcore2 em vez dos nomes antigos de logger. Consulte o guia de migração upstream para detalhes.

O extra oauth agora requer authlib>=1.8.0 para suporte a httpx2.

Removidas as APIs obsoletas

• Use upload_folder em vez de upload_large_folder ou HfApi.upload_large_folder.
• Use duplicate_repo, set_space_volumes e delete_space_volumes em vez de duplicate_space, request_space_storage e delete_space_storage.
• Use parse_hf_uri em vez de repo_type_and_id_from_hf_id, e list_models(search=...) em vez de model_name=....
• Use space_volumes em vez de space_storage em create_repo e duplicate_repo.
• Use InferenceEndpointType.AUTHENTICATED ou type="authenticated" em vez de PROTECTED ou type="protected".
• Use text_generation(stop=...) em vez de stop_sequences=... e passe uma string de token ou None para InferenceClient em vez de um booleano.
• Use hf em vez de huggingface-cli; hf repo e hf repo-files delete foram substituídos por hf repos e hf repos delete-files.
• Use hf upload em vez de hf upload-large-folder; use --volume em vez de --storage para criação e duplicação de repositórios, e --status ou --label em vez de hf jobs ps --filter.
• A opção --claude descontinuada em hf skills add e hf skills update foi removida. As skills são instaladas automaticamente para o Claude Code.

For more context, see the httpx2 project, the httpx2 documentation, the upstream transition guide from httpx to httpx2, and the huggingface_hub transition plan.