v1.16.0
Breaking Changes📦 huggingface-hubView on GitHub →
⚠ 3 breaking✨ 8 features🐛 3 fixes🔧 12 symbols
Summary
This release introduces broad multimodal support for Together Inference Providers and centralizes hf:// URI parsing logic for consistency. Security and usability enhancements include hardened token file permissions and a new global CLI flag to prevent table truncation.
⚠️ Breaking Changes
- BucketUrl.handle has been renamed to BucketUrl.uri (type changed from str to HfUri, use .to_uri() for the string form).
- Volume.to_hf_handle() has been renamed to Volume.to_uri().
- Single-segment repo IDs (e.g. gpt2) are no longer supported in HfFileSystem paths or CLI -v flags; you must use the namespace/name format instead.
Migration Steps
- If using BucketUrl.handle, rename usage to BucketUrl.uri and use .to_uri() if the string form is required.
- If using Volume.to_hf_handle(), rename usage to Volume.to_uri().
- Ensure all single-segment repository IDs used in HfFileSystem paths or CLI -v flags are updated to the namespace/name format (e.g., change gpt2 to openai/gpt2).
✨ New Features
- Inference Providers now support five additional task types for Together: feature_extraction, text_to_speech, automatic_speech_recognition, image_to_image, and text_to_video.
- Centralized hf:// URI parsing logic using new public helpers: parse_hf_uri, parse_hf_mount, and is_hf_uri.
- The CLI now supports a global --no-truncate flag to disable shortening of scalar values in human-mode tables.
- CLI job inspection now surfaces runtime fields in ps + inspect commands.
- CLI now parses the initiator field on job API responses.
- CLI now supports hf:// URIs in cache rm command.
- CLI now exposes linked repos in PaperInfo.
- JobHardware now includes an ephemeral_storage field.
🐛 Bug Fixes
- Snapshot bar inflation during http_get retry in download process has been fixed.
- CLI error handler now catches HfUriError and displays a clean message instead of a raw traceback.
- CLI raises an error when both --local-dir and --cache-dir are provided.