К основному содержанию
скилл CX Codex

hugging-face-cli · patchy631 — скилл для Claude Code: что делает и как установить

Скилл hugging-face-cli для Claude Code управляет Hugging Face Hub через hf: скачивает модели и датасеты, загружает файлы и запускает облачные задачи.

MIT ★ 42 059 обновлён 2026-10-12

Установить в Claude Code · Через Skills CLI (Vercel) Все способы и платформы ↓
npx skills add patchy631/ai-engineering-hub --skill hugging-face-cli -a claude-code
Открыть на GitHub

Что делает hugging-face-cli

Скилл ориентирует агента в командах hf для входа в аккаунт, скачивания файлов и репозиториев, загрузки содержимого и управления репозиториями. Можно запросить сведения о моделях, датасетах и Spaces, а также просмотреть и очистить локальный кэш.

Для облачных задач предусмотрены команды запуска, просмотра логов и отмены; для Inference Endpoints — развёртывание и управление. Например, GPU-задача запускается с указанием flavor, такого как a10g-small. Для доступа к Hub предусмотрены команды входа и проверки текущего пользователя; способ авторизации стоит выбрать до приватных операций.

Какие задачи решает

  • скачать модель целиком или выбрать файлы по шаблону
  • загрузить папку в репозиторий модели или датасета
  • создать репозиторий, ветку или тег на Hub
  • найти кэшированные репозитории и удалить ревизии
  • запустить задачу на CPU или GPU и проверить её логи

Примеры запросов агенту

  • Скачай репозиторий модели в ./models с помощью hf.
  • Загрузи папку ./output в мой репозиторий на Hugging Face.
  • Запусти script.py на CPU через Hugging Face Jobs и покажи логи.

Как установить hugging-face-cli

1Через Skills CLI (Vercel)

npx skills add patchy631/ai-engineering-hub --skill hugging-face-cli -a claude-code

2Вручную: положить файлы

~/.claude/skills/hugging-face-cli/SKILL.md

Папка скилла целиком; для одного проекта — .claude/skills/hugging-face-cli/

По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов

Вопросы о hugging-face-cli

Как установить hugging-face-cli в Claude Code?

Выполните npx skills add patchy631/ai-engineering-hub --skill hugging-face-cli -a claude-code. Файл скилла находится по пути ~/.claude/skills/hugging-face-cli/SKILL.md.

Что делает hugging-face-cli?

Помогает выполнять операции Hugging Face Hub через hf: управлять репозиториями и кэшем, скачивать и загружать файлы, запускать облачные задачи.

Как запустить GPU-задачу через hugging-face-cli?

Используйте hf jobs run --flavor a10g-small <image> <cmd>, указав образ и команду. Статус можно посмотреть через hf jobs ps, а логи — через hf jobs logs <job_id>.

Исходный текст

SKILL.md · MIT
---
name: hugging-face-cli
description: Execute Hugging Face Hub operations using the `hf` CLI. Use when the user needs to download models/datasets/spaces, upload files to Hub repositories, create repos, manage local cache, or run compute jobs on HF infrastructure. Covers authentication, file transfers, repository creation, cache operations, and cloud compute.
---

# Hugging Face CLI

The `hf` CLI provides direct terminal access to the Hugging Face Hub for downloading, uploading, and managing repositories, cache, and compute resources.

## Quick Command Reference

| Task | Command |
|------|---------|
| Login | `hf auth login` |
| Download model | `hf download <repo_id>` |
| Download to folder | `hf download <repo_id> --local-dir ./path` |
| Upload folder | `hf upload <repo_id> . .` |
| Create repo | `hf repo create <name>` |
| Create tag | `hf repo tag create <repo_id> <tag>` |
| Delete files | `hf repo-files delete <repo_id> <files>` |
| List cache | `hf cache ls` |
| Remove from cache | `hf cache rm <repo_or_revision>` |
| List models | `hf models ls` |
| Get model info | `hf models info <model_id>` |
| List datasets | `hf datasets ls` |
| Get dataset info | `hf datasets info <dataset_id>` |
| List spaces | `hf spaces ls` |
| Get space info | `hf spaces info <space_id>` |
| List endpoints | `hf endpoints ls` |
| Run GPU job | `hf jobs run --flavor a10g-small <image> <cmd>` |
| Environment info | `hf env` |

## Core Commands

### Authentication
```bash
hf auth login                    # Interactive login
hf auth login --token $HF_TOKEN  # Non-interactive
hf auth whoami                   # Check current user
hf auth list                     # List stored tokens
hf auth switch                   # Switch between tokens
hf auth logout                   # Log out
```

### Download
```bash
hf download <repo_id>                              # Full repo to cache
hf download <repo_id> file.safetensors             # Specific file
hf download <repo_id> --local-dir ./models         # To local directory
hf download <repo_id> --include "*.safetensors"    # Filter by pattern
hf download <repo_id> --repo-type dataset          # Dataset
hf download <repo_id> --revision v1.0              # Specific version
```

### Upload
```bash
hf upload <repo_id> . .                            # Current dir to root
hf upload <repo_id> ./models /weights              # Folder to path
hf upload <repo_id> model.safetensors              # Single file
hf upload <repo_id> . . --repo-type dataset        # Dataset
hf upload <repo_id> . . --create-pr                # Create PR
hf upload <repo_id> . . --commit-message="msg"     # Custom message
```

### Repository Management
```bash
hf repo create <name>                              # Create model repo
hf repo create <name> --repo-type dataset          # Create dataset
hf repo create <name> --private                    # Private repo
hf repo create <name> --repo-type space --space_sdk gradio  # Gradio space
hf repo delete <repo_id>                           # Delete repo
hf repo move <from_id> <to_id>                     # Move repo to new namespace
hf repo settings <repo_id> --private true          # Update repo settings
hf repo list --repo-type model                     # List repos
hf repo branch create <repo_id> release-v1         # Create branch
hf repo branch delete <repo_id> release-v1         # Delete branch
hf repo tag create <repo_id> v1.0                  # Create tag
hf repo tag list <repo_id>                         # List tags
hf repo tag delete <repo_id> v1.0                  # Delete tag
```

### Delete Files from Repo
```bash
hf repo-files delete <repo_id> folder/             # Delete folder
hf repo-files delete <repo_id> "*.txt"             # Delete with pattern
```

### Cache Management
```bash
hf cache ls                      # List cached repos
hf cache ls --revisions          # Include individual revisions
hf cache rm model/gpt2           # Remove cached repo
hf cache rm <revision_hash>      # Remove cached revision
hf cache prune                   # Remove detached revisions
hf cache verify gpt2             # Verify checksums from cache
```

### Browse Hub
```bash
# Models
hf models ls                                        # List top trending models
hf models ls --search "MiniMax" --author MiniMaxAI  # Search models
hf models ls --filter "text-generation" --limit 20  # Filter by task
hf models info MiniMaxAI/MiniMax-M2.1               # Get model info

# Datasets
hf datasets ls                                      # List top trending datasets
hf datasets ls --search "finepdfs" --sort downloads # Search datasets
hf datasets info HuggingFaceFW/finepdfs             # Get dataset info

# Spaces
hf spaces ls                                        # List top trending spaces
hf spaces ls --filter "3d" --limit 10               # Filter by 3D modeling spaces
hf spaces info enzostvs/deepsite                    # Get space info
```

### Jobs (Cloud Compute)
```bash
hf jobs run python:3.12 python script.py           # Run on CPU
hf jobs run --flavor a10g-small <image> <cmd>      # Run on GPU
hf jobs run --secrets HF_TOKEN <image> <cmd>       # With HF token
hf jobs ps                                         # List jobs
hf jobs logs <job_id>                              # View logs
hf jobs cancel <job_id>                            # Cancel job
```

### Inference Endpoints
```bash
hf endpoints ls                                     # List endpoints
hf endpoints deploy my-endpoint \
  --repo openai/gpt-oss-120b \
  --framework vllm \
  --accelerator gpu \
  --instance-size x4 \
  --instance-type nvidia-a10g \
  --region us-east-1 \
  --vendor aws
hf endpoints describe my-endpoint                   # Show endpoint details
hf endpoints pause my-endpoint                      # Pause endpoint
hf endpoints resume my-endpoint                     # Resume endpoint
hf endpoints scale-to-zero my-endpoint              # Scale to zero
hf endpoints delete my-endpoint --yes               # Delete endpoint
```
**GPU Flavors:** `cpu-basic`, `cpu-upgrade`, `cpu-xl`, `t4-small`, `t4-medium`, `l4x1`, `l4x4`, `l40sx1`, `l40sx4`, `l40sx8`, `a10g-small`, `a10g-large`, `a10g-largex2`, `a10g-largex4`, `a100-large`, `h100`, `h100x8`

## Common Patterns

### Download and Use Model Locally
```bash
# Download to local directory for deployment
hf download meta-llama/Llama-3.2-1B-Instruct --local-dir ./model

# Or use cache and get path
MODEL_PATH=$(hf download meta-llama/Llama-3.2-1B-Instruct --quiet)
```

### Publish Model/Dataset
```bash
hf repo create my-username/my-model --private
hf upload my-username/my-model ./output . --commit-message="Initial release"
hf repo tag create my-username/my-model v1.0
```

### Sync Space with Local
```bash
hf upload my-username/my-space . . --repo-type space \
  --exclude="logs/*" --delete="*" --commit-message="Sync"
```

### Check Cache Usage
```bash
hf cache ls                      # See all cached repos and sizes
hf cache rm model/gpt2           # Remove a repo from cache
```

## Key Options

- `--repo-type`: `model` (default), `dataset`, `space`
- `--revision`: Branch, tag, or commit hash
- `--token`: Override authentication
- `--quiet`: Output only essential info (paths/URLs)

## References

- **Complete command reference**: See [references/commands.md](references/commands.md)
- **Workflow examples**: See [references/examples.md](references/examples.md)

© patchy631 · MIT · patchy631/ai-engineering-hub

Похожие скиллы

Все скиллы по теме «ИИ и ML» →

Сначала — hugging-face-cli от других авторов.

hugging-face-cli huytran1120 Скилл hugging-face-cli для Claude Code помогает агенту работать с Hugging Face Hub через утилиту hf. Управляет загрузкой моделей, датасетов, бакетов и локальным кэшем. CX Codex +1 ★ 85звёзд репо Hugging Face huggingface Сервер помогает искать модели, датасеты, Spaces и научные статьи на Hugging Face, а также находить документацию и создавать изображения. CX Codex +1 2 405установок hugging-face-jobs sickn33 Настраивает, тестирует и запускает вычисления на CPU, GPU и TPU в Hugging Face Jobs. Выполняет пакетную генерацию, инференс и обработку датасетов с сохранением на Hub. CX Codex +1 1установок hugging-face-ui-skills design-skills Скилл hugging-face-ui-skills для Claude Code задаёт правила оформления интерфейсов в стиле Hugging Face. Он включается при создании тёмных экранов с Inter и сеткой отступов 4px. CX Codex +1 266установок face-swap prime-skills Скилл face-swap подменяет лицо персонажа в видео или фотографиях через RunComfy CLI. Автоматически выбирает нужную модель: для видео с аудио, для одного кадра или пакета, для сохранения движения или идентичности. CX Codex +1 390 600установок hugging-science K-Dense-AI Ищет и оценивает научные датасеты, модели и интерактивные демо в каталоге Hugging Science. Индексирует ресурсы по 17 научным областям: от протеинов и геномов до астрономии и дифференциальных уравнений. CX Codex +1 2 000установок eachlabs-face-swap eachlabs Скилл eachlabs-face-swap для Claude Code, Cursor, Codex и других платформ, который меняет лица на фотографиях и видео через EachLabs AI. Агент отправляет запрос к API и получает готовое изображение. CX Codex +1 348установок

Из того же набора6

hugging-face-model-trainer Скилл hugging-face-model-trainer помогает запускать обучение и дообучение языковых моделей через TRL на Hugging Face Jobs. Подходит для облачных GPU и конвертации моделей в GGUF. CX Codex +1 1установок hugging-face-jobs Помогает запускать Python-задачи в Hugging Face Jobs — от обработки данных до экспериментов на GPU. Переносит вычисления из локального окружения в облако. CX Codex +1 ★ 42 059звёзд репо hugging-face-evaluation Скилл hugging-face-evaluation добавляет результаты оценки моделей в model cards на Hugging Face. Извлекает таблицы бенчмарков из README, импортирует данные через Artificial Analysis API, запускает эвалюацию с vLLM или lighteval. CX Codex +1 ★ 42 059звёзд репо hugging-face-datasets Скилл hugging-face-datasets для создания, наполнения и обработки датасетов на Hugging Face Hub с помощью SQL-запросов через DuckDB без полной загрузки файлов на диск. CX Codex +1 ★ 42 059звёзд репо brightdata-web-mcp Скилл brightdata-web-mcp для поиска в интернете, парсинга сайтов и извлечения данных через Bright Data. Обходит блокировки и CAPTCHA, работает с Amazon, eBay, LinkedIn, Instagram. CX Codex +1 ★ 42 059звёзд репо

Спонсоры проекта

Компании, которые помогают держать аналитику открытой