modelscope 是什么?

ModelScope 是连接魔搭模型与数据仓库的 Python SDK,同时提供推理 pipeline、训练器、评测和多领域模型接口。它覆盖计算机视觉、自然语言、语音、多模态与科学计算;从 1.40 系列起,仓库和命令行相关能力更多由 modelscope-hub 包承担。

⭐ 8,833 Stars 🍴 927 Forks Python Apache-2.0 作者: modelscope
来源:github.com/modelscope/modelscope 查看 GitHub 仓库 → 📘 使用教程 →

为什么值得关注

保留教程的依据是官方在 2026-09-15 发布 v1.40.1,新增声学回声消除、语音分离和 Agent IDP、MCP/Studio 接口,并修复多项安装与上传问题。

来源:github.com/modelscope/modelscope/releases/tag/v1.40.1

核心功能

统一 pipeline

用任务名与模型标识创建推理 pipeline,模型下载、预处理、推理和后处理由对应实现负责。

来源:github.com/modelscope/modelscope/blob/master/README.md
训练与评测

提供 Trainer 与领域扩展,覆盖微调、评测及多种视觉、语言、语音和科学计算任务。

来源:github.com/modelscope/modelscope/blob/master/README.md
Hub 下载与版本控制

通过 modelscope-hub 查找、下载和上传模型或数据集,可指定 revision 并使用缓存;私有资源需要凭据。

来源:github.com/modelscope/modelscope/releases/tag/v1.40.0
Studio 与 MCP 接口

v1.40.1 增加 Agent 身份兼容接口和 MCP Server 部署、卸载方法,这些远程资源操作应与本地入门流程分开授权。

来源:github.com/modelscope/modelscope/releases/tag/v1.40.1

技术架构

ModelScope 用分层 API 连接 Hub 与任务运行层。Hub 层负责模型和数据集的查找、revision、下载及本地缓存;pipeline 根据任务和模型配置装配预处理、框架后端、模型与后处理;Trainer 负责训练和评测。不同领域通过可选 extra 与外部框架扩展。从 v1.40.0 起,modelscope 和 ms 命令行入口由 modelscope-hub>=0.3.0 提供,Studio/MCP 属于另一个远程操作面。

来源:github.com/modelscope/modelscope/blob/master/README.md

项目知识图谱

知识图谱:项目核心节点(中心)+ 核心功能(内环六边形)+ 关键技术依赖(外环 chip) 统一 pipeline 训练与评测 Hub 下载与版本控制 Studio 与 MCP 接口 modelscope 项目本体 核心功能 关键依赖

技术栈

语言Python
来源:github.com/modelscope/modelscope/blob/master/setup.py

快速上手

新建虚拟环境并安装 modelscope==1.40.1,再按任务选择 nlp、cv、audio 或 multi-modal extra,不要一次装全。先用 modelscope-hub 固定一个小型公开仓库的 revision,只检查元数据与下载清单;确认许可证、文件大小和自定义代码后,再运行官方 pipeline。默认保持 trust_remote_code 关闭,令牌只放环境变量或凭据存储。
来源:github.com/modelscope/modelscope/blob/master/README.md

使用场景

适合需要从魔搭 Hub 获取版本化模型、使用统一 pipeline 做推理、训练或评测,以及接入中文社区模型的团队。若只需要仓库上传下载,可以先用更窄的 hub 客户端;若模型包含远程 Python、插件或特殊框架,必须先隔离审查。模型缓存可能很大,私有仓库和远程部署还会涉及令牌与云端资源。

来源:github.com/modelscope/modelscope/blob/master/README.md

优势与局限

优势

  • Hub、推理、训练与评测使用同一套 Python 项目接口
  • 覆盖视觉、语言、语音、多模态和科学计算任务
  • 支持 revision 与本地缓存,便于记录模型来源
  • v1.40.1 继续增加音频模型和 Agent/MCP 接口

局限

  • 不同任务会拉入不同框架和大体积权重,安装组合需要单独锁定
  • 模型与数据集许可证不继承核心 SDK 的 Apache-2.0
  • trust_remote_code 或远程插件会执行仓库代码,必须审查来源
  • Studio 与 MCP 部署会触及远程资源、身份和密钥,不应沿用本地试验权限
  • 官方示例能跑通不等于模型在业务数据上准确或安全
来源:github.com/modelscope/modelscope/blob/master/README.md

最新版本

官方最新 GitHub Release 为 v1.40.1,发布于 2026-09-15,对应提交 906b793。该版加入 JAEC 原生推理 pipeline、两种 8 kHz 双人语音分离模型、Agent IDP 与 MCP/Studio OpenAPI 兼容接口,并修复 OpenEuler、x86 依赖和上传环境问题。

来源:github.com/modelscope/modelscope/releases/tag/v1.40.1

实测与证据

status: official_source_checked_not_installed_or_run  |  checked_at: 2026-09-23  |  environment: 核对官方 README、setup.py、v1.40.1 与相关安全修复发布说明;未安装 SDK、未登录 Hub、未下载模型、未运行 pipeline 或远程部署  |  limitations: 未验证依赖解析、模型缓存大小、推理速度与质量、私有仓库鉴权、trust_remote_code、Studio 或 MCP 的权限行为  |  observed_output: 官方最新版本为 v1.40.1,发布于 2026-09-15,对应提交 906b793;v1.40.0 起 modelscope/ms 命令行由 modelscope-hub>=0.3.0 提供

来源:github.com/modelscope/modelscope/releases/tag/v1.40.1

同类项目对比

相比官方 huggingface_hub,ModelScope 不只处理仓库、令牌、revision 与缓存,还把多领域 pipeline、Trainer 和评测放在同一项目中;huggingface_hub 更专注 Hugging Face Hub 的仓库与客户端操作,模型推理通常交给 Transformers 等库。只做文件下载和上传时选对应 Hub 客户端;需要魔搭任务 pipeline 或训练器时再引入 ModelScope 的领域依赖。

来源:github.com/modelscope/modelscope (1) · github.com/huggingface/huggingface_hub (2)

总结评价

ModelScope 适合围绕魔搭 Hub 做模型下载、任务推理和训练评测。先锁 SDK 与模型 revision,只装单个任务的依赖,关闭远程代码并核对许可证;远程 Studio/MCP 操作应使用另一套最小权限凭据。

来源:github.com/modelscope/modelscope/blob/master/README.md

常见问题

安装 modelscope 就包含所有任务依赖吗?

不包含。核心包之外,视觉、语言、语音和多模态任务各有可选依赖,模型还可能要求特定 PyTorch、TensorFlow 或系统库。应按一个任务安装并锁定版本。

为什么要固定模型 revision?

模型标识指向的文件可能更新。固定 revision 才能复现同一份配置、权重和自定义代码;同时记录文件清单与许可证,避免只锁 SDK 版本却让模型内容漂移。

ModelScope 的 trust_remote_code 可以默认开启吗?

不可以。它可能执行模型仓库里的 Python 或插件代码。先保持关闭,确有需要时审查固定 revision 的文件,并在无生产令牌、限制网络和写权限的环境运行。

下载的模型都能用于商业项目吗?

不能由 ModelScope 的 Apache-2.0 代码许可证推断。每个模型、数据集和依赖都有自己的许可证或使用条件,下载、微调、再分发和托管 API 都要分别核对。

v1.40.1 的 MCP 部署接口适合直接在本机试吗?

先不要把它并进入本地入门步骤。部署与卸载会操作远程资源,并涉及身份、签名令牌和密钥轮换;应使用单独测试账号、最小权限和明确的资源回收记录。

资料与核验范围
本文依据项目公开资料整理。版本、安装命令和功能边界可能随上游更新,请以所列来源和项目当前版本为准。 资料核对时间: 2026-09-23 13:55.

参考材料:README、GitHub API、依赖文件