Skip to main content

hugpy-storage

STATUS: OPTIONAL, not part of the live fleet path (2026-10-15). Nothing live runs this package's downloader, sync or inventory role.

  • What replaced it. Central's Hub downloader, central drives, copies and transfers live in hugpy-core (hugpy_core/basic/downloads.py, drives.py and scan.py). Parts of that code were lifted from this package. Each worker's hugpy-wrapper discovers, hashes, serves and pulls its own model files (fitevict/serve/transfer.py, worker_pull.py and drives.py).
  • What still imports it.
    • hugpy-media's runners (embed, keywords, summarizers, imagegen, vision_analysis, tts) call hugpy_storage.download_models.ensure_model for in-process local inference. After the operator-approved change of 2026-10-15 (hugpy-media 0.3.4 and later), that import is lazy and hugpy-storage is the optional extra hugpy-media[local].
    • hugpy-engine loses its last lazy uses in the same change (0.3.9 and later; see hugpy_engine).
    • Core's legacy Flask app (hugpy_core/web/, registry/, relay/) imports it. That app is not live, and core's venv does not install this package.
    • hugpy-worker depends on it, and is retired.
  • Where it is installed. Until the change lands, 0.2.10 is installed in /opt/hugpy-media/venv and /opt/hugpy-video/venv as a dependency of hugpy-media 0.3.3. No unit runs hugpy-storage or hugpy-downloader.

See docs/packages.md.

Distribution hugpy-storage 0.2.10, import hugpy_storage. Dependencies: abstract_essentials, huggingface_hub>=0.20, requests>=2.28, pydantic>=2, flask>=2. Extras: engine (hugpy-engine), test.

What it contains

This package holds bytes at rest and in transit, as designed for the pre-basic "orbit" runtime:

module role
downloader/ (daemon, queue, engine, presence) the model download queue and daemon
download_models.py ensure_model(key), download_one, ensure_models. On a worker (WORKER_CENTRAL_URL set) ensure_model resolves the model locally or from central and never reaches Hugging Face.
provision.py, model_sync.py, transfer_api.py resumable central and Hugging Face transfer, model sync, the legacy transfer blueprint
huggingface_api.py, hf_token.py, hf_metadata.py, model_metadata.py Hugging Face transport and token
model_physical.py, model_status_cache.py, model_presence.py physical inventory and its caches
model_paths.py, hugpy_marker.py, gguf_inspect.py, format_select.py the on-disk model layout and hugpy.json markers
catalog_source.py, providers.py, events.py seams to the layers above: the model registry Protocol, budget gate, transfer telemetry, catalog.changed
api.py the legacy Flask blueprint (hugpy.api: storage entry point)
console/, schemas/, _lifted/, deploy/hugpy-downloader-dev.service console-side helpers, schemas, lifted helpers, the old dev unit file

Console scripts:

  • hugpy-storage (daemon, sync, status)
  • hugpy-downloader, an alias for the download daemon

No unit runs either on the live hosts.

docs/REGISTRY-DB-INDEX.md records the 2026-09-10 decision to keep hugpy.json markers as the per-model source of truth and to rebuild any aggregate index from them. The wrapper's marker store follows the same rule.

This package has no imports/ layer (see the convention).

Metadata

Release files for hugpy-storage 0.2.16

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

Source distribution (sdist)

Source distribution for hugpy-storage 0.2.16
File Size Uploaded Provenance
hugpy_storage-0.2.16.tar.gz 289.7 kB Without provenance Details

Built distribution (wheel)

Table of built distributions (wheels) for hugpy-storage 0.2.16
File Interpreter ABI Platform
hugpy_storage-0.2.16-py3-none-any.whl Python 3 none any Details

Total release size: 574.2 kB

Release files / hugpy_storage-0.2.16.tar.gz

Download URL hugpy_storage-0.2.16.tar.gz
Size 289.7 kB
Tags Source
SHA-256 checksum
How to use checksums
be6758fcf6dee85541d6578a8b877ec41bb25f152381d9ce2e3247016944e2d1
BLAKE2b-256 checksum
How to use checksums
dd5a39356a5e908d0415d8e69d529c07238e3b5d9c5184f97942d831969139a6
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/7.0.0 CPython/3.12.3

Release files / hugpy_storage-0.2.16-py3-none-any.whl

Download URL hugpy_storage-0.2.16-py3-none-any.whl
Size 284.5 kB
Tags Python 3
SHA-256 checksum
How to use checksums
ff6a810a1ebbebf34e3b5b2d8492ea8e25c997c464b7dc40b79a1a77f4caf677
BLAKE2b-256 checksum
How to use checksums
c63d37b065b1d6b352dee9ec43634f76d3b370c80464b7c2ab83e30e4fb90807
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/7.0.0 CPython/3.12.3

Security for hugpy-storage 0.2.16

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