Metadata-Version: 2.4
Name: hugpy-core
Version: 0.4.67
Summary: Hugpy Core: a small fleet API, worker console, dispatch and consolidated history.
Author-email: putkoff <support@hugpy.ai>
License: Proprietary
Project-URL: UI, https://www.npmjs.com/package/@hugpy/ui
Project-URL: Homepage, https://hugpy.ai
Classifier: Development Status :: 3 - Alpha
Classifier: Environment :: Web Environment
Classifier: Framework :: Flask
Classifier: Intended Audience :: Developers
Classifier: Operating System :: POSIX :: Linux
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3 :: Only
Classifier: Topic :: Scientific/Engineering :: Artificial Intelligence
Requires-Python: >=3.9
Description-Content-Type: text/markdown
Requires-Dist: aiohttp>=3.9
Requires-Dist: flask>=2
Requires-Dist: hugpy-storage>=0.2.11
Requires-Dist: hugpy-wrapper>=0.1.123
Requires-Dist: psycopg[binary]>=3
Requires-Dist: abstract_toolserver>=0.0.106
Requires-Dist: abstract_database>=0.0.2.199
Requires-Dist: abstract_flask>=0.0.0.1062
Requires-Dist: abstract_utilities>=0.2.2.794
Requires-Dist: flask-sock>=0.7
Provides-Extra: test
Requires-Dist: pytest; extra == "test"
Provides-Extra: legacy
Requires-Dist: hugpy-engine>=0.3.1; extra == "legacy"
Requires-Dist: abstract_toolserver[db,server]>=0.0.95; extra == "legacy"
Requires-Dist: hugpy-media>=0.2.9; extra == "legacy"
Requires-Dist: hugpy-video>=0.2.31; extra == "legacy"
Provides-Extra: video
Requires-Dist: hugpy-video>=0.2.31; extra == "video"
Provides-Extra: media
Requires-Dist: hugpy-media>=0.2.9; extra == "media"

# Hugpy Core

Hugpy Core is the user-facing fleet coordinator. It receives telemetry from autonomous
Hugpy Wrapper hosts, projects their model inventory and call logs into a fleet database,
and routes calls to the appropriate Wrapper. Wrappers retain authority over their own
host resources, model copies, eviction decisions, and local storage.

The serving application is Flask, assembled by `abstract_flask.get_Flask_app` from
`hugpy_core.routes`. The intake service and router run alongside that application.
See [the web convention](../../WEB_CONVENTION.md), [the model database](docs/MODEL_DATABASE.md),
and [the package documentation](docs/README.md).

The former Basic aiohttp server, its static console, and its training extension are
preserved in `../archive/basic-runtime/` for historical reference. They are excluded
from the installable package. The previous README is archived there too.

The system installer is `hugpy-core install --system`; the service entry point
is `hugpy-core serve`. The Debian installer bundles the published Core wheel and
the matching `@hugpy/ui` console build for an offline installation.


<!-- hugpy-public-downloads-gallery -->
## Downloads and feature gallery

Get the Debian packages, architecture details, SHA-256 checksums and installation commands from [Hugpy Downloads](https://hugpy.ai/downloads/). The [feature gallery](https://hugpy.ai/downloads/#features) shows the console, Agent, Station, Media and Video interfaces. Screenshots reflect the versions captured; the current interface may differ.

<details>
<summary>Compute resources</summary>

Model placement, GPU process usage, memory plans and per-model controls.

![Compute resources](https://hugpy.ai/downloads/gallery/hugpy/hugpy-console.png)

</details>

<details>
<summary>Worker model plans</summary>

Compare models, context windows and allocation modes across workers.

![Worker model plans](https://hugpy.ai/downloads/gallery/hugpy/hugpy-console_1.png)

</details>

<details>
<summary>Inference metrics</summary>

Explore recorded model activity and throughput by worker.

![Inference metrics](https://hugpy.ai/downloads/gallery/hugpy/hugpy-metrics.png)

</details>

<details>
<summary>Built-in documentation</summary>

Quickstarts and guides for models, workers, clients and integrations.

![Built-in documentation](https://hugpy.ai/downloads/gallery/hugpy/hugpy-docs.png)

</details>

<details>
<summary>The Hugpy overview</summary>

The shared entry point for the console, media tools and fleet.

![The Hugpy overview](https://hugpy.ai/downloads/gallery/hugpy/hugpy-home.png)

</details>

