跳到主要内容

命令行上传与下载

前置条件​

  • 拥有有效的 MatrixHub 账号。
  • 已加入目标项目，并具有模型仓库的读写权限（管理员或开发者权限）。
  • 本地已安装 Hugging Face CLI（hf 命令可用）。
  • 网络可以访问 MatrixHub 服务端点。

上传模型​

  1. 登录平台，进入 项目管理，选择目标项目。

  2. 打开 模型仓库 选项卡，点击 创建模型。

    创建模型

  3. 填写模型名称，确认创建，进入模型详情页。

    创建模型后

  4. 在本地终端中配置服务端点。

    export HF_ENDPOINT="https://<your-matrixhub-endpoint>"

  5. 使用 hf upload 上传本地模型目录。

    hf upload <project-name>/<model-name> ./<local-model-dir>

  6. 返回模型详情页并刷新，确认上传的文件出现在列表中。

    上传后

备注
  • 如果模型名称已被占用，请选择不同的名称重试。
  • 首次上传大模型可能需要一些时间；请耐心等待命令完成。

下载模型​

  1. 进入目标模型详情页，点击 下载模型。

  2. 从弹窗中复制下载命令，并在本地终端中执行。

    export HF_ENDPOINT="https://<your-matrixhub-endpoint>"
    hf download <project-name>/<model-name>

  3. 命令完成后，终端将输出下载目录路径。

  4. 打开本地下载目录，验证模型文件是否完整且可用。

代理项目上传与下载​

  1. 首先创建一个代理项目（例如：proxy-demo）。

  2. 在代理项目中创建模型后，您可以通过命令行对代理站点执行上传和下载操作。

    export HF_ENDPOINT="https://<your-matrixhub-endpoint>"

  3. 从代理项目下载模型（示例）。

    hf download proxy-project/Qwen3-ASR-0.6B

  4. 从映射到 Hugging Face 组织（如 prajjwal1）的代理项目下载模型（示例）。

    hf download prajjwal1/bert-tiny

  5. 将本地模型上传到代理项目（示例）。

    hf upload proxy-project/tiny-model ./<local-model-dir>
备注
  • 创建代理项目后，您可以使用 hf download 和 hf upload 访问代理站点的模型仓库。
  • hf upload 需要同时提供远程仓库和本地路径：hf upload <project>/<model> <local_path>。

模型文件​

模型文件界面

下载单个模型文件​

  1. 进入模型详情页，切换到 模型文件 选项卡。
  2. 在目标文件所在的行点击 下载。
  3. 浏览器完成下载后，打开文件以验证内容。

文件搜索与浏览​

  1. 使用 模型文件 页面中的搜索框输入关键字（例如：.git，tokenizer）。
  2. 观察过滤结果，确保返回的文件符合预期。
  3. 如果文件很多，点击 加载更多 查看完整列表。

分支/版本切换​

  1. 进入模型详情的 模型文件 页面。
  2. 在分支选择器中选择目标分支（例如：main，test）。
  3. 验证切换后的文件列表是否与该分支的内容一致。