# huggingface_hub v2.0으로 마이그레이션

`huggingface_hub` v2.0은 HTTP 의존성을 [`httpx2`](https://httpx2.pydantic.dev/)로 대체하고, 더 이상 사용되지 않는 1.x API를 제거합니다. HTTP 클라이언트와 예외는 이제 별도의 패키지에서 제공됩니다.

`huggingface_hub` v1.x(v1.30.0부터)과 v2.x를 모두 지원하기 위해 `huggingface_hub.utils`에서 HTTP 모듈을 가져옵니다:

```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:
    ...
```

[set_client_factory()](/docs/huggingface_hub/main/ko/package_reference/utilities#huggingface_hub.set_client_factory) 또는 [set_async_client_factory()](/docs/huggingface_hub/main/ko/package_reference/utilities#huggingface_hub.set_async_client_factory)에 대한 커스텀 클라이언트를 생성할 때에도 동일한 import를 사용하세요. 기존 HTTP 패키지의 클라이언트와 예외는 `httpx2`의 것과 구별되며, 서로 교환하여 사용할 수 없습니다.

`httpx2`는 기본적으로 운영 체제의 인증서 신뢰 저장소를 사용합니다. `SSL_CERT_FILE` 또는 `SSL_CERT_DIR`로 구성된 사용자 지정 CA 번들은 여전히 지원됩니다. 로깅 구성은 이전 로거 이름 대신 `httpx2`와 `httpcore2`를 대상으로 해야 합니다. 자세한 내용은 [업스트림 마이그레이션 가이드](https://httpx2.pydantic.dev/migration/)를 참조하세요.

`oauth` 추가 항목은 이제 `httpx2` 지원을 위해 `authlib>=1.8.0`을 요구합니다.

## 비추천 API 제거

- `upload_large_folder` 또는 `HfApi.upload_large_folder` 대신 `upload_folder`를 사용하세요.
- `duplicate_space`, `request_space_storage`, `delete_space_storage` 대신 `duplicate_repo`, `set_space_volumes`, `delete_space_volumes`를 사용하세요.
- `repo_type_and_id_from_hf_id` 대신 `parse_hf_uri`를, `model_name=...` 대신 `list_models(search=...)`를 사용하세요.
- `create_repo`와 `duplicate_repo`에서 `space_storage` 대신 `space_volumes`를 사용하세요.
- `PROTECTED` 또는 `type="protected"` 대신 `InferenceEndpointType.AUTHENTICATED` 또는 `type="authenticated"`를 사용하세요.
- `stop_sequences=...` 대신 `text_generation(stop=...)`를 사용하고, boolean 대신 토큰 문자열 또는 `None`을 `InferenceClient`에 전달하세요.
- `hf`를 `huggingface-cli` 대신 사용하세요. `hf repo`와 `hf repo-files delete`는 각각 `hf repos`와 `hf repos delete-files`로 대체되었습니다.
- `hf upload-large-folder` 대신 `hf upload`를, 저장소 생성 및 복제 시 `--storage` 대신 `--volume`를, 그리고 `hf jobs ps --filter` 대신 `--status` 또는 `--label`를 사용하세요.
- `hf skills add` 및 `hf skills update`의 비추천 `--claude` 옵션이 제거되었습니다. Skills는 Claude Code에 자동으로 설치됩니다.

자세한 내용은 [`httpx2` 프로젝트](https://github.com/pydantic/httpx2), [`httpx2` 문서](https://pydantic.dev/docs/httpx2/), [`httpx`에서 `httpx2`로의 전환 가이드](https://httpx2.pydantic.dev/migration/), 그리고 [`huggingface_hub` 전환 계획](https://github.com/huggingface/huggingface_hub/issues/4802)을 참고하세요.