hugpy-server 0.2.2__tar.gz

hugpy_server-0.2.2/BUILD_CONSOLE.md

@@ -0,0 +1,61 @@
+# Building the console bundles
+
+`hugpy_server` serves the React applications as **package data**:
+`src/hugpy_server/console_dist/` is mounted by `hugpy_server.wsgi_app.mount_console`
+and resolved at runtime through `importlib.resources`, so a plain
+`pip install hugpy-server && hugpy-serve` includes the UI. The Python package
+never runs `npm`; the bundles are built from the workspace `react/` tree and
+copied in before the wheel is built.
+
+| React package (under `react/`) | Mount | Copy `dist/` to |
+|---|---|---|
+| `ui` (`@hugpy/ui`) | `/` | `console_dist/` |
+| `agents_ui` (`@hugpy/agents-ui`) | `/fleet` | `console_dist/fleet/` |
+| `media_intelligence_ui` | `/media` | `console_dist/media/` |
+| `video_intelligence_ui` | `/video` | `console_dist/video/` |
+
+`ui_shared` is a library consumed by the four builds; it has no mount.
+
+## Steps
+
+The table above lives in `console_manifest.json` (mount -> React package dir,
+npm name, pinned published version, copy target under `console_dist/`).
+`tools/build_console.py` (stdlib only) reads it. From this package directory:
+
+```bash
+python tools/build_console.py --from-source           # npm ci + npm run build in react/<pkg>, copy dist/
+python tools/build_console.py --from-npm              # npm pack <npm>@<pinned version>, copy its dist/
+python tools/build_console.py --from-source --only /fleet   # one mount; repeat --only for more
+python tools/build_console.py --check                 # which mounts are present, index.html per mount
+```
+
+* Only the selected mounts are replaced. Rebuilding `/` clears the root files
+  but never `fleet/`, `media/` or `video/`, and it does not copy the arm copies
+  that ui's `postbuild` puts in `ui/dist/<arm>/` (each arm has its own mount).
+* `--from-source` installs with `npm ci --workspaces=false` (`npm install` when a
+  package has no lockfile) because `react/` is an npm workspace root without a
+  root lockfile. `--skip-install` reuses the existing `node_modules`.
+* `--from-npm` needs a release whose tarball includes `dist/`. `"dist"` was added
+  to `files` after the currently pinned versions were published (ui 0.3.0,
+  agents-ui 0.3.0, media-intelligence-ui 0.3.0, video-intelligence-ui 0.3.2),
+  so those versions stop with a clear error. Bump the pins in the manifest
+  after the next tag-published release (`react/README.md`).
+* `--check` exits 1 when a selected mount has no `index.html`. `--console-dist`
+  and `--react-root` override the manifest paths (tests use a temp dir).
+
+Then build the wheel (`python -m build --wheel` inside `py/services/hugpy_server`).
+`pyproject.toml` lists `console_dist/**/*` as package data, so every file under
+it ships.
+
+## Runtime rules
+
+* A mount only exists when its `index.html` exists. With no `console_dist/index.html`
+  at all the server runs API-only and every non-API path is a plain 404.
+* Deep links under an arm (`/video/foo`) fall back to that arm's own
+  `index.html`; an arm that is not shipped falls back to the console root SPA.
+* `HUGPY_UI_DIST=/path/to/dist` (env or `.env`) overrides the packaged bundle
+  for development against a live webpack build.
+* The video arm's `index.html` carries the `window.__HUGPY_MEDIA_BASE__` marker;
+  the server rewrites it when `HUGPY_DEMO_MEDIA_DIR` / `HUGPY_DEMO_MEDIA_BASE`
+  is configured (`wsgi_app._video_index_response`).
+* `/studio` redirects (302) into the video arm.

hugpy_server-0.2.2/LICENSE

@@ -0,0 +1,41 @@
+hugpy — Source-Available License
+
+Copyright (c) 2026 putkoff (hugpy.ai). All rights reserved.
+
+Permission is granted, free of charge, to use this software ("hugpy") for
+personal and non-commercial purposes, and for time-limited commercial
+evaluation, subject to the following conditions:
+
+1. Non-commercial use means use by an individual for personal purposes, or
+   use by a non-profit or educational institution for its own internal
+   purposes. Any use by, for, or on behalf of a for-profit business or in
+   connection with revenue-generating activity is commercial use — including
+   internal business use, use in producing goods or services, and use on
+   paid engagements.
+
+2. Commercial use requires a commercial license from the copyright holder.
+   Exception: a business may evaluate the software internally for up to
+   thirty (30) days free of charge; continued use after that requires a
+   commercial license.
+
+3. Redistribution of this software, in source or binary form, modified or
+   unmodified, is not permitted without prior written permission from the
+   copyright holder. Downloading the software from an official distribution
+   channel (PyPI, npm, hugpy.ai) is not redistribution.
+
+4. Modification for personal use or internal evaluation is permitted;
+   distribution of modified versions is not.
+
+5. This notice must be retained in all copies or substantial portions of
+   the software.
+
+6. Any use outside these terms automatically terminates this license.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+COPYRIGHT HOLDER BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY ARISING
+FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS
+IN THE SOFTWARE.
+
+For commercial licensing or redistribution permission: https://hugpy.ai

hugpy_server-0.2.2/PKG-INFO

@@ -0,0 +1,79 @@
+Metadata-Version: 2.4
+Name: hugpy-server
+Version: 0.2.2
+Summary: Hugpy server: the Flask composition root with routes, auth, SSE, API keys and the built web console; wires fleet placement, task plugins and oracle hooks
+Author-email: putkoff <support@hugpy.ai>
+License-Expression: LicenseRef-Proprietary
+Project-URL: Homepage, https://hugpy.ai
+Project-URL: Documentation, https://github.com/hugpy/hugpy/blob/main/py/services/hugpy_server/README.md
+Project-URL: Repository, https://github.com/hugpy/hugpy
+Project-URL: Source, https://github.com/hugpy/hugpy/tree/main/py/services/hugpy_server
+Project-URL: Issues, https://github.com/hugpy/hugpy/issues
+Project-URL: Changelog, https://github.com/hugpy/hugpy/releases
+Project-URL: Architecture, https://github.com/hugpy/hugpy/blob/main/PARTITION.md
+Keywords: hugpy,llm,self-hosted,openai-compatible,flask,api-server,console
+Classifier: Development Status :: 3 - Alpha
+Classifier: Intended Audience :: Developers
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3 :: Only
+Classifier: Topic :: Scientific/Engineering :: Artificial Intelligence
+Classifier: Environment :: Web Environment
+Classifier: Framework :: Flask
+Classifier: Topic :: Internet :: WWW/HTTP :: WSGI :: Application
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: hugpy-platform
+Requires-Dist: hugpy-control
+Requires-Dist: hugpy-storage
+Requires-Dist: hugpy-engine
+Requires-Dist: hugpy-media
+Requires-Dist: hugpy-video
+Requires-Dist: hugpy-oracle
+Requires-Dist: hugpy-fleet
+Requires-Dist: hugpy-curation
+Requires-Dist: flask>=3
+Requires-Dist: werkzeug>=3
+Requires-Dist: abstract-flask
+Requires-Dist: pydantic>=2
+Requires-Dist: requests
+Requires-Dist: huggingface_hub
+Requires-Dist: gunicorn; sys_platform != "win32"
+Requires-Dist: waitress; sys_platform == "win32"
+Provides-Extra: test
+Requires-Dist: pytest>=8; extra == "test"
+Requires-Dist: pytest-timeout; extra == "test"
+Provides-Extra: discord
+Requires-Dist: hugpy-discord; extra == "discord"
+Provides-Extra: ops
+Requires-Dist: hugpy-ops; extra == "ops"
+Dynamic: license-file
+
+# hugpy-server
+
+`hugpy_server` — the Flask composition root of the Hugpy ecosystem, extracted
+from `abstract_hugpy_dev`. Ownership and allowed dependencies are declared in
+`py/partition.toml`; see `PARTITION.md` at the workspace root.
+
+* `hugpy_server.wsgi_app.create_app()` / `get_hugpy_flask()` build the app:
+  every route blueprint, the `/api` dual mounts, the operator/member/video
+  gates and the packaged React console (`console_dist/`, see
+  `BUILD_CONSOLE.md`).
+* `hugpy_server.wiring.install_all()` installs every cross-package seam listed
+  in `py/WIRING.md` (fleet placement into the engine, oracle providers, task
+  plugins, catalog bridge, oracle video hooks, curation providers, storage
+  footprint selector, HF-token listener, control bus, eviction sink). The
+  report lands at `app.extensions["hugpy_wiring"]`.
+* `hugpy-serve` (`hugpy_server.wsgi_app:main`) serves with gunicorn on POSIX,
+  waitress on Windows, and the Flask dev server as the last resort.
+* Server-owned state (API keys, video share keys, Discord bindings, install
+  links) lives under `hugpy_server.state.server_state_dir()`
+  (`HUGPY_SERVER_STATE_DIR`, else the platform's `PROJECTS_HOME`).
+
+Allowed Python dependencies inside the ecosystem: hugpy_platform, hugpy_control,
+hugpy_storage, hugpy_engine, hugpy_media, hugpy_video, hugpy_oracle, hugpy_fleet,
+hugpy_curation (optional, lazy: hugpy_discord, hugpy_ops).
+
+Tests: `cd py/services/hugpy_server && ../../.venv/bin/python -m pytest -q --timeout=120`
+(`tests/integration/` holds the multi-package tests moved from the monolith).

hugpy_server-0.2.2/README.md

@@ -0,0 +1,27 @@
+# hugpy-server
+
+`hugpy_server` — the Flask composition root of the Hugpy ecosystem, extracted
+from `abstract_hugpy_dev`. Ownership and allowed dependencies are declared in
+`py/partition.toml`; see `PARTITION.md` at the workspace root.
+
+* `hugpy_server.wsgi_app.create_app()` / `get_hugpy_flask()` build the app:
+  every route blueprint, the `/api` dual mounts, the operator/member/video
+  gates and the packaged React console (`console_dist/`, see
+  `BUILD_CONSOLE.md`).
+* `hugpy_server.wiring.install_all()` installs every cross-package seam listed
+  in `py/WIRING.md` (fleet placement into the engine, oracle providers, task
+  plugins, catalog bridge, oracle video hooks, curation providers, storage
+  footprint selector, HF-token listener, control bus, eviction sink). The
+  report lands at `app.extensions["hugpy_wiring"]`.
+* `hugpy-serve` (`hugpy_server.wsgi_app:main`) serves with gunicorn on POSIX,
+  waitress on Windows, and the Flask dev server as the last resort.
+* Server-owned state (API keys, video share keys, Discord bindings, install
+  links) lives under `hugpy_server.state.server_state_dir()`
+  (`HUGPY_SERVER_STATE_DIR`, else the platform's `PROJECTS_HOME`).
+
+Allowed Python dependencies inside the ecosystem: hugpy_platform, hugpy_control,
+hugpy_storage, hugpy_engine, hugpy_media, hugpy_video, hugpy_oracle, hugpy_fleet,
+hugpy_curation (optional, lazy: hugpy_discord, hugpy_ops).
+
+Tests: `cd py/services/hugpy_server && ../../.venv/bin/python -m pytest -q --timeout=120`
+(`tests/integration/` holds the multi-package tests moved from the monolith).

hugpy_server-0.2.2/console_manifest.json

@@ -0,0 +1,30 @@
+{
+  "react_root": "../../../react",
+  "console_dist": "src/hugpy_server/console_dist",
+  "mounts": {
+    "/": {
+      "package_dir": "ui",
+      "npm": "@hugpy/ui",
+      "version": "0.3.0",
+      "target": ""
+    },
+    "/fleet": {
+      "package_dir": "agents_ui",
+      "npm": "@hugpy/agents-ui",
+      "version": "0.3.0",
+      "target": "fleet"
+    },
+    "/media": {
+      "package_dir": "media_intelligence_ui",
+      "npm": "@hugpy/media-intelligence-ui",
+      "version": "0.3.0",
+      "target": "media"
+    },
+    "/video": {
+      "package_dir": "video_intelligence_ui",
+      "npm": "@hugpy/video-intelligence-ui",
+      "version": "0.3.2",
+      "target": "video"
+    }
+  }
+}