Metadata-Version: 2.4
Name: hugpy
Version: 0.3.0
Summary: The complete Hugpy Python suite with lazy component imports
Author-email: Hugpy <support@hugpy.ai>
License-Expression: LicenseRef-Proprietary
Project-URL: Homepage, https://hugpy.ai
Project-URL: Repository, https://github.com/hugpy/hugpy
Project-URL: Source, https://github.com/hugpy/hugpy/tree/main/staging/hugpy/package
Requires-Python: >=3.11
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: hugpy-settings>=0.1.6
Requires-Dist: hugpy-platform>=0.3.2
Requires-Dist: hugpy-tools>=0.2.22
Requires-Dist: abstract-toolserver>=0.0.111
Requires-Dist: hugpy-storage>=0.2.18
Requires-Dist: hugpy-engine>=0.3.14
Requires-Dist: hugpy-wrapper>=0.1.181
Requires-Dist: hugpy-core>=0.4.80
Requires-Dist: hugpy-terminal>=0.1.22
Requires-Dist: hugpy-harness>=0.1.25
Requires-Dist: hugpy-fleet>=0.2.13
Requires-Dist: hugpy-agent>=0.1.135
Requires-Dist: hugpy-media>=0.3.10
Requires-Dist: hugpy-oracle<0.4,>=0.3.19
Requires-Dist: hugpy-video>=0.3.19
Provides-Extra: worker
Provides-Extra: media
Provides-Extra: video
Provides-Extra: agent
Provides-Extra: providers
Requires-Dist: abstract-serve-core>=0.1.34; extra == "providers"
Requires-Dist: abstract-claude>=0.1.110; extra == "providers"
Requires-Dist: abstract-gpt>=0.1.27; extra == "providers"
Provides-Extra: claude
Requires-Dist: abstract-serve-core>=0.1.34; extra == "claude"
Requires-Dist: abstract-claude>=0.1.110; extra == "claude"
Provides-Extra: gpt
Requires-Dist: abstract-serve-core>=0.1.34; extra == "gpt"
Requires-Dist: abstract-gpt>=0.1.27; extra == "gpt"
Provides-Extra: identity
Requires-Dist: abstract-identity>=0.1.0; extra == "identity"
Provides-Extra: all
Requires-Dist: abstract-serve-core>=0.1.34; extra == "all"
Requires-Dist: abstract-claude>=0.1.110; extra == "all"
Requires-Dist: abstract-gpt>=0.1.27; extra == "all"
Requires-Dist: abstract-identity>=0.1.0; extra == "all"
Dynamic: license-file

# Hugpy

The complete Hugpy Python suite in one install. `hugpy` declares the component
dependencies and exposes their Python modules through lazy imports. Components
keep their own implementations, releases, and canonical import paths.

## Install

Python 3.11 or newer is required. After publication:

```bash
python -m pip install hugpy
python -m pip install 'hugpy[providers]'  # shared Serve, Claude, and GPT
python -m pip install 'hugpy[identity]'   # Identity
python -m pip install 'hugpy[all]'        # suite, providers, and Identity
```

The staged version is `0.3.0rc1`. To select this candidate explicitly after it
is published, use `python -m pip install 'hugpy==0.3.0rc1'` (with extras if
needed). A normal install selects stable releases by default.

The default install includes every Hugpy Python component listed below and the
shared Toolserver package. Claude, GPT, Serve, and Identity are optional.
The earlier candidate's `worker`, `media`, `video`, and `agent` extras remain
accepted; those components are now included by default.

Backend extras remain on their owning packages, for example
`hugpy-media[audio]`, `hugpy-wrapper[transformers]`, or
`abstract-identity[render]`. The umbrella does not request every backend extra
or bundle model weights. Station and the native Llama server are installed
separately through their own distribution channels.

## Imports

```python
import hugpy
from hugpy import core, engine, wrapper, harness, fleet
from hugpy import media, video, oracle, storage, agent
from hugpy import settings, platform, tools, toolserver, terminal

# Convenience exports from hugpy_engine:
from hugpy import execute_prompt, execute_prompt_stream, execute_chat_stream

# With the matching optional extras installed:
from hugpy import serve, claude, gpt, identity
```

`import hugpy` loads no component. Accessing an alias imports and caches that
component's actual module; for example, `hugpy.wrapper` is `fitevict` and
`hugpy.media` is `hugpy_media`. Component initialization happens when that
component is requested. Optional components are listed by `dir(hugpy)` but
excluded from star imports.

| Alias | Canonical Python module | Distribution | Install |
| --- | --- | --- | --- |
| `settings` | `hugpy_settings` | `hugpy-settings` | Default |
| `platform` | `hugpy_platform` | `hugpy-platform` | Default |
| `tools` | `hugpy_tools` | `hugpy-tools` | Default |
| `toolserver` | `abstract_toolserver` | `abstract-toolserver` | Default |
| `storage` | `hugpy_storage` | `hugpy-storage` | Default |
| `engine` | `hugpy_engine` | `hugpy-engine` | Default |
| `wrapper` | `fitevict` | `hugpy-wrapper` | Default |
| `core` | `hugpy_core` | `hugpy-core` | Default |
| `terminal` | `hugpy_terminal` | `hugpy-terminal` | Default |
| `harness` | `hugpy_harness` | `hugpy-harness` | Default |
| `fleet` | `hugpy_fleet` | `hugpy-fleet` | Default |
| `agent` | `hugpy_agent` | `hugpy-agent` | Default |
| `media` | `hugpy_media` | `hugpy-media` | Default |
| `oracle` | `hugpy_oracle` | `hugpy-oracle` | Default |
| `video` | `hugpy_video` | `hugpy-video` | Default |
| `serve` | `abstract_serve_core` | `abstract-serve-core` | `hugpy[providers]` |
| `claude` | `abstract_claude` | `abstract-claude` | `hugpy[claude]` or `hugpy[providers]` |
| `gpt` | `abstract_gpt` | `abstract-gpt` | `hugpy[gpt]` or `hugpy[providers]` |
| `identity` | `abstract_identity` | `abstract-identity` | `hugpy[identity]` |

For submodules, use canonical paths, for example `import hugpy_media.extract`.
The aliases support attribute access and `from hugpy import ...`; they do not
create a second submodule tree under `hugpy`. The three inference functions
above are forwarded unchanged from `hugpy_engine`.

This package installs no `hugpy` or `hpy` command. Each component owns its own
command line and runtime configuration.

## Release preparation

Build the source distribution and wheel from this directory:

```bash
python -m build
```

Dependency minimums describe the intended component release set. Publish the
components before the umbrella, then resolve and install the built wheel in a
clean Python 3.11+ environment. The minimum versions match the staged component
metadata at preparation time; update them if the component releases change the
required baseline. Public dependency resolution and runtime installation remain
release checks once those component uploads are available.

The wheel and source distribution contain the umbrella source, metadata, and
license. Building this candidate does not publish it or install the suite.
