Metadata-Version: 2.4
Name: hugpy-core
Version: 0.4.78
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.11
Description-Content-Type: text/markdown
Requires-Dist: hugpy-settings>=0.1.3
Requires-Dist: aiohttp>=3.9
Requires-Dist: flask>=2
Requires-Dist: hugpy-storage>=0.2.17
Requires-Dist: hugpy-wrapper>=0.1.175
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.1071
Requires-Dist: abstract_utilities>=0.2.2.794
Requires-Dist: flask-sock>=0.7
Provides-Extra: terminal
Requires-Dist: hugpy-fleet>=0.2.11; extra == "terminal"
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.3.8; extra == "legacy"
Requires-Dist: hugpy-video>=0.3.9; extra == "legacy"
Provides-Extra: video
Requires-Dist: hugpy-video>=0.3.9; extra == "video"
Provides-Extra: media
Requires-Dist: hugpy-media>=0.3.8; extra == "media"

# Hugpy Core

Core is the Flask console, API and fleet coordinator. It registers Wrapper hosts,
mirrors their inventory and execution evidence into PostgreSQL, and routes work.
Wrapper owns execution, loading, memory admission, worker settings and local model
copies. Core uses Wrapper's reported feasibility; it does not run a second sizing
solver. See [model data ownership](docs/MODEL_DATA_OWNERSHIP.md).

This source is staged **0.4.75**. Source, prepared artifacts, registry releases and
running services are separate states. No deployment is implied by this README.

## Start and install

With the package and its dependencies installed and a prepared Core PostgreSQL
DSN in `HUGPY_CORE_DB`, the HTTP entry point is:

```sh
hugpy-core serve --host 127.0.0.1 --port 7020
```

Startup checks migrations and initializes Core services; use an isolated database
for development. `serve` uses the threaded Werkzeug server. A bare `hugpy-core`
uses the older Flask startup sequence with additional startup jobs.

The Debian package supplies an offline wheelhouse and invokes
`hugpy-core install --system` to provision PostgreSQL, migrate Core and install
Core/intake systemd units. This is a mutating installation action. Inspect the
[bundle README](../README.md) and [installer contract](../INSTALLER_PARITY.md)
for build prerequisites, DSN precedence and upgrade behavior. Installer verbs
without `--system` use a distinct per-user path.

Core currently depends on Wrapper, Storage, Abstract Toolserver and the shared
Flask/database/utilities libraries as well as Flask, aiohttp, psycopg and
Flask-Sock. Exact floors and optional extras are in [pyproject.toml](pyproject.toml).
Media and Video are optional: their distributions own their APIs and UI assets.
Toolserver provisions databases; Core queries PostgreSQL directly.

## API, UI and operations

- [Operator guide](docs/OPERATOR-GUIDE.md): configuration, intake, optional apps,
  Identity readiness and verification boundaries.
- [Documentation index](docs/README.md): current contracts and historical designs.
- [Route convention](docs/ROUTES-CONVENTION.md): category catalogs, explicit addon
  blueprints and UI middleware. `/routes` is not an exhaustive endpoint inventory.
- [Console source and component API](../ui/README.md): app and library builds.
- [Intake deployment](../installers/deploy/INTAKE.md): independent collection and
  bounded model-fact exchange between registered workers.

The retired Basic aiohttp server, console and training extension are preserved
in [archive/basic-runtime](../archive/basic-runtime/), outside the installable
package. The active Flask application uses native Core readers; the compatibility
flag and Basic CLI dispatch were removed. Existing databases are not migrated or
deleted merely by this source change.

<!-- 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>



## Fleet terminal compatibility release — 2026-10-22

Supports per-request `alloc.workers` selection in native chat, OpenAI chat and task routes. Selection is enforced before resident, allocation and wildcard ranking. The optional terminal extra selects the updated Fleet arm. The published UI bundle is retained.
