Skip to main content

Hugging Bay Python SDK

This source is the unpublished hugging-bay 0.4.13 candidate for Python 3.9 or newer. It corrects shared retry hints and read pacing in SwarmClient, retains find_model(..., snapshot=...), hardware and memory filters, and the optional oneAnswer finder verdict. Version 0.4.12 is already on PyPI. Pip installs the package's dependencies, including httpx and cryptography.

Install in a virtual environment with python -m pip install 'hugging-bay==0.4.12', then import Client from hugging_bay; see the Python quickstart. Public catalog reads need no account or token.

Read the catalog

Use Client for search, repository resolution, artifact records and download plans. Search returns rows; use a returned row's id for later requests. Keep nextCursor unchanged with the same query and filters for pagination.

A download plan describes file availability and recorded hashes. A catalog match or a hosted file does not establish a complete model, hardware compatibility, quality or permission to use it. Inspect the current plan and license before downloading; compare downloaded bytes with the expected hash.

Public response note

Hugging Bay responses include this sentence in note.summary: Downloadable doesn't mean tested: this record says whether the exact file can be downloaded now, not that the model is complete or that it runs. Current clients should read note, downloadable, and downloadStatus. Older clients that still need the previous response shape can opt in to it for one release; see the API reference.

Handle errors

For an unsuccessful HTTP response, the client raises HuggingBayError with status, body and retry_after_seconds. Error codes and request IDs may also be available. A network or timeout failure can raise an httpx exception before an HTTP response exists.

Honor retry hints, limit total attempts and keep API errors separate from empty results. For multiple workers, share a queue, request budget and cooldown. Server extensions depend on the deployment; a package export does not prove that its backing route is enabled. In particular, SwarmClient.limits() returns HTTP 404 when the server's optional swarm features are disabled. The client preserves that error; it does not infer a budget from another endpoint.

Reference

Bay Run is a separate service with separate credentials and limits. This catalog quickstart does not call it. The hosted single-file SDK is also a separate distribution; use the PyPI package for the guide linked above.

License

MIT.

Metadata

Release files for hugging-bay 0.4.13

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

Source distribution (sdist)

Source distribution for hugging-bay 0.4.13
File Size Uploaded Provenance Actions
hugging_bay-0.4.13.tar.gz 80.7 kB Without provenance Details for hugging_bay-0.4.13.tar.gz

Built distribution (wheel)

Table of built distributions (wheels) for hugging-bay 0.4.13
File Interpreter ABI Platform Actions
hugging_bay-0.4.13-py3-none-any.whl Python 3 none any Details for hugging_bay-0.4.13-py3-none-any.whl

Total release size: 134.2 kB

Release files / hugging_bay-0.4.13.tar.gz

Download URL hugging_bay-0.4.13.tar.gz
Size 80.7 kB
Tags Source
SHA-256 checksum
How to use checksums
0e388c715229ff924fcf7fe108c83cefcee2154d74f4d6ee629cad026e1d5e68
BLAKE2b-256 checksum
How to use checksums
61b8d0f19390aca115b6d347431d57dc07fc3d1db6d942be9b2ec4c338ba38b7
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/7.0.0 CPython/3.14.3

Release files / hugging_bay-0.4.13-py3-none-any.whl

Download URL hugging_bay-0.4.13-py3-none-any.whl
Size 53.5 kB
Tags Python 3
SHA-256 checksum
How to use checksums
fcfc32661dc9cd7dc48dc5324451aa88016c1a4a25e39e581f40cf784f719d25
BLAKE2b-256 checksum
How to use checksums
b5d39b541fe4d6b1c3bb4a15946613aaacba2376f0f026f15efa9ed2efbbb96d
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/7.0.0 CPython/3.14.3

Security for hugging-bay 0.4.13

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