下载模型

下载方式概览

平台支持以下三种方式下载模型文件：

方式	适用场景
HTTPS Git Clone	通用下载，适合所有用户
SSH Git Clone	配置 SSH 密钥后免密下载
csghub-cli 命令行	支持断点续传，适合大模型下载

前置条件

下载包含大文件（如 .safetensors、.bin）的模型仓库前，需要安装 Git LFS：

# 安装 Git LFS（macOS）
brew install git-lfs

# 安装 Git LFS（Ubuntu/Debian）
sudo apt-get install git-lfs

# 初始化 Git LFS
git lfs install

使用 HTTPS 下载

# 克隆模型仓库（会自动下载 LFS 文件）
git lfs install
git clone https://<平台地址>/<命名空间>/<模型名称>

若需要身份验证（私有模型），使用访问令牌：

git clone https://<用户名>:<访问令牌>@<平台地址>/<命名空间>/<模型名称>

如需跳过大文件下载，仅获取仓库结构：

GIT_LFS_SKIP_SMUDGE=1 git clone https://<平台地址>/<命名空间>/<模型名称>

使用 SSH 下载

在平台 个人设置 → SSH 密钥 中添加您的 SSH 公钥后，可使用 SSH 方式克隆：

git lfs install
git clone ssh://git@<平台地址>/<命名空间>/<模型名称>

使用 csghub-cli 下载

csghub-cli 支持断点续传，适合网络不稳定环境下下载大型模型。

安装 csghub-cli：

pip install csghub-sdk

下载模型：

# 下载整个模型仓库
csghub-cli download <命名空间>/<模型名称> --repo_type model

# 下载指定分支或版本
csghub-cli download <命名空间>/<模型名称> --repo_type model --revision main

使用 Python SDK 下载

from pycsghub.snapshot_download import snapshot_download

# 下载模型到本地缓存目录
model_path = snapshot_download(
    repo_id="<命名空间>/<模型名称>",
    repo_type="model",
    endpoint="https://<平台地址>",
    token="<访问令牌>"  # 私有模型需要
)
print(f"模型已下载到: {model_path}")

备注

访问令牌可在平台 个人设置 → 访问令牌 中生成。