huggingface_hub v2.0'e geçiş

huggingface_hub v2.0, HTTP bağımlılığını httpx2 ile değiştirir ve kullanımdan kaldırılmış 1.x API'lerini kaldırır. HTTP istemcileri ve istisnalar artık ayrı bir paketten gelir.

huggingface_hub v1.x (v1.30.0 ile başlayan) ve v2.x sürümlerini desteklemek için HTTP modülünü huggingface_hub.utils içinden içe aktarın:

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

Özel istemciler oluştururken set_client_factory() veya set_async_client_factory() için bu aynı import'u kullanın. Eski HTTP paketindeki istemciler ve istisnalar, httpx2 içindekilerden farklıdır ve birbirinin yerine kullanılamaz.

httpx2 varsayılan olarak işletim sisteminin sertifika güven deposunu kullanır. SSL_CERT_FILE veya SSL_CERT_DIR ile yapılandırılan özel CA demetleri hâlâ desteklenmektedir. Kayıt yapılandırması, eski kayıtçı adları yerine httpx2 ve httpcore2 hedeflenmelidir. Ayrıntılar için yukarıdaki geçiş kılavuzuna bakın.

oauth eklentisi artık httpx2 desteği için authlib>=1.8.0 gerektirir.

Kullanımdan kaldırılmış API'ler kaldırıldı

• upload_large_folder veya HfApi.upload_large_folder yerine upload_folder kullanın.
• duplicate_space, request_space_storage ve delete_space_storage yerine duplicate_repo, set_space_volumes ve delete_space_volumes kullanın.
• repo_type_and_id_from_hf_id yerine parse_hf_uri ve model_name=... yerine list_models(search=...) kullanın.
• create_repo ve duplicate_repo içinde space_storage yerine space_volumes kullanın.
• PROTECTED veya type="protected" yerine InferenceEndpointType.AUTHENTICATED veya type="authenticated" kullanın.
• stop_sequences=... yerine text_generation(stop=...) kullanın ve bir boolean yerine InferenceClient için bir token dizgesi veya None iletin.
• hf kullanın, huggingface-cli yerine; hf repo ve hf repo-files delete komutları hf repos ve hf repos delete-files ile değiştirildi.
• hf upload-large-folder yerine hf upload kullanın; depolama oluşturma ve çoğaltma için --storage yerine --volume ve hf jobs ps --filter yerine --status veya --label kullanın.
• hf skills add ve hf skills update komutlarındaki kullanımı durdurulmuş --claude seçeneği kaldırıldı. Beceriler artık Claude Code için otomatik olarak yüklenir.

Daha fazla bağlam için httpx2 projesine, httpx2 belgelerine, httpx’ten httpx2’ye geçiş kılavuzuna ve huggingface_hub geçiş planına bakın.