pip install -U "huggingface_hub[cli]"

hf login          # 登录
hf whoami        # 查看当前用户
hf logout        # 登出

hf download <repo_id> [<filename>] [--local-dir <path>] [--include "pattern"]

hf download SCUT-DLVCLab/TongGu-7B-Instruct --local-dir ./TongGu-7B-Instruct

hf upload <repo_id> <local_path> [--repo-type model|dataset|space] [--path-in-repo <path>]

hf create-repo <repo_name> [--type model|dataset|space] [--private]  # 创建仓库
hf delete-repo <repo_id> [--type model|dataset|space]               # 删除仓库
hf repo-info <repo_id>                                              # 查看仓库信息
hf ls <repo_id>                                                     # 列出仓库文件

hf config set cache_dir /data/hf_cache   # 设置缓存路径
hf config list                           # 查看当前配置

hf space pause <repo_id>      # 暂停 Space
hf space restart <repo_id>    # 重启 Space
hf space info <repo_id>       # 查看 Space 状态

# 下载大型模型（断点续传 + 仅权重）
hf download SCUT-DLVCLab/TongGu-7B-Instruct \
  --local-dir ./TongGu-7B-Instruct \
  --include "*.safetensors" \
  --resume-download

# Dockerfile 中自动化使用
hf login --token $HF_TOKEN
hf download myusername/model-name --local-dir /models