Chuyển sang huggingface_hub v2.0

huggingface_hub v2.0 thay thế phụ thuộc HTTP bằng httpx2 và loại bỏ các API 1.x đã bị ngừng hỗ trợ. Các client HTTP và ngoại lệ giờ đây được lấy từ một gói riêng biệt.

Để hỗ trợ cả huggingface_hub v1.x (bắt đầu từ v1.30.0) và v2.x, hãy import module HTTP từ 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:
    ...

Sử dụng cùng lệnh import này khi tạo các client tùy chỉnh cho set_client_factory() hoặc set_async_client_factory(). Các client và ngoại lệ từ gói HTTP cũ là khác biệt so với những thứ trong httpx2 và không thể thay thế cho nhau.

httpx2 sử dụng kho lưu trữ chứng chỉ tin cậy của hệ điều hành theo mặc định. Các gói CA tùy chỉnh được cấu hình bằng SSL_CERT_FILE hoặc SSL_CERT_DIR vẫn được hỗ trợ. Cấu hình ghi log nên nhắm đến httpx2 và httpcore2 thay vì các tên logger cũ. Xem hướng dẫn di chuyển upstream để biết thêm chi tiết.

Extra oauth hiện yêu cầu authlib>=1.8.0 để hỗ trợ httpx2.

Đã xóa các API không còn được hỗ trợ

• Sử dụng upload_folder thay vì upload_large_folder hoặc HfApi.upload_large_folder.
• Sử dụng duplicate_repo, set_space_volumes và delete_space_volumes thay vì duplicate_space, request_space_storage và delete_space_storage.
• Sử dụng parse_hf_uri thay vì repo_type_and_id_from_hf_id, và list_models(search=...) thay vì model_name=....
• Sử dụng space_volumes thay vì space_storage trong create_repo và duplicate_repo.
• Sử dụng InferenceEndpointType.AUTHENTICATED hoặc type="authenticated" thay vì PROTECTED hoặc type="protected".
• Sử dụng text_generation(stop=...) thay vì stop_sequences=..., và truyền một chuỗi token hoặc None cho InferenceClient thay vì một giá trị boolean.
• Sử dụng hf thay vì huggingface-cli; hf repo và hf repo-files delete được thay thế bằng hf repos và hf repos delete-files.
• Sử dụng hf upload thay vì hf upload-large-folder; sử dụng --volume thay vì --storage cho việc tạo và nhân bản kho, và --status hoặc --label thay vì hf jobs ps --filter.
• Tùy chọn --claude đã bị hủy bỏ trong hf skills add và hf skills update đã được gỡ bỏ. Các Skills sẽ được cài đặt tự động cho Claude Code.

Để có thêm ngữ cảnh, hãy xem dự án httpx2, tài liệu httpx2, hướng dẫn chuyển đổi từ httpx sang httpx2 của upstream, và kế hoạch chuyển đổi huggingface_hub.