huggingface-cli下载工具hc

Posted on Views:

hc 就是 huggingface-cli（Hugging Face CLI 工具）。
它其实是 huggingface_hub 这个 Python 包里带的命令行工具。

1.安装 huggingface-cli

1.1Linux / macOS / Windows (通用)

1
pip install -U huggingface_hub -i  https://mirrors.aliyun.com/pypi/simple/

安装完成后就能用：

1
huggingface-cli --help

2.配置镜像（国内环境推荐）

如果你在国内，建议先设置 Hugging Face 镜像，不然下载模型会卡。

2.1临时方式（当前会话有效）

  • Linux / macOS
1
export HF_ENDPOINT=https://hf-mirror.com
  • Windows PowerShell
1
$env:HF_ENDPOINT = "https://hf-mirror.com"
  • Windows CMD
1
set HF_ENDPOINT=https://hf-mirror.com

2.2永久方式（Windows）

1
[System.Environment]::SetEnvironmentVariable("HF_ENDPOINT", "https://hf-mirror.com", "User")

3.登录 Hugging Face

如果要下载私有模型，先登录：

1
huggingface-cli login

输入你的 Access Token（可在 https://huggingface.co/settings/tokens 获取）。

4.下载模型

例如下载 all-MiniLM-L6-v2：

1
huggingface-cli download sentence-transformers/all-MiniLM-L6-v2 --local-dir ./all-MiniLM-L6-v2

然后你在 Python 里就可以直接：

1
2
from sentence_transformers import SentenceTransformer
model = SentenceTransformer("./all-MiniLM-L6-v2")