---
title: "平台常见问题"
canonical_url: "https://www.modelscope.cn/docs/faq/common"
md_url: "https://www.modelscope.cn/docs/faq/common.md"
---

Source: https://www.modelscope.cn/docs/faq/common

---
本文整理了 ModelScope 模型使用过程中遇到的常见问题，希望能够通过此文档为您解答使用过程中的疑惑。

### Q1：ModelScope 社区平台的模型支持商用吗？<br>

开源的模型商用需要遵循开源协议，具体可参考下对应的模型的开源协议。

### Q2：pip install 的时候有些包下载特别慢怎么办？<br>

在国内 pip 安装的时候，如果默认是用海外的 pypi 源的话，可能因为网络问题，下载速度受限。建议在国内可以通过"-i [https://pypi.tuna.tsinghua.edu.cn/simple](https://pypi.tuna.tsinghua.edu.cn/simple)" 的命令行选项，来配置仓库来源使用"清华源"。例如：

```shell
pip install "modelscope[nlp]" -f https://modelscope.oss-cn-beijing.aliyuncs.com/releases/repo.html -i https://pypi.tuna.tsinghua.edu.cn/simple
```

### Q3：用 git 拉取模型到本地，发现模型文件和远程仓库文件大小不一致，是什么问题？<br>

因部分文件使用 lfs 进行存储，需要先安装 lfs 工具。请检查下是否没有安装 git lfs（pip list|grep lfs），如果没有安装，请使用 git lfs install 命令安装。具体可参见模型详情页的【快速使用】页面。

### Q4：我的系统目前是 Windows，使用某模型的时候报错，是什么问题？<br>

ModelScope 框架本身支持 Windows 环境的运行。但是平台上多种多样的模型，本身难免会有一些模型会部分依赖于系统环境，从而影响在 Windows 上的兼容性。 一方面您通过 ModelScope 网站上提供的 notebook 环境试用，另一方面，对于少数在 Windows 需要单独配置的模型，可以通过创建 windows linux subsystem 来模拟 Linux 环境，或者根据具体三方依赖包的官方网站说明，来在 Windows 环境下多独立安装。

### Q5：ModelScope 模型的使用依赖于互联网连接吗？<br>

ModelScope 通过 Model Hub 和 Dataset Hub 来进行模型和数据集的管理和版本管理。因此要获取最好的用户体验，我们建议尽量在联网环境下使用。这能确保您使用的模型和数据集都能是最新的版本，获取最好的模型和数据集。另一方面，如果您使用 ModelScope 开源模型的环境没有网络连接，那也可以通过将模型下载到本地，再从本地直接加载的方式来使用。具体范例如下：
第一步：拉取模型数据到本地：

```python
from modelscope.hub.snapshot_download import snapshot_download
path = snapshot_download('damo/cv_convnextTiny_ocr-recognition-general_damo')
print(path)
```

第二步：然后把模型数据（即 path 文件夹的内容），拷贝到一个新的本地路径 new_path.
第三部：通过本地路径来加载模型，构建 pipeline。

```python
 ocr_recognition = pipeline(Tasks.ocr_recognition, model=new_path)
```

注意：这里需要再次强调的是，使用这种方式如果社区有模型有更新的话，则无法直接检测到。

### Q6：环境 mac os x86,系统 Ventura 13 Beta 13，环境安装报错“missing xcrun at: /Library/Developer/CommandLineTools/usr/bin/xcrun”<br>

MBP 新环境碰到这个问题，您需要执行 xcode-select --install。

### Q7：基础大模型下载下来之后如何支持下游模型？<br>

针对大模型您可以尝试 zeroshot，fine tune 后会有更好的表现。

### Q8：多卡环境，如何指定卡推理？<br>

推理可以传递参数 device，pipeline 参数: device 设置 'gpu:0' 即可。

### Q9：zero-shot 分类模型可以用下游的自己的数据作微调吗？<br>

可以。如果您的数据 label 变化较大，出于追求模型效果，classifier 可以 init weight 处理。如果您的数据 label 变化不大，可以直接在 classifier 上继续微调。

### Q10：在哪里可以看得到 ModelScope 教程和实战资料？<br>

您可以查看 ModelScope 实战训练营，点击报名后即可查看所有录制的视频课程。

### Q11：ModelScope 有没有已经搭好的 docker 镜像，以及我应该在哪里下载使用？<br>

ModelScope 提供 GPU 镜像和 CPU 镜像，具体可在[环境安装](https://www.modelscope.cn/docs/intro/environment-setup)内查看最新版本镜像信息。

### Q12：ModelScope 是否支持算法评测？<br>

目前 API 支持单个模型的 finetune 和评测，批量评测功能还在持续建设中，您暂时可以写个脚本来实现。关于算法评测，可以参考[这里](https://www.modelscope.cn/docs/sdk/tutorials/model-evaluation)。

### Q13：ModelScope 是否会推出纯离线的 SDK 版本？<br>

现在模型大部分还是需要基于服务端的算力支持，纯端上的模型的剪枝和转化可以需要用一些工具来解决，这部分工具能力还在规划开放中。

### Q14：通过 SDK 上传数据集或模型时，报错“requests.exceptions.HTTPError: 400 Client Error: Bad Request for url:”怎么办？<br>

您可以先检查下当前的 Library 版本，确认下是否为最新。然后检查下采用的 token 是否为 访问令牌（Access Token）。若还不能解决该问题，请联系官方协助您解决。

### Q15：使用官方镜像，但加载模型过程中会存在报错，应该怎么解决？

您可以先通过 pip list 等方式，对照[环境安装](https://www.modelscope.cn/docs/intro/environment-setup)内版本号看当前镜像是否为最新版本，若非最新版本，可更新后重试。若重试依然无法解决问题，请通过官方钉钉群联系我们。

### Q16: 模型大文件上传遇到问题如何解决？

模型文件一般都比较大，我们通过 git lfs 管理模型中的大文件，首先确保您安装了正确版本的 git-lfs, 另外请确保您的大文件在文件列表中(.gitattributes 文件).
如果 `Git`提交时产生`error：RPC失败。HTTP 413 curl 22 The requested URL returned error:413`报错，你需要通过`git reset`重置缓冲区，并手动跟踪所有超过 5 MB 的文件后再提交。
