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).

Development Status
- 3 - Alpha
Intended Audience
- Developers
Operating System
- OS Independent
Programming Language
- Python :: 3
- Python :: 3 :: Only
Topic
- Scientific/Engineering :: Artificial Intelligence

Metadata

Development Status
- 3 - Alpha
Intended Audience
- Developers
Operating System
- OS Independent
Programming Language
- Python :: 3
- Python :: 3 :: Only
Topic
- Scientific/Engineering :: Artificial Intelligence

Release files for hugpy-storage 0.2.15

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.15
File	Size	Uploaded	Provenance
hugpy_storage-0.2.15.tar.gz	289.7 kB	Oct 20, 2026	Without provenance	Details

Built distribution (wheel)

Table of built distributions (wheels) for hugpy-storage 0.2.15
File	Interpreter	ABI	Platform	Reset
hugpy_storage-0.2.15-py3-none-any.whl 284.5 kB Oct 20, 2026 Without provenance	Python 3	none	any	Details

Total release size: 574.2 kB

Release files / hugpy_storage-0.2.15.tar.gz

Download URL	hugpy_storage-0.2.15.tar.gz
Size	289.7 kB
Tags	Source
SHA-256 checksum How to use checksums	`838efde13598b39c12c638d649de208b8757597ef238a6b679ab52191f2160ba`
BLAKE2b-256 checksum How to use checksums	`0afcdd0d8901fa64312c18edb6ae5db1ac1e668593e94839e3edef3a373ca9e3`
Upload date	Oct 20, 2026
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.15-py3-none-any.whl

Download URL	hugpy_storage-0.2.15-py3-none-any.whl
Size	284.5 kB
Tags	Python 3
SHA-256 checksum How to use checksums	`26cc6bc8f5a710ec9030c861196a33078f8dc90cba9239e387ba9e08e2c9b49b`
BLAKE2b-256 checksum How to use checksums	`4c9e080656a1150157fbeb14015caed0b003e24ef3c05fab571927e891d2ce91`
Upload date	Oct 20, 2026
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.15

Report project as malware

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.