Migrasi ke huggingface_hub v2.0

huggingface_hub v2.0 mengganti dependensi HTTP-nya dengan httpx2 dan menghapus API 1.x yang sudah tidak didukung. Klien HTTP dan pengecualian kini berasal dari paket terpisah.

Untuk mendukung huggingface_hub v1.x (mulai dari v1.30.0) dan v2.x, impor modul HTTP dari 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:
    ...

Gunakan impor yang sama ini saat membuat klien kustom untuk set_client_factory() atau set_async_client_factory(). Klien dan pengecualian dari paket HTTP lama berbeda dari yang ada di httpx2 dan tidak dapat digunakan secara bergantian.

httpx2 menggunakan trust store sertifikat sistem operasi secara default. Bundel CA kustom yang dikonfigurasi dengan SSL_CERT_FILE atau SSL_CERT_DIR tetap didukung. Konfigurasi logging harus menargetkan httpx2 dan httpcore2 alih-alih nama logger lama. Lihat panduan migrasi upstream untuk detailnya.

Ekstra oauth sekarang membutuhkan authlib>=1.8.0 untuk dukungan httpx2.

API yang tidak didukung lagi telah dihapus

• Gunakan upload_folder alih-alih upload_large_folder atau HfApi.upload_large_folder.
• Gunakan duplicate_repo, set_space_volumes, dan delete_space_volumes sebagai pengganti duplicate_space, request_space_storage, dan delete_space_storage.
• Gunakan parse_hf_uri alih-alih repo_type_and_id_from_hf_id, dan list_models(search=...) alih-alih model_name=....
• Gunakan space_volumes alih-alih space_storage di create_repo dan duplicate_repo.
• Gunakan InferenceEndpointType.AUTHENTICATED atau type="authenticated" alih-alih PROTECTED atau type="protected".
• Gunakan text_generation(stop=...) alih-alih stop_sequences=..., dan berikan string token atau None ke InferenceClient alih-alih nilai boolean.
• Gunakan hf alih-alih huggingface-cli; hf repo dan hf repo-files delete diganti oleh hf repos dan hf repos delete-files.
• Gunakan hf upload alih-alih hf upload-large-folder; gunakan --volume alih-alih --storage untuk pembuatan dan duplikasi repositori, serta --status atau --label alih-alih hf jobs ps --filter.
• Opsi --claude yang tidak lagi didukung pada hf skills add dan hf skills update telah dihapus. Skills akan diinstal untuk Claude Code secara otomatis.

Untuk konteks lebih lanjut, lihat proyek httpx2, dokumentasi httpx2, panduan transisi upstream dari httpx ke httpx2, dan rencana transisi huggingface_hub.