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.pyandscan.py). Parts of that code were lifted from this package. Each worker'shugpy-wrapperdiscovers, hashes, serves and pulls its own model files (fitevict/serve/transfer.py,worker_pull.pyanddrives.py).- What still imports it.
hugpy-media's runners (embed,keywords,summarizers,imagegen,vision_analysis,tts) callhugpy_storage.download_models.ensure_modelfor in-process local inference. After the operator-approved change of 2026-10-15 (hugpy-media 0.3.4 and later), that import is lazy andhugpy-storageis the optional extrahugpy-media[local].hugpy-engineloses 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-workerdepends on it, and is retired.- Where it is installed. Until the change lands, 0.2.10 is installed in
/opt/hugpy-media/venvand/opt/hugpy-video/venvas a dependency ofhugpy-media0.3.3. No unit runshugpy-storageorhugpy-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)
| File | Size | Uploaded | Provenance | |
|---|---|---|---|---|
| hugpy_storage-0.2.16.tar.gz | 289.7 kB | Without provenance | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| 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.