# Migrando para o huggingface_hub v2.0

`huggingface_hub` v2.0 substitui sua dependência de HTTP por [`httpx2`](https://httpx2.pydantic.dev/) 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`:

```python
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()](/docs/huggingface_hub/main/pt/package_reference/utilities#huggingface_hub.set_client_factory) ou [set_async_client_factory()](/docs/huggingface_hub/main/pt/package_reference/utilities#huggingface_hub.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](https://httpx2.pydantic.dev/migration/) 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](https://github.com/pydantic/httpx2), the [`httpx2` documentation](https://pydantic.dev/docs/httpx2/), the upstream [transition guide from `httpx` to `httpx2`](https://httpx2.pydantic.dev/migration/), and the [`huggingface_hub` transition plan](https://github.com/huggingface/huggingface_hub/issues/4802).

