Change8

v1.4.0

📦 huggingface-hubView on GitHub →
10 features🔧 16 symbols

Summary

This release introduces significant CLI enhancements, including a new `hf skills add` command for AI assistants and new commands for managing papers and collections. It also adds a decentralized evaluation results module with corresponding Python helpers and improves job execution support for multi-GPU training.

Migration Steps

  1. If using AI coding assistants, run `hf skills add --<agent_name>` (e.g., `hf skills add --claude`) to enable new Hub interaction capabilities.
  2. Users interacting with evaluation results programmatically should use the new `EvalResultEntry`, `eval_result_entries_to_yaml()`, and `parse_eval_result_entries()` helpers.

✨ New Features

  • Introduced the `hf skills add` CLI command to install the `hf-cli` skill for AI coding assistants (Claude Code, Codex, OpenCode), enabling capabilities like Hub searching, model downloading, and Job management.
  • The `hf-cli` skill is installed to a central `.agents/skills/hf-cli/` directory with relative symlinks created for agent-specific directories to ensure a single source of truth.
  • Improved CLI help output organization, grouping commands into 'Main commands' and 'Help commands', and adding 'Examples' and 'Learn more' sections.
  • Implemented a decentralized system for tracking model evaluation results where benchmark datasets host leaderboards and model repos store scores in `.eval_results/*.yaml` files.
  • Added Python helpers in `huggingface_hub` to work with evaluation results: `EvalResultEntry` dataclass, `eval_result_entries_to_yaml()`, and `parse_eval_result_entries()`.
  • Added `hf papers ls` command to list daily papers on the Hub, supporting filtering by date and sorting.
  • Added `hf collections` commands (`ls`, `create`, `add-item`, `info`, `delete`) for managing collections via CLI.
  • Added support for multi-GPU training commands using `torchrun` and `accelerate launch` via `hf jobs uv run`.
  • Added `hf jobs uv run` support for passing local configuration files alongside scripts.
  • Introduced `hf jobs hardware` command to list available hardware options for jobs, including specs and pricing.

Affected Symbols