Skip to main content

model-downloader-util

Download model files from local paths, HTTP(S), S3 / MinIO / RustFS, GCS, or Git LFS.

Install

pip install modeldownloaderutil

Usage

from modeldownloaderutil import download_model, resolve_model, sources

path = download_model("s3://bucket/models/weights.onnx")
path = download_model("https://example.com/model.onnx")
path = download_model("git+https://github.com/org/repo.git#weights/a.onnx")

# Try sources in order (first success wins):
path = download_model(sources(
    "rustfs://bucket/org/repo/weights/a.onnx",
    "git+https://github.com/org/repo.git#weights/a.onnx",
))
# same as:
path = download_model(
    "rustfs://bucket/org/repo/weights/a.onnx,git+https://github.com/org/repo.git#weights/a.onnx"
)

# Unpack zip archives and locate the weights file (.onnx, .pt, …):
path = resolve_model("s3://bucket/models/weights.onnx.zip")

Schemes

Scheme Example Notes
Local /path/to/model.onnx
HTTP(S) https://host/model.onnx
S3 s3://bucket/key MODEL_ACCESS_KEY / MODEL_SECRET_KEY
MinIO minio://bucket/key MINIO_ENDPOINT
RustFS rustfs://bucket/key RUSTFS_MODEL_ENDPOINT + access/secret
GCS gs://bucket/object
Git LFS git+https://host/org/repo.git#path

Environment

Variable Purpose
MODEL_CACHE_DIR Cache root
MODEL_DOWNLOAD_PROGRESS 0 to disable progress bars
RUSTFS_MODEL_ENDPOINT Required for rustfs://
RUSTFS_MODEL_ACCESS_KEY / RUSTFS_MODEL_SECRET_KEY Or MODEL_ACCESS_KEY / MODEL_SECRET_KEY
MINIO_ENDPOINT Required for minio://

Develop

make test
make build

Metadata

Release files for modeldownloaderutil 1.2.1

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for modeldownloaderutil 1.2.1
File Size Uploaded Provenance Actions
modeldownloaderutil-1.2.1.tar.gz 54.6 kB Without provenance Details for modeldownloaderutil-1.2.1.tar.gz

Built distribution (wheel)

Table of built distributions (wheels) for modeldownloaderutil 1.2.1
File Interpreter ABI Platform Actions
modeldownloaderutil-1.2.1-py3-none-any.whl Python 3 none any Details for modeldownloaderutil-1.2.1-py3-none-any.whl

Total release size: 71.7 kB

Release files / modeldownloaderutil-1.2.1.tar.gz

Download URL modeldownloaderutil-1.2.1.tar.gz
Size 54.6 kB
Tags Source
SHA-256 checksum
How to use checksums
c7cbd60c72e3543651c174e6542a3c115c362703aaae692197b47a986621e764
BLAKE2b-256 checksum
How to use checksums
3858cf76acf78f1da424b3d205db4a4daf3e3c50b80a368dbf26e5fae022453e
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via uv/0.12.5 {"installer":{"name":"uv","version":"0.12.5","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"24.04","id":"noble","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":true}

Release files / modeldownloaderutil-1.2.1-py3-none-any.whl

Download URL modeldownloaderutil-1.2.1-py3-none-any.whl
Size 17.1 kB
Tags Python 3
SHA-256 checksum
How to use checksums
e362097ca325afcffb07db2bad6f431ed052f890787fcda585bdac784c53b51d
BLAKE2b-256 checksum
How to use checksums
28fb86fc690e4879a0874a784428851bb4a80b7832280583a11194a445d07086
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via uv/0.12.5 {"installer":{"name":"uv","version":"0.12.5","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"24.04","id":"noble","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":true}

Security for modeldownloaderutil 1.2.1

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

No provenance found

None of the files in this release were uploaded with provenance metadata.

A note on package security

PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.

To learn more about protecting yourself from malicious actors, visit our package security documentation.

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page