modelscope-hub
The official Python client to connect with ModelScope Hub.
Decision gist · record as of 2026-08-14
Yes. The package is actively maintained, has low install friction, carries a permissive license, and solves a concrete problem for anyone working with ModelScope Hub assets. Recent releases show active bug fixes and error-handling improvements. No known vulnerabilities. Install if you need to programmatically or via CLI download, upload, or manage models and datasets on ModelScope Hub.AI-flagged interpretation of the facts on this page — verify before relying
Before you install
- Requires Python 3.10 or later.
- ModelScope API token needed for authenticated operations (obtain from modelscope.cn/my/access/token or modelscope.ai/my/access/token).
- Low friction install with four runtime dependencies (requests, tqdm, filelock, urllib3).
License · maintenance · safety
Apache-2.0 (permissive) — Apache-2.0 permissive license — you can use, modify, and distribute freely, including in commercial projects, provided you include the license notice.
last release 2026-08-01 (13 days)
0 known vulnerabilities (OSV.dev, 2026-08-14) · 4,102,610 downloads/mo, #2,379 on PyPI
Alternatives
Verify before relying
pip install modelscope-hub
from modelscope_hub import HubApi
api = HubApi(token="your-token")
path = api.download_file("Qwen/Qwen3-0.6B", "model", "config.json")- Whether the package handles authentication errors transparently across different ModelScope endpoints (v0.2.0 mentions endpoint probing but scope unclear).
- Performance characteristics of parallel range download for very large files (description mentions it but no benchmarks provided).
- Whether offline mode (local_files_only=True) works reliably across all repo types (models, datasets, studios, skills, MCP servers).
What it is and what it does
modelscope-hub is the official Python SDK and CLI for interacting with ModelScope Hub, a repository hosting many AI models and datasets. It provides a single HubApi class and ms-hub command-line tool that unify operations across models, datasets, Studio spaces, skills, and MCP servers. The package handles the full lifecycle: authentication, downloading individual files or entire snapshots with resume capability and integrity checks, uploading files and folders, creating and managing repositories, and inspecting cached assets.
The package is built on ModelScope's OpenAPI surface with transparent fallback to legacy APIs for backward compatibility. Downloads include production-grade features like HTTP Range resume, parallel range download for large files, per-file retry with backoff, SHA256 verification, file locking for multiprocess safety, offline mode, and progress callbacks. The CLI supports filtering by file patterns, direct local-directory downloads that bypass the cache, and full repository lifecycle management including secret management and cache inspection.
Use it for
- Download pre-trained models with pattern filtering to get only specific file types (e.g., .safetensors weights).
- Upload trained model weights or datasets to a personal or organizational ModelScope repository with commit messages and folder organization.
- Integrate ModelScope asset downloads into training or inference pipelines using the HubApi class with custom progress callbacks.
- Manage repository metadata, visibility, and gating settings from the CLI without visiting the web interface.
- Access cached models offline using local_files_only=True after an initial download, useful in air-gapped or low-bandwidth environments.
- Deploy MCP servers or Studio spaces and manage their operational URLs and environment variables from the terminal.
Worth the install?
AI-flagged interpretation of the facts on this page. Verify before relying on it.
Yes.
The package is actively maintained, has low install friction, carries a permissive license, and solves a concrete problem for anyone working with ModelScope Hub assets. Recent releases show active bug fixes and error-handling improvements. No known vulnerabilities. Install if you need to programmatically or via CLI download, upload, or manage models and datasets on ModelScope Hub.
Install
modelscope-hub on PyPI
Before you install
Low friction install with four runtime dependencies (requests, tqdm, filelock, urllib3). Active maintenance — v0.2.0 released 2026-08-01 with bug fixes and error-handling improvements. Supports Python 3.10 through 3.14.
Requires Python 3.10 or later. ModelScope API token needed for authenticated operations (obtain from modelscope.cn/my/access/token or modelscope.ai/my/access/token).
License in practice
Apache-2.0 permissive license — you can use, modify, and distribute freely, including in commercial projects, provided you include the license notice.
Quickstart
pip install modelscope-hub
from modelscope_hub import HubApi
api = HubApi(token="your-token")
path = api.download_file("Qwen/Qwen3-0.6B", "model", "config.json")Verify before relying
- Whether the package handles authentication errors transparently across different ModelScope endpoints (v0.2.0 mentions endpoint probing but scope unclear).
- Performance characteristics of parallel range download for very large files (description mentions it but no benchmarks provided).
- Whether offline mode (local_files_only=True) works reliably across all repo types (models, datasets, studios, skills, MCP servers).
Package facts
| License | Apache-2.0 permissive |
| Python support | Supports the current Python release >=3.10 |
| Install friction | Low. Pure-Python wheel |
| Runtime dependencies | 4 packagesrequeststqdmfilelockurllib3 |
| Maintenance | Actively maintained 13 days since the last release |
| First released | |
| Downloads | 4,102,610 / month, #2,379 on PyPI 30-day window, as of 2026-08-14 |
| Known vulnerabilities | None known OSV.dev, checked 2026-08-14 |
| Classifiers | Development Status :: 3 - AlphaIntended Audience :: DevelopersLicense :: OSI Approved :: Apache Software LicenseProgramming Language :: Python :: 3Programming Language :: Python :: 3.10Programming Language :: Python :: 3.11Programming Language :: Python :: 3.12Programming Language :: Python :: 3.13Programming Language :: Python :: 3.14Topic :: Scientific/Engineering :: Artificial Intelligence |
Evidence: modelscope_hub-0.2.0-py3-none-any.whl
Tags
Let your AI agent find packages like this
Example. Real query, live index.
You found this page by searching. An agent finds it by wishing: SkillFed indexes 14,416 PyPI packages by what they can do, searchable in plain language.
wish › “modelscope hub client”
- modelscope-hubDownload, upload, and manage AI models, datasets, and other assets on…
- modelscopeModelScope provides unified Python interfaces for inference,…
- azure-mgmt-eventhubManages Azure Event Hub resources—namespaces, hubs, consumer groups,…
Give your agent the search over MCP, or paste the wish link into any chat.
More Artificial Intelligence packages
LiteLLM provides a unified Python interface to call 100+ LLM providers (OpenAI, Anthropic, Gemini, Bedrock, Azure, and others) using OpenAI-compatible API format, available as both a Python SDK and a self-hosted AI Gateway proxy server.
Install it if you need to work with multiple LLM providers or want to centralize LLM routing in your organization.
Client library and CLI tool for downloading, uploading, and managing models, datasets, and repositories on the Hugging Face Hub platform.
Install it if you work with Hugging Face Hub models or datasets.
LangChain provides a framework for building agents and LLM-powered applications by composing language models, tools, and memory through a unified API that abstracts over multiple model providers.
hf-xet provides chunk-based deduplication and efficient file transfer for the Hugging Face Hub, enabling faster uploads and downloads of large files with local disk caching.
Tokenizers converts raw text into token sequences for NLP models, with support for training custom vocabularies and using pre-built tokenizers (BPE, WordPiece) optimized for speed via Rust.
Transformers provides a unified framework for loading, fine-tuning, and running state-of-the-art pretrained models across text, vision, audio, video, and multimodal tasks using PyTorch, JAX, or TensorFlow.
Install it if you need to run or train any transformer-based model for NLP, vision, audio, or multimodal tasks.
See also modelscope · spaces · hf · pephubclient · azureml · lightning-sdk · agentscope · tensorflow-hub · sagemaker-serve